الفرق بين المراجعتين لصفحة: «Ruby/Range/include-3F»

من موسوعة حسوب
< Ruby‏ | Range
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>include?‎‎</code> الخاص بالصنف <code>Range</code> في روبي}}</noinclude> تصنيف: Ruby تص...'
 
مراجعة وتدقيق.
 
(مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع <code>include?‎‎</code> الخاص بالصنف <code>Range</code> في روبي}}</noinclude>
<noinclude>{{DISPLAYTITLE: التابع <code>Range.include?‎‎</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Range]]
[[تصنيف: Ruby Range]]
يعيد التابع <code>include?‎</code> القيمة <code>true</code> إن كان <code>obj</code> عنصرًا من المجال، أو يعيد <code>false</code> خلاف ذلك. إن كانت عنصرا البداية والنهاية عددان، قستتم المقارنة وفقًا لمقدار (magnitude) القيم.
يتحقق التابع <code>include?‎</code> إن كان كائنٌ ما عنصرًا من المجال المعطى.  
 
إن كان عنصرا البداية والنهاية عددين، فستتم المقارنة وفقًا لمقدار (magnitude) القيم.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="ruby">include?(obj) →  true or false‎</syntaxhighlight>
<syntaxhighlight lang="ruby">include?(obj) →  true or false‎</syntaxhighlight>
==المعاملات==
==المعاملات==
===<code>obj‎</code>===
===<code>obj‎</code>===
‎الكائن المراد التحقق من وقوعه ضمن المجال المعطى.
==القيمة المُعادة==
==القيمة المعادة==
تعاد القيمة <code>true</code> إن كان <code>obj</code>عنصرًا من المجال، أو القيمة <code>false</code> خلاف ذلك.


==أمثلة==
==أمثلة==
سطر 17: سطر 20:
("a".."z").include?("cc")  #=> false‎</syntaxhighlight>
("a".."z").include?("cc")  #=> false‎</syntaxhighlight>
==انظر أيضا==
==انظر أيضا==
* التابع <code>[[Ruby/Range/hash|hash]]</code>: يحسب  رمز التكويد (hash-code) لهذا المجال. مجالان عنصرا بدايتهما ونهايتهما متساويان (باستخدام المعامل <code>[[Ruby/Range/eql-3F|eql?‎]]</code>)، وقيمة <code>[[Ruby/Range/exclude_end-3F|exclude_end?]]</code> الخاصة بهما متساوية سيُولّدان نفس رمز التكويد.
* المعامل [[Ruby/Range/case equality|<code>===</code>]]: يعيد القيمة <code>true</code> إن كانت قيمةٌ أو كائنٌ ما أحد عناصر المجال (أي تقع ضمنه).
* التابع <code>[[Ruby/Range/inspect|inspect]]</code>: بُحوّل  المجال إلى شكل قابل للطباعة (باستخدام <code>inspect</code> لتحويل عنصري البداية والنهاية).
 
* التابع <code>[[Ruby/Range/cover-3F|cover?‎]]</code>: يتحقق إن كان الكائن المُمرَّر إليه محصورًا بين بداية ونهاية المجال.


==مصادر==
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Range.html#method-i-include-3F قسم التابع include?‎ في الصنف Range‎ في توثيق روبي الرسمي.]
*[http://ruby-doc.org/core-2.5.1/Range.html#method-i-include-3F قسم التابع include?‎ في الصنف Range‎ في توثيق روبي الرسمي.]

المراجعة الحالية بتاريخ 06:36، 3 ديسمبر 2018

يتحقق التابع include?‎ إن كان كائنٌ ما عنصرًا من المجال المعطى.

إن كان عنصرا البداية والنهاية عددين، فستتم المقارنة وفقًا لمقدار (magnitude) القيم.

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

include?(obj)   true or false

المعاملات

obj‎

‎الكائن المراد التحقق من وقوعه ضمن المجال المعطى.

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

تعاد القيمة true إن كان objعنصرًا من المجال، أو القيمة false خلاف ذلك.

أمثلة

مثال على استخدام التابع include?‎:

("a".."z").include?("g")   #=> true
("a".."z").include?("A")   #=> false
("a".."z").include?("cc")  #=> false‎

انظر أيضا

  • المعامل ===: يعيد القيمة true إن كانت قيمةٌ أو كائنٌ ما أحد عناصر المجال (أي تقع ضمنه).
  • التابع cover?‎: يتحقق إن كان الكائن المُمرَّر إليه محصورًا بين بداية ونهاية المجال.

مصادر