مرجع نگاشت‌ها (map)

11 تابع و 0 مقدارِ map: امضا، اثر، مرحله، هزینه و مثال‌های آزموده.

نگاشت (map) مقدارها را زیر کلیدها نگه می‌دارد. بسیاری از تابع‌های اینجا به شکل متد نوشته می‌شوند: m.set(k, v) همان map.set(m, k, v) است.

توابع#

map.at([map], [key])

مقدارِ زیر یک کلید.

map.clear([map])

همهٔ مدخل‌ها را برمی‌دارد.

map.contains([map], [key])

وقتی کلید در نگاشت باشد، درست است.

map.copy([map])

یک کپی از نگاشت.

اثر: مقدار تازه‌ای می‌سازد که اندازه‌اش از آرگومان‌ها پیروی می‌کند (در دفتر حافظه شمرده می‌شود).
مرحله: هر کندل.
هزینه: حافظه می‌گیرد: دفتر حافظه آنچه را می‌سازد می‌شمارد.

map.keys([map])

کلیدها یا مقدارها به شکل یک آرایه.

اثر: مقدار تازه‌ای می‌سازد که اندازه‌اش از آرگومان‌ها پیروی می‌کند (در دفتر حافظه شمرده می‌شود).
مرحله: هر کندل.
هزینه: حافظه می‌گیرد: دفتر حافظه آنچه را می‌سازد می‌شمارد.
مثال‌ها: حجم بر اساس روز هفته.

map.new()

یک نگاشت خالی می‌سازد.

اثر: مقدار تازه‌ای می‌سازد که اندازه‌اش از آرگومان‌ها پیروی می‌کند (در دفتر حافظه شمرده می‌شود).
مرحله: هر کندل.
هزینه: حافظه می‌گیرد: دفتر حافظه آنچه را می‌سازد می‌شمارد.

map.remove([map], [key])

کلید را برمی‌دارد.

map.set([map], [key], [value])

مقدار زیر یک کلید را تعیین می‌کند.

اثر: یک مجموعه را در جای خودش تغییر می‌دهد؛ مقدار تازه‌ای می‌سازد که اندازه‌اش از آرگومان‌ها پیروی می‌کند (در دفتر حافظه شمرده می‌شود).
مرحله: هر کندل.
هزینه: حافظه می‌گیرد: دفتر حافظه آنچه را می‌سازد می‌شمارد.
مثال‌ها: حجم بر اساس روز هفته.

map.set_all([map], [other])

همهٔ مدخل‌های یک نگاشت دیگر را در این نگاشت کپی می‌کند.

اثر: یک مجموعه را در جای خودش تغییر می‌دهد؛ مقدار تازه‌ای می‌سازد که اندازه‌اش از آرگومان‌ها پیروی می‌کند (در دفتر حافظه شمرده می‌شود).
مرحله: هر کندل.
هزینه: حافظه می‌گیرد: دفتر حافظه آنچه را می‌سازد می‌شمارد.

map.size([map])

تعداد مدخل‌ها.

map.values([map])

کلیدها یا مقدارها به شکل یک آرایه.

اثر: مقدار تازه‌ای می‌سازد که اندازه‌اش از آرگومان‌ها پیروی می‌کند (در دفتر حافظه شمرده می‌شود).
مرحله: هر کندل.
هزینه: حافظه می‌گیرد: دفتر حافظه آنچه را می‌سازد می‌شمارد.