כללים . מַפָּה
סוג מפה, משמש למיפויי מפתח-ערך פשוטים.
המפתחות חייבים להיות מסוג rules.String
.
בנוסף לשיטות המפורטות להלן, למפות יש את האופרטורים הבאים:
מַפעִיל | נוֹהָג |
---|---|
x == y | השוו בין מפות x ו-y |
x[k] | מפעיל אינדקס, קבל ערך בשם המפתח k |
xk | קבל ערך בשם המפתח k |
k in x | בדוק אם מפתח k קיים במפה x |
שיטות
הבדל
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
רשימת ערכים.