الفرق بين المراجعتين لصفحة: «Ruby/Array/any»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>Array.any?</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method تصنيف: Ruby Arr...' |
لا ملخص تعديل |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby Array]] | [[تصنيف: Ruby Array]] | ||
يتحقق التابع <code>any</code> | يتحقق التابع <code>any?</code> إذا كان كل عنصر من عناصر المصفوفة المعطاة مححقًا لشرط منطقي محدد أو كانت قيمة كل عنصر لا تساوي القيمة <code>false</code> (أي لا يعيد أي عنصر القيمة <code>false</code> أو <code>nil</code> عند التحقق من مطابقته للشرط). إن لم تمرَّر أية كتلة برمجية تمثل الشرط، فستضيف <code>Ruby</code> الكتلة { |<code>obj</code>| <code>obj</code>} ضمنيًا، وسيعيد حينئذٍ التابع <code>any?</code> القيمة <code>true</code> إن لم يتساوى أي عنصر من عناصر المصفوفة مع القيمة <code>false</code> أو القيمة <code>nil</code>. | ||
إن مرِّر نمطٌ (<code>pattern</code>) بدلًا من كتلة برمجية، فسيعيد التابع <code>any</code> | |||
إن مرِّر نمطٌ (<code>pattern</code>) بدلًا من كتلة برمجية، فسيعيد التابع <code>any?</code> القيمة <code>true</code> إذا كان أحد عناصر المصفوفة يُطابق ذلك النمط. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby"> any? [{ |obj| block }] → true or false | <syntaxhighlight lang="ruby"> any? [{ |obj| block }] → true or false | ||
| سطر 10: | سطر 11: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==المعاملات== | ==المعاملات== | ||
<code>pattern</code> | |||
==== <code>pattern</code> ==== | |||
تعبير نمطي يراد منه مطابقة عناصر محددة. | تعبير نمطي يراد منه مطابقة عناصر محددة. | ||
==القيم المعادة== | ==القيم المعادة== | ||
تعاد القيمة <code>true</code> المنطقية إذا كان كل عنصر من عناصر المصفوفة المعطاة | تعاد القيمة <code>true</code> المنطقية إذا كان كل عنصر من عناصر المصفوفة المعطاة محققًا للشرط <code>block</code> المنطقي المعطى، أو لا يساوي أي عنصر من عناصر المصفوفة القيمة <code>false</code> أو القيمة <code>nil</code> إن لم يعطَ الشرط <code>block</code>، أو تطابق أحد عناصر المصفوفة مع النمط <code>pattern</code> المعطى. خلا ذلك، تعاد القيمة <code>false</code>. | ||
==أمثلة== | ==أمثلة== | ||
بعض الأمثلة عن استخدام التابع <code>any</code> | بعض الأمثلة عن استخدام التابع <code>any?</code>: | ||
<syntaxhighlight lang="ruby"> %w[ant bear cat].any? { |word| word.length >= 3 } #=> true | <syntaxhighlight lang="ruby"> %w[ant bear cat].any? { |word| word.length >= 3 } #=> true | ||
%w[ant bear cat].any? { |word| word.length >= 4 } #=> true | %w[ant bear cat].any? { |word| word.length >= 4 } #=> true | ||
| سطر 24: | سطر 26: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* التابع [[Ruby/Array/include | <code>include</code>]] | * التابع [[Ruby/Array/include | <code>include?</code>]]: يتحقق إن كان العنصر المُمرّر إليه موجودًا في المصفوفة التي استُدعيت معه. | ||
* التابع <code>frozen</code> | * التابع [[Ruby/Array/frozen|<code>frozen?</code>]]<code></code>: يتحقق إن كانت مصفوفةٌ مُجمَّدةً (frozen) بشكل دائم أو مؤقت إلى حين إعادة ترتيبها. | ||
* التابع [[Ruby/Array/empty | <code>empty</code>]] | * التابع [[Ruby/Array/empty | <code>empty?</code>]]: يتحقق إن كانت مصفوفةٌ فارغةً أم لا. | ||
==مصادر== | ==مصادر== | ||
* قسم التابع any? في الصنف Array في توثيق روبي الرسمي. | * [https://ruby-doc.org/core-2.5.1/Array.html#method-i-any-3F قسم التابع any? في الصنف Array في توثيق روبي الرسمي.] | ||
مراجعة 11:58، 5 سبتمبر 2018
يتحقق التابع any? إذا كان كل عنصر من عناصر المصفوفة المعطاة مححقًا لشرط منطقي محدد أو كانت قيمة كل عنصر لا تساوي القيمة false (أي لا يعيد أي عنصر القيمة false أو nil عند التحقق من مطابقته للشرط). إن لم تمرَّر أية كتلة برمجية تمثل الشرط، فستضيف Ruby الكتلة { |obj| obj} ضمنيًا، وسيعيد حينئذٍ التابع any? القيمة true إن لم يتساوى أي عنصر من عناصر المصفوفة مع القيمة false أو القيمة nil.
إن مرِّر نمطٌ (pattern) بدلًا من كتلة برمجية، فسيعيد التابع any? القيمة true إذا كان أحد عناصر المصفوفة يُطابق ذلك النمط.
البنية العامة
any? [{ |obj| block }] → true or false
any?(pattern) → true or false
المعاملات
pattern
تعبير نمطي يراد منه مطابقة عناصر محددة.
القيم المعادة
تعاد القيمة true المنطقية إذا كان كل عنصر من عناصر المصفوفة المعطاة محققًا للشرط block المنطقي المعطى، أو لا يساوي أي عنصر من عناصر المصفوفة القيمة false أو القيمة nil إن لم يعطَ الشرط block، أو تطابق أحد عناصر المصفوفة مع النمط pattern المعطى. خلا ذلك، تعاد القيمة false.
أمثلة
بعض الأمثلة عن استخدام التابع any?:
%w[ant bear cat].any? { |word| word.length >= 3 } #=> true
%w[ant bear cat].any? { |word| word.length >= 4 } #=> true
%w[ant bear cat].any?(/d/) #=> false
[nil, true, 99].any?(Integer) #=> true
[nil, true, 99].any? #=> true
[].any? #=> false
انظر أيضًا
- التابع
include?: يتحقق إن كان العنصر المُمرّر إليه موجودًا في المصفوفة التي استُدعيت معه. - التابع
frozen?: يتحقق إن كانت مصفوفةٌ مُجمَّدةً (frozen) بشكل دائم أو مؤقت إلى حين إعادة ترتيبها. - التابع
empty?: يتحقق إن كانت مصفوفةٌ فارغةً أم لا.