ממשק: מפה

שיטות

הבדל

diff(map_to_compare) מחזיר חוקים.MapDiff

החזרת rule.MapDiff המייצגת את התוצאה של השוואת המפה הנוכחית למפת השוואה.

פָּרָמֶטֶר

מפה_להשוואה

כללים.מפה

מפה שאליה תושווה המפה הנוכחית (המתקשרת).

הערך לא יכול להיות ריק.

החזרות

אובייקט non-null rules.MapDiff המייצג את תוצאת ההשוואה.

לקבל

get(key, default_value) מחזירה ערך

מחזירה את הערך המשויך למחרוזת מפתח חיפוש נתונה.

עבור מפות מקוננות, הכוללות מפתחות ומפתחות משנה , מחזירה את הערך המשויך למחרוזת מפתח משנה נתונה. מפתח המשנה מזוהה באמצעות רשימה, שהפריט הראשון שלה הוא מפתח ברמה העליונה והפריט האחרון מפתח המשנה שאת ערכו יש לחפש ולהחזיר. עיין בדוגמה של המפה המקוננת למטה.

הפונקציה דורשת ערך ברירת מחדל כדי לחזור אם לא נמצאה התאמה למפתח החיפוש הנתון.

פָּרָמֶטֶר

מַפְתֵחַ

( כללים שאינם אפסים. מחרוזת או כללים שאינם אפסים. רשימה )

מפתח שצוין כמחרוזת, או עבור מפות מקוננות, מפתח משנה שצוין באמצעות תחביר רשימה.

ערך ברירת מחדל

ערך ברירת מחדל

ערך להחזרה אם המפה אינה מכילה את מפתח החיפוש הנתון. יכול להיות כל סוג שפת כללים.

החזרות

value ערך המתאים למפתח key , או ערך ההחזרה המוגדר כברירת מחדל שצוין על ידי default_value אם לא נמצאה התאמה למפתח הנתון. מכיוון שתוכן המפה מוגדר על ידי המשתמש, סוג הנתונים של value המוחזר יכול להיות כל סוג של שפת כללים.

דוגמא

// "c" is not a key in the supplied Map, returns default value 7.
{"a": 3,"b": 2}.get("c", 7) == 7

// Default result can be any type, e.g. a list such as [1, 1].
{"a": [2, 7], "b": [9, 12]}.get("c", [1, 1]) == [1, 1]

// Return a list on a successful match.
{"a": [2, 7],"b": [9, 12]}.get("b", [1, 1]) == [9, 12]

// For nested Maps, use list ["a", "b"] to specify lookup on sub-key "b".
{"a": {"b": 1},"c": 2}.get(["a", "b"], 7) == 1

מפתחות

keys() מחזירה rules.List

קבל את רשימת המפתחות במפה.

החזרות

non-null rules.List רשימת מפתחות.

גודל

size() מחזיר כללים

קבל את מספר הערכים במפה.

החזרות

non-null rules.Integer של ערכים.

ערכים

values() מחזירה rules.List

קבלו את רשימת הערכים במפה.

החזרות

non-null rules.List רשימת ערכים.