Ruby/Range

يمثل الصنف Range مجالًا - مجموعة من القيم لها بداية ونهاية. يمكن إنشاء المجالات باستخدام المحارف s..e و s...e ، أو باستخدام ::new. المجالات المُنشأة باستخدام الصياغة النقطية .. تشمل عنصري البداية والنهاية. أما تلك المُنشأة باستخدام ... فلن تشمل قيمة النهاية. عند استخدامها كمكرر (iterator)، ستعيد المجالات بالتتابع كل قيمها.

(-1..-5).to_a      #=> []
(-5..-1).to_a      #=> [-5, -4, -3, -2, -1]
('a'..'e').to_a    #=> ["a", "b", "c", "d", "e"]
('a'...'e').to_a   #=> ["a", "b", "c", "d"]
‎

تخصيص المجالات ¶ ↑ يمكن إنشاء المجالات باستخدام أيٍّ من الكائنات التي يمكن المقارنة بينها باستخدام المعامل <=>. تتوقع التوابع التي تتعامل مع المجالات كتسلسلات (#each والتوابع الموروثة من Enumerable) أن يقوم كائن بداية المجال بتقديم (implement) تابع succ يعيد الكائن الموالي. يتطلب التابعان step و include? من كائن بداية المجال تقديم التابع succ، أو أن يكون قيمة عددية. في الصنف Xs أدناه قُدِّم كلّ من <=> و succ حتى يُستخدم Xs لبناء المجالات. لاحظ أنه تم تضمين الوحدة Comparable بحيث يتم تعريف التابع == بالتوافق مع <=>.

class Xs                # represent a string of 'x's
  include Comparable
  attr :length
  def initialize(n)
    @length = n
  end
  def succ
    Xs.new(@length + 1)
  end
  def <=>(other)
    @length <=> other.length
  end
  def to_s
    sprintf "%2d #{inspect}", @length
  end
  def inspect
    'x' * @length
  end
end
‎

مثال على استخدام Xs لإنشاء مجال:

r = Xs.new(3)..Xs.new(6)   #=> xxx..xxxxxx
r.to_a                     #=> [xxx, xxxx, xxxxx, xxxxxx]
r.member?(Xs.new(5))       #=> true
‎

توابع الصنف العامة (Public Class Methods)

التابع new

ينشئ مجالًا باستخدام الوسيطين begin و end . في حال حذف الوسيط exclude_end أو false ، فسيشل rng كائن النهاية. خلاف ذلك، سيُستبعد.

التابع ==

يعيد القيمة true فقط إن كان obj من النوع Range، وكان له نفس عنصري البداية والنهاية (بمقارنتهما بالمعامل ==)، وكان له نفس إعدادات exclude_end? مقارنة ب.

التابع ===

يعيد القيمة true إن كان obj أحد عناصر المجال، أو false خلاف ذلك. المعامل === هو معلم المقارنة الذي تستخدمه عبارات case.

التابع begin

يعيد الكائن الذي يحدد بداية المجال.

التابع bsearch

باستخدام البحث الثنائي (binary search)، يبحث عن قيمة من المجال تفي بالشرط المعطى في مدة O (log n) حيث n هو حجم المجال.

التابع cover?‎

يعيد القيمة true إن كان obj محصورًا بين بداية ونهاية المجال.

التابع each

يُكرر تنفيذ الكتلة المعطاة مع تمرير عناصر المجال إليها بالتتابع.

التابع end

يعيد الكائن الذي يحدد نهاية المجال.

التابع eql?‎

يعيد القيمة true فقط إن كان obj من النوع Range، وكان له نفس عنصري البداية والنهاية (بمقارنتها بالمعامل eql?‎) ، وكان له نفس إعدادات exclude_end? مقارنة ب.

التابع exclude_end?‎

يعيد القيمة true إن كان المجال يستثني قيمته النهائية.

التابع first

يعيد الكائن الأول في المجال، أو يعيد مصفوفة مكونة من أول n عنصر.

التابع hash

يحسب رمز التكويد (hash-code) لهذا المجال. مجالان عنصرا بدايتهما ونهايتهما متساويان (باستخدام المعامل eql?‎)، وقيمة exclude_end? الخاصة بهما متساوية سيُولّدان نفس رمز التكويد.

التابع include?‎

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

التابع inspect

بُحوّل المجال إلى شكل قابل للطباعة (باستخدام inspect لتحويل عنصري البداية والنهاية).

التابع last

يعيد العنص الأخير في المجال، أو مصفوفة مؤلفة من آخر n عنصر.

التابع max

يعيد القيمة القصوى من المجال. يعيد nil إن كان عنصر بداية المجال أكبر من عنصر نهايته. ويعيد nil إن كانت قيمة البداية لمجال إقصائي (exclusive) مساوية لقيمة نهايته.

التابع member?‎

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

التابع min

يعيد القيمة الدنيا من المجال. يعيد nil إن كانت قيمة بداية المجال أكبر من قيمة نهايته. أو يعيد nil إن كانت قيمة البداية للمجال الإقصائي (exclusive، أي أنه يستثني عنصر النهاية) مساوية لقيمة عنصر النهاية.

التابع size

يعيد عدد العناصر في المجال. يجب أن يكون كل من بداية ونهاية Range قيمتان عدديتان (Numeric)، وإلا فستُعاد nil.

التابع step

يكرر الكتلة المعطاة ويمرر إليها n عنصرًا من عناصر المجال بالتتابع. إن كان عنصرا البداية والنهاية عددان، فسيضاف n عند كل تكرار. وإلا، فإن step ستستدعي succ للتكرار عبر عناصر المجال.

التابع to_s

بُحوّل المجال إلى شكل قابل للطباعة (باستخدام to_s لتحويل عنصري البداية والنهاية).

• قسم الصنف Range في توثيق روبي الرسمي.