الواجهة: خريطة

القواعد.خريطة

واجهة   ثابتة

نوع الخريطة، يُستخدم في تعيينات القيم الأساسية البسيطة.

يجب أن تكون المفاتيح من النوع rules.String.

بالإضافة إلى الطرق المذكورة أدناه، يكون للخرائط العوامل التالية:

---

المؤثِّر	الاستخدام
x == y	المقارنة بين الخريطتين x وy
x[k]	عامل الفهرس، احصل على القيمة باسم المفتاح k
x.k	الحصول على قيمة المفتاح k
k in x	التحقق من وجود المفتاح k في الخريطة x

الطُرق

الفرق

تعرض دالة diff(map_to_Comparison) قواعد.MapDiff

عرض rules.MapDiff تمثل نتيجة مقارنة الخريطة الحالية إلى خريطة مقارنة.

المعلمة
الخريطة_للمقارنة	rules.Map خريطة يمكن من خلالها وضع الخريطة الحالية ستتم مقارنتها. يجب ألا تكون القيمة فارغة.

المرتجعات

عنصر non-null rules.MapDiff يمثّل نتيجة المقارنة.

الحصول على

تعرض get(key, default_value) قيمة

تعرض القيمة المرتبطة بسلسلة مفاتيح بحث معيّنة.

بالنسبة إلى "خرائط Google" المدمجة، التي تتضمن المفاتيح والمفاتيح الفرعية، يتم عرض القيمة المرتبطة بسلسلة مفتاح فرعي محددة. يتم تحديد المفتاح الفرعي باستخدام حيث يكون العنصر الأول هو مفتاح المستوى الأعلى والعنصر الأخير المفتاح الفرعي الذي سيتم البحث عن قيمته وإرجاعه. مشاهدة الخريطة المتداخلة المثال أدناه.

تتطلب الدالة قيمة افتراضية لعرضها إذا لم تكن هناك مطابقة مع يتم العثور على مفتاح البحث المحدد.

المعلمة
مفتاح	(rules.String غير خالية أو rules.List غير فارغة) تم تحديد إما مفتاح كسلسلة، أو مفتاح فرعي للخرائط المتداخلة يتم تحديده باستخدام بنية القائمة.
القيمة_التلقائية	القيمة_التلقائية القيمة المطلوب عرضها إذا كانت الخريطة لا يحتوي على مفتاح البحث المحدد. يمكن أن يكون أي نوع من أنواع لغات "القواعد".

المرتجعات

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

key() إلى عرض rules.List

اطّلِع على قائمة المفاتيح في الخريطة.

المرتجعات

non-null rules.List قائمة المفاتيح.

الحجم

(size()) تعرض rules.Integer

الحصول على عدد الإدخالات في الخريطة.

المرتجعات

عدد الإدخالات: non-null rules.Integer.

values

value() تعرض rules.List

الحصول على قائمة القيم في الخريطة.

المرتجعات

non-null rules.List قائمة القيم.