الفرق بين المراجعتين ل"Ruby/Time/compar operator"

من موسوعة حسوب
< Ruby‏ | Time
اذهب إلى التنقل اذهب إلى البحث
ط (مراجعة وتدقيق.)
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع <code><=>‎</code> الخاص بالصنف <code>Time</code> في روبي}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: المعامل <code><=>‎</code> الخاص بالصنف <code>Time</code> في روبي}}</noinclude>
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
+
[[تصنيف: Ruby Operator]]
 
[[تصنيف: Ruby Time]]
 
[[تصنيف: Ruby Time]]
معامل الموازنة - يقارن <code>time</code> مع <code>other_time</code> (انظر فقرة البنية العامة).
+
يوازن المعامل <code><=></code> بين توقيتين.
 
 
يعيد إحدى القيم ‎<code>-1</code> أو <code>0</code> أو‎ <code>+1</code> أو <code>nil</code>، حسب ما إذا كان <code>time</code> أصفر من أو يساوي أو أكبر من <code>other_time</code>.
 
 
 
ستُعاد القيمة <code>nil</code> إن كانت القيمتان غير قابلتين للمقارنة.
 
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="ruby">time <=> other_time → -1, 0, +1 or nil‎</syntaxhighlight>
 
<syntaxhighlight lang="ruby">time <=> other_time → -1, 0, +1 or nil‎</syntaxhighlight>
==القيمة المُعادة==
+
==القيمة المعادة==
يعيد إحدى القيم ‎<code>-1</code> أو <code>0</code> أو‎ <code>+1</code> أو <code>nil</code>، حسب ما إذا كان <code>time</code> أصفر من أو يساوي أو أكبر من <code>other_time</code>.
+
تعاد إحدى القيم ‎<code>-1</code> أو <code>0</code> أو ‎<code>+1</code> حسب ما إذا كان التوقيت <code>time</code> أصفر من أو يساوي أو أكبر من التوقيت <code>other_time</code>. تعاد القيمة <code>nil</code> إن لم بالإمكان الموازنة بين القيمتين.
  
 
==أمثلة==
 
==أمثلة==
مثال على استخدام التابع <code><=>‎</code>:
+
مثال على استخدام المعامل <code><=>‎</code>:
 
<syntaxhighlight lang="ruby">t = Time.now      #=> 2007-11-19 08:12:12 -0600
 
<syntaxhighlight lang="ruby">t = Time.now      #=> 2007-11-19 08:12:12 -0600
 
t2 = t + 2592000  #=> 2007-12-19 08:12:12 -0600
 
t2 = t + 2592000  #=> 2007-12-19 08:12:12 -0600
سطر 26: سطر 22:
 
t2 <=> t          #=> 1
 
t2 <=> t          #=> 1
 
t <=> t            #=> 0‎</syntaxhighlight>
 
t <=> t            #=> 0‎</syntaxhighlight>
==انظر أيضا==
+
==انظر أيضًا==
* التابع <code>[[Ruby/Time/minus_operator|-]]</code>: معامل الفرق  
+
* المعامل <code>[[Ruby/Time/minus operator|-]]</code>: يُعيد الفرق بالثانية بين وقتين، أو يطرح عددًا يمثِّل الثواني من التوقيت المعطى.
* التابع <code>[[Ruby/Time/plus operator|+]]</code>: معامل الإضافة
+
* المعامل <code>[[Ruby/Time/plus operator|+]]</code>: يضيف عددًا من الثواني (ربما يكون عدد كسري) إلى [[Ruby/Time|التوقيت]] المعطى، ثم يُعيد تلك القيمة [[Ruby/Time|كتوقيت]] جديد.
 
==مصادر==
 
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Time.html#method-i-3C-3D-3E قسم التابع <=>‎ في الصنف Time‎ في توثيق روبي الرسمي.]
+
*[http://ruby-doc.org/core-2.5.1/Time.html#method-i-3C-3D-3E قسم المعامل <=>‎ في الصنف Time‎ في توثيق روبي الرسمي.]

المراجعة الحالية بتاريخ 12:02، 6 ديسمبر 2018

يوازن المعامل <=> بين توقيتين.

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

time <=> other_time  -1, 0, +1 or nil

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

تعاد إحدى القيم ‎-1 أو 0 أو ‎+1 حسب ما إذا كان التوقيت time أصفر من أو يساوي أو أكبر من التوقيت other_time. تعاد القيمة nil إن لم بالإمكان الموازنة بين القيمتين.

أمثلة

مثال على استخدام المعامل <=>‎:

t = Time.now       #=> 2007-11-19 08:12:12 -0600
t2 = t + 2592000   #=> 2007-12-19 08:12:12 -0600
t <=> t2           #=> -1
t2 <=> t           #=> 1
t = Time.now       #=> 2007-11-19 08:13:38 -0600
t2 = t + 0.1       #=> 2007-11-19 08:13:38 -0600
t.nsec             #=> 98222999
t2.nsec            #=> 198222999
t <=> t2           #=> -1
t2 <=> t           #=> 1
t <=> t            #=> 0‎

انظر أيضًا

  • المعامل -: يُعيد الفرق بالثانية بين وقتين، أو يطرح عددًا يمثِّل الثواني من التوقيت المعطى.
  • المعامل +: يضيف عددًا من الثواني (ربما يكون عدد كسري) إلى التوقيت المعطى، ثم يُعيد تلك القيمة كتوقيت جديد.

مصادر