«لیست کلیدواژه» لیستی از تاپلهای {key, value} است. دو روش برای نوشتن یک لیست کلیدواژه وجود دارد:
# concise
[month: "April", year: 2018]
# explicit
[{:month, "April"}, {:year, 2018}]
هر لیستی از تاپلهای دوتایی، لیست کلیدواژه نیست. کلیدها باید اتم باشند:
Keyword.keyword?([{"month", "April"}])
# => false
اگر میخواهید در کلید از نویسههایی غیر از حروف، اعداد و _ استفاده کنید، باید آن را داخل کوتیشن بگذارید. اما این کار آن را به رشته تبدیل نمیکند؛ همچنان یک اتم است.
Keyword.keyword?(["day of week": "Monday"])
# => true
کلیدها در یک لیست کلیدواژه میتوانند تکرار شوند و جفتهای کلید-مقدار مرتب هستند. وقتی بخواهید یک مقدار مشخص را از یک کلید به دست آورید، اولین مقدار را دریافت میکنید و سایر مقادیر زیر همان کلید بیسروصدا نادیده گرفته میشوند.
list = [month: "April", month: "May"]
Keyword.get_values(list, :month)
# => ["April", "May"]
Keyword.get(list, :month)
# => "April"
لیستهای کلیدواژه همچنین از رفتار Access پشتیبانی میکنند.
list[:month]
# => "April"
ویژگیهای لیستهای کلیدواژه، آنها را به مکانیزم پیشفرض برای ارسال گزینهها به توابع در Elixir تبدیل کرد.
وقتی دربارهی if یاد میگرفتید، یک نحوهی نگارش کوتاهتر و خاص دیدید:
if age >= 16, do: "beer", else: "no beer"
ممکن است به نظر برسد که if دو آرگومان میپذیرد، اما جفت do: و else: در واقع یک آرگومان واحد است: یک لیست کلیدواژه. همین کد را میتوان اینگونه نوشت:
if age >= 16, [do: "beer", else: "no beer"]
# or
if age >= 16, [{:do, "beer"}, {:else, "no beer"}]
استفاده از لیستهای کلیدواژه به عنوان گزینههای تابع آنقدر رایج است که Elixir به شما اجازه میدهد وقتی لیست کلیدواژه آخرین آرگومان ارسالی به تابع است، براکتهای مربعی را حذف کنید.
از آنجا که تاپلها، لیستها، مپها و موارد دیگر در نحوهی نگارش Elixir مانند فراخوانی تابع رفتار میشوند، این ویژگی برای آنها هم در دسترس است.
[1, 2, three: 3]
# => [1, 2, {:three, 3}]
برای اینکه با استفاده از نحوهی نگارش مختصر، تطبیق الگو را روی یک لیست کلیدواژه با موفقیت انجام دهید، باید همهی کلیدها را به ترتیب درست مشخص کنید. همین باعث میشود تطبیق الگو انتخاب بعیدی برای کار با لیستهای کلیدواژه باشد. در عوض از ماژول Keyword یا رفتار 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]
| لیست کلیدواژه | مپ | |
|---|---|---|
| نوع کلید | اتم | هر نوعی، میتوانند در یک مپ ترکیب شوند |
| کلیدهای تکراری | بله | خیر |
| ترتیب کلیدها | بله | خیر |
| دسترسی |
list[:key], Keyword.get/2
|
map.key, map[:key], Map.get/2
|
| زمان دسترسی | خطی | لگاریتمی |
| تطبیق الگو | چندان مفید نیست | مفید |
زمان دسترسی سریعتر، نوع کلید انعطافپذیر و تطبیق الگوی مفید، مپها را در بیشتر موارد به انتخاب پیشفرض تبدیل میکند.
وقتی دادهی زیادی ندارید اما به کلیدهای تکراری یا کلیدهایی با ترتیب مشخص نیاز دارید، از لیستهای کلیدواژه استفاده کنید.