Uma lista de palavras-chave é uma lista de tuplas {key, value}. Há duas formas de escrever uma lista de palavras-chave:
# concise
[month: "April", year: 2018]
# explicit
[{:month, "April"}, {:year, 2018}]
Nem todas as listas de tuplas de 2 elementos são listas de palavras-chave. As chaves têm de ser átomos:
Keyword.keyword?([{"month", "April"}])
# => false
Se quiseres usar na chave caracteres que não sejam letras, números e _, tens de a colocar entre aspas. No entanto, isso não a transforma numa string: continua a ser um átomo.
Keyword.keyword?(["day of week": "Monday"])
# => true
As chaves de uma lista de palavras-chave podem repetir-se, e os pares chave-valor estão ordenados. Quando tentas obter um único valor associado a uma determinada chave, obténs o primeiro valor, e quaisquer outros valores com a mesma chave são ignorados silenciosamente.
list = [month: "April", month: "May"]
Keyword.get_values(list, :month)
# => ["April", "May"]
Keyword.get(list, :month)
# => "April"
As listas de palavras-chave também suportam o comportamento Access.
list[:month]
# => "April"
As características das listas de palavras-chave fizeram delas o mecanismo predefinido para passar opções a funções em Elixir.
Quando aprendeste o if, viste uma sintaxe especial mais curta:
if age >= 16, do: "beer", else: "no beer"
Isto pode parecer que o if aceita dois argumentos, mas o par do: e else: é, na verdade, um único argumento: uma lista de palavras-chave. O mesmo código poderia ser escrito assim:
if age >= 16, [do: "beer", else: "no beer"]
# or
if age >= 16, [{:do, "beer"}, {:else, "no beer"}]
O uso de listas de palavras-chave como opções de funções é tão comum que o Elixir te permite omitir os parênteses retos quando a lista de palavras-chave é o último argumento passado a uma função.
Como as tuplas, as listas, os mapas e outros são tratados da mesma forma que as chamadas de funções na sintaxe do Elixir, esta propriedade também está disponível para eles.
[1, 2, three: 3]
# => [1, 2, {:three, 3}]
Para fazer correspondência de padrões com êxito numa lista de palavras-chave usando a sintaxe concisa, terias de especificar todas as chaves pela ordem correta. Isso torna a correspondência de padrões uma escolha pouco provável para trabalhar com listas de palavras-chave. Usa antes o módulo Keyword ou o comportamento Access.
[month: month] = [month: "April", year: 2018]
# => ** (MatchError) no match of right hand side value: [month: "April", year: 2018]
[year: year, month: month] = [month: "April", year: 2018]
# => ** (MatchError) no match of right hand side value: [month: "April", year: 2018]
| Keyword list | Map | |
|---|---|---|
| Key type | Atoms | Any, can be mixed in one map |
| Duplicate keys | Yes | No |
| Keys ordered | Yes | No |
| Access |
list[:key], Keyword.get/2
|
map.key, map[:key], Map.get/2
|
| Access time | Linear | Logarithmic |
| Pattern matching | Not very useful | Useful |
Um tempo de acesso mais rápido, um tipo de chave flexível e uma correspondência de padrões útil fazem dos mapas a escolha predefinida na maioria dos casos.
Usa listas de palavras-chave quando não tens muitos dados, mas precisas de chaves duplicadas ou de chaves numa ordem específica.