الواجهة: القائمة

القواعد.قائمة

واجهة   ثابتة

نوع القائمة. العناصر ليست بالضرورة متجانسة.

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

---

المؤثِّر	الاستخدام
x == y	المقارنة بين القائمتين "س" و"ص"
x[i]	عامل الفهرس، الحصول على فهرس القيمة i
x[i:j]	عامل نطاق، احصل على القائمة الفرعية من الفهرس i إلى j
v in x	تحقق من وجود القيمة v في القائمة x. 'a' in ['a','b'] == true

الطُرق

concat

تعرض الدالة concat(list) rules.List.

يمكنك إنشاء قائمة جديدة بإضافة عناصر قائمة أخرى إلى نهاية هذه القائمة.

المعلمة
القائمة	rules.List للتسلسلات. يجب ألا تكون القيمة فارغة.

المرتجعات

non-null rules.List القائمة التي تمت إضافة جميع عناصر القائمة الأخرى إليها.

لهاالكل

يعرض hasAll(list) rules.Boolean.

حدِّد ما إذا كانت القائمة تحتوي على جميع العناصر في قائمة أخرى أم لا.

المعلمة
القائمة	rules.List تمثّل هذه السمة قائمة العناصر التي يجب البحث عنها. يجب ألا تكون القيمة فارغة.

المرتجعات

non-null rules.Boolean صحيح إذا كانت هذه القائمة تحتوي على جميع العناصر في آخر.

يحتوي على أي منها

يحتوي hasAny(list) على rules.Boolean.

حدِّد ما إذا كانت القائمة تحتوي على أي عنصر في قائمة أخرى.

المعلمة
القائمة	rules.List تمثّل هذه السمة قائمة العناصر التي يجب البحث عنها. يجب ألا تكون القيمة فارغة.

المرتجعات

non-null rules.Boolean صحيح إذا كانت هذه القائمة تحتوي على أي عنصر في آخر.

لها فقط

hasOnly(list) لعرض rules.Boolean.

حدِّد ما إذا كانت جميع العناصر في القائمة متوفّرة في قائمة أخرى.

المعلمة
القائمة	rules.List تمثّل هذه السمة قائمة العناصر التي يجب البحث عنها. يجب ألا تكون القيمة فارغة.

المرتجعات

non-null rules.Boolean صحيح في حال توفّر جميع العناصر في القائمة في قائمة أخرى، مع استبعاد العناصر المتكررة.

مثال

['a', 'b'].hasOnly(['a', 'c']) == false
['a', 'b'].hasOnly(['a', 'b', 'c']) == true
['a', 'b'].hasOnly(['b', 'a']) == true
['a', 'a', 'b'].hasOnly(['a', 'b', 'b']) == true
['a', 'a', 'b'].hasOnly(['a', 'b', 'b', 'c']) == true

join

join(separator) يعرض rules.String

دمج العناصر في القائمة في سلسلة مع فاصل

المعلمة
فاصل	rules.String سلسلة لفصل العناصر. يجب ألا تكون القيمة فارغة.

المرتجعات

non-null rules.String تم ضم القائمة كسلسلة.

إزالة الكل

يعرض removeAll(list) rules.List

يمكنك إنشاء قائمة جديدة من خلال إزالة عناصر قائمة أخرى من هذه القائمة.

المعلمة
القائمة	rules.List قائمة بالعناصر المطلوب إزالتها.. يجب ألا تكون القيمة فارغة.

المرتجعات

non-null rules.List القائمة مع إزالة جميع عناصر القائمة الأخرى.

الحجم

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

احصل على عدد القيم في القائمة.

المرتجعات

non-null rules.Integer عدد القيم في القائمة.

ضبط

يؤدي toSet() إلى إرجاع rules.Set

لعرض مجموعة تحتوي على جميع العناصر الفريدة في القائمة.

في حالة تساوى عنصرين أو أكثر ولكنهما غير متطابقين، فإن مجموعة النتائج سيحتوي فقط على العنصر الأول في القائمة. العناصر المتبقية هي تم تجاهله.

المرتجعات

مجموعة non-null rules.Set التي تحتوي على قيم فريدة في القائمة المحدّدة.