Ruby/Enumerable/none-3F

يتحقق التابع none?‎ من خلو كائن قابل للتعداد من أي عنصر محقِّق للكتلة المعطاة (لا تعيد مع أي عنصر القيمة true) أو مطابق للنمط محدَّد.

البنية العامة

none? [{ |obj| block }] → true or false
none?(pattern) → true or false

المعاملات

pattern

نمط يراد التحقق من عدم مطابقته لأي عنصر من عناصر الكائن القابل للتعداد المعطى.

القيمة المعادة

تعاد القيمة true إن لم تعيد الكتلة block القيمة true لجميع عناصر الكائن القابل للتعداد بعد تمرير كل واحد منها إليها، أو لم يتطابق أي عنصر من تلك العناصر مع النمط pattern (إن أعطي)، أو لم تكن قيمة أي عنصر من تلك العناصر مساوية للقيمة true إن لم تعطَ أية كتلة ولم يمرَّر النمط pattern. خلا ذلك، تعاد القيمة false.

أمثلة

مثال على استعمال التابع none?‎:

%w{ant bear cat}.none? { |word| word.length == 5 } #=> true
%w{ant bear cat}.none? { |word| word.length >= 4 } #=> false
%w{ant bear cat}.none?(/d/)                        #=> true
[1, 3.14, 42].none?(Float)                         #=> false
[].none?                                           #=> true
[nil].none?                                        #=> true
[nil, false].none?                                 #=> true
[nil, false, true].none?                           #=> false

انظر أيضًا

• التابع include?‎: يتحقق من احتواء كائن قابل للتعداد على عنصر محدَّد.
• التابع member?‎: يتحقق من احتواء كائن قابل للتعداد على عنصر محدَّد (مرة واحدة أو أكثر).
• التابع one?‎: يتحقق من احتواء كائن قابل للتعداد على عنصر واحد فقط محقِّق للكتلة المعطاة (لا تعيد مع أي عنصر القيمة true باستثناء عنصر واحد فقط) أو مطابق للنمط محدَّد.

مصادر

• قسم التابع none?‎ في الصنف Enumerable في توثيق روبي الرسمي.