Removes the entry with a given key from a container (a map, keyword list, or struct that implements the Access behaviour).
Returns a tuple containing the value associated with the key and the updated container. nil is returned for the value if the key isn’t in the container.
In this case, there are multiple values with the same key. Am I wrong in expecting the Access.pop/2 function to return a list of values ([1, 2]) with the key :a?
Or am I missing something obvious? Can someone explain this behavior?
[a: 1, a: 2] is a keyword list and most functions working on keyword lists assume them to have unique keys. The introduction in the documentation for the module Keyword has this to say about duplicate keys:
For example, Keyword.get/3 will get the first entry matching the given key, regardless if duplicated entries exist. Similarly, Keyword.put/3 and Keyword.delete/3 ensure all duplicated entries for a given key are removed when invoked.
A handful of functions exist to handle duplicated keys, in particular, Enum.into/2 allows creating new keywords without removing duplicated keys, get_values/2 returns all values for a given key and delete_first/2 deletes just one of the existing entries.
If you want a function that works specifically with the scenario of a keyword list with duplicated keys then should look at Keyword.pop_first/3. When you use it it looks like this: