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

المراجعة الحالية بتاريخ 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‎

انظر أيضًا

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

مصادر

قسم المعامل <=>‎ في الصنف Time‎ في توثيق روبي الرسمي.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع <code><=>‎</code> الخاص بالصنف <code>Time</code> في روبي}}</noinclude>
+<noinclude>{{DISPLAYTITLE: المعامل <code><=>‎</code> الخاص بالصنف <code>Time</code> في روبي}}</noinclude>
 [[تصنيف: Ruby]]
-[[تصنيف: Ruby Method]]
+[[تصنيف: Ruby Operator]]
 [[تصنيف: Ruby Time]]
-معامل الموازنة - يقارن <code>time</code> مع <code>other_time</code> (انظر فقرة البنية العامة).
+يوازن المعامل <code><=></code> بين توقيتين.
-يعيد إحدى القيم -1 أو 0 أو +1 أو nil، حسب ما إذا كان <code>time</code> أكبر من أو يساوي أو أكبر من <code>other_time</code>.
-ستُعاد القيمة <code>nil</code> إن كانت القيمتان غير قابلتين للمقارنة.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">time <=> other_time → -1, 0, +1 or nil‎</syntaxhighlight>
-==القيمة المُعادة==
+==القيمة المعادة==
+تعاد إحدى القيم ‎<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
 t2 = t + 2592000   #=> 2007-12-19 08:12:12 -0600
@@ سطر 24: / سطر 22: @@
 t2 <=> t           #=> 1
 t <=> t            #=> 0‎</syntaxhighlight>
-==انظر أيضا==
+==انظر أيضًا==
-* التابع <code>[[Ruby/Time/minus_operator|-]]</code>: معامل الفرق - يُعيد فرق الثواني على شكل [[Ruby/Time|توقيت]] <code>[[Ruby/Float|Float]]</code> بين <code>time</code> و <code>other_time</code>، أو يطرح <code>numeric</code> ثانية من <code>time</code>.
+* المعامل <code>[[Ruby/Time/minus operator|-]]</code>: يُعيد الفرق بالثانية بين وقتين، أو يطرح عددًا يمثِّل الثواني من التوقيت المعطى.
-* التابع <code>[[Ruby/Time/asctime|asctime]]</code>: يُعيد التابع <code>asctime</code> تمثيلا نصيا قانونيا لل[[Ruby/Time|توقيت]] <code>time</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‎ في توثيق روبي الرسمي.]