الفرق بين المراجعتين لصفحة: «Ruby/Symbol/casecmp»

المراجعة الحالية بتاريخ 09:03، 5 ديسمبر 2018

يقارن التابع casecmp بين رمزين بشكل غير حساس لحالة الأحرف. هذا التابع هو نسخة غير حساسة لحالة الأحرف (Case-insensitive) من المعامل <=>‎. في الوقت الحالي، لا تعمل الحساسية لحالة الأحرف إلا على الأحرف A-Z/a-z، وليس على كل محارف اليونيكود. هذا السلوك مختلف عن التابع casecmp?‎.

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

casecmp(other_symbol)→ -1, 0, +1, or nil‎

المعاملات

`other_symbol‎`

الرمز المراد التحقق من مقارنته مع الرمز المعطى.

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

تعاد القيمة ‎-1 أو 0 أو ‎+1 أو بناءً على ما إذا كان الرمز أصغر من أو يساوي أو أكبر من other_symbol. أو تُعاد القيمة nil إذا كان للرمزين ترميزات غير متوافقة، أو إن لم يكن other_symbol رمزًا.

أمثلة

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

:aBcDeF.casecmp(:abcde)     #=> 1
:aBcDeF.casecmp(:abcdef)    #=> 0
:aBcDeF.casecmp(:abcdefg)   #=> -1
:abcdef.casecmp(:ABCDEF)    #=> 0‎

:foo.casecmp(2)   #=> nil
"\u{e4 f6 fc}".encode("ISO-8859-1").to_sym.casecmp(:"\u{c4 d6 dc}")   #=> nil

انظر أيضًا

التابع capitalize: يشبه التعبير sym.to_s.capitalize.intern.
التابع casecmp?‎: يتحقق إن كان الرمز الذي استُدعي معه والرمز المُمرَّر إليه متساويين بعد طي حالة الترميز الموحد (Unicode case folding).

مصادر

قسم التابع casecmp‎ في الصنف Symbol‎ في توثيق روبي الرسمي.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع <code>casecmp‎</code> الخاص بالصنف <code>Symbol</code> في روبي}}</noinclude>
+<noinclude>{{DISPLAYTITLE: التابع <code>Symbol.casecmp‎</code> في روبي}}</noinclude>
 [[تصنيف: Ruby]]
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby Symbol]]
-التابع <code>casecmp</code> هو نسخة غير حساسة لحالة الأحرف للمعامل <code>Symbol#<=></code>. في الوقت الحالي، لا تعمل الحساسية لحالة الأحرف إلا على الأحرف من A-Z/a-z، وليس على كل أحرف اليونيكود. هذا مختلف عن التابع <code>[[Ruby/Symbol/casecmp-3F|#casecmp?]]</code>.
+يقارن التابع <code>casecmp</code> بين رمزين بشكل غير حساس لحالة الأحرف. هذا التابع هو نسخة غير حساسة لحالة الأحرف (Case-insensitive) من المعامل <code>[[Ruby/Symbol/compar operator|<=>‎]]</code>. في الوقت الحالي، لا تعمل الحساسية لحالة الأحرف إلا على الأحرف <code>A-Z/a-z</code>، وليس على كل محارف اليونيكود. هذا السلوك مختلف عن التابع <code>[[Ruby/Symbol/casecmp-3F|casecmp?‎]]</code>.
-تُعاد القيمة <code>nil</code> إذا كان لل[[Ruby/Symbol|رمز]] ترميزات غير متوافقة، أو إن لم يكن <code>other_symbol</code> [[Ruby/Symbol|رمز]]ا.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">casecmp(other_symbol)→ -1, 0, +1, or nil‎</syntaxhighlight>
 ==المعاملات==
 ===<code>other_symbol‎</code>===
-==القيمة المُعادة==
+الرمز المراد التحقق من مقارنته مع الرمز المعطى.
+==القيمة المعادة==
+تعاد القيمة <code>‎-1</code> أو <code>0</code> أو ‎<code>+1</code> أو بناءً على ما إذا كان الرمز أصغر من أو يساوي أو أكبر من <code>other_symbol</code>. أو تُعاد القيمة <code>nil</code> إذا كان لل[[Ruby/Symbol|رمزين]] ترميزات غير متوافقة، أو إن لم يكن <code>other_symbol</code> [[Ruby/Symbol|رمزً]]ا.
 ==أمثلة==
-مثال على استخدام التابع <code>casecmp‎</code>:
+مثال على استخدام التابع <code>casecmp‎</code>:<syntaxhighlight lang="ruby">:aBcDeF.casecmp(:abcde)     #=> 1
-<syntaxhighlight lang="ruby">:aBcDeF.casecmp(:abcde)     #=> 1
 :aBcDeF.casecmp(:abcdef)    #=> 0
 :aBcDeF.casecmp(:abcdefg)   #=> -1
-:abcdef.casecmp(:ABCDEF)    #=> 0‎</syntaxhighlight>
+:abcdef.casecmp(:ABCDEF)    #=> 0‎
-==انظر أيضا==
-* التابع <code>[[Ruby/Symbol/capitalize|capitalize]]</code>: التابع <code>capitalize</code> مشابه للتعبير <code>sym.to_s.capitalize.intern</code>.
+:foo.casecmp(2)   #=> nil
-* التابع <code>[[Ruby/Symbol/casecmp-3F|casecmp?‎]]</code>: يُعيد <code>true</code> إن كان ال[[Ruby/Symbol|رمز]] (انظر فقرة البنية العامة) <code>sym</code> و <code>other_symbol</code> متساويين بعد طي حالة اليونيكود (Unicode case folding)، أو يعيد <code>false</code> إذا لم يكونا متساويين.
+"\u{e4 f6 fc}".encode("ISO-8859-1").to_sym.casecmp(:"\u{c4 d6 dc}")   #=> nil</syntaxhighlight>
+==انظر أيضًا==
+*التابع <code>[[Ruby/Symbol/capitalize|capitalize]]</code>: يشبه التعبير <code>sym.to_s.capitalize.intern</code>.
+*التابع <code>[[Ruby/Symbol/casecmp-3F|casecmp?‎]]</code>: يتحقق إن كان ال[[Ruby/Symbol|رمز]] الذي استُدعي معه والرمز المُمرَّر إليه متساويين بعد طي حالة الترميز الموحد (Unicode case folding).
 ==مصادر==
-*[http://ruby-doc.org/core-2.5.1/Symbol.html#method-i-casecmp قسم  التابع casecmp‎ في الصنف Symbol‎ في توثيق روبي الرسمي.]
+*[http://ruby-doc.org/core-2.5.1/Symbol.html#method-i-casecmp قسم التابع casecmp‎ في الصنف Symbol‎ في توثيق روبي الرسمي.]