التابع Enumerable.one?‎ في روبي

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

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

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

المعاملات

pattern

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

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

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

أمثلة

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

%w{ant bear cat}.one? { |word| word.length == 4 }  #=> true
%w{ant bear cat}.one? { |word| word.length > 4 }   #=> false
%w{ant bear cat}.one? { |word| word.length < 4 }   #=> false
%w{ant bear cat}.one?(/t/)                         #=> false
[ nil, true, 99 ].one?                             #=> false
[ nil, true, false ].one?                          #=> true
[ nil, true, 99 ].one?(Integer)                    #=> true
[].one?                                            #=> false

انظر أيضًا

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

مصادر

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