Ruby/BasicObject/equal-3F

يتحقق التابع equal?‎ إذا كان الكائن الذي استُدعي معه والكائن الذي مُرّر إليه هما نفس الكائن أو يشيران إلى نفس مفتاح الخريطة (hash key).

عمومًا، يُعاد تعريف هذا التابع في الأصناف السليلة (descendant classes) لتتناسب مع تلك الأصناف. خلافًا للمعامل ==، يجب ألا يُعاد تعريف التابع equal?‎ من قِبل الأصناف الفرعية، إذ يُستخدم آنذاك لتحديد هوية الكائن (أي يستعمل بالشكل a.equal?(b)‎ لتحديد إذا وفقط إذا كان الكائن a هو نفسه الكائن b [انظر المثال في الأسفل]).

يُستخدم هذا التابع من قِبل كائنات الصنف Hash للتحقق من تساوي العناصر. بالنسبة لكائنات الصنف Object، يكون استعمال التابع eql?‎ مماثلًا لاستعمال المعامل ==.

تستمر الأصناف الفرعية بتطبيق هذا الأمر وذلك بجعل التابع eql?‎ اسمًا بديلًا للمعامل == المُعاد تعريفه (overridden) في تلك الأصناف، ولكن هنالك استثناءات دومًا. يُجرَى للأنواع العددية (Numeric types) مثلًا عمليات تحويل عند موازنتها باستعمال المعامل == فقط، وليس باستعمال التابع ?eql. إليك المثال التالي الذي يوضح ذلك:

1 == 1.0     #=> true
1.eql? 1.0   #=> false

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

equal?(other) → true or false

المعاملات

other

الكائن المراد التحقق من تساويه مع الكائن المعطى.

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

تعاد القيمة true إن كان الكائن المعطى والكائن other المُمرَّر هما نفس الكائن أو يشيران إلى نفس مفتاح الخريطة (hash key)، أو تعاد القيمة false خلاف ذلك.

أمثلة

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

obj = "a"
other = obj.dup


obj == other      #=> true
obj.equal? other  #=> false
obj.equal? obj    #=> true

انظر أيضًا

• المعامل ==: يتحقق‎ من تساوي كائنين.
• المعامل ‎!=‎‎: يتحقق‎ من عدم تساوي كائنين.

مصادر

• قسم التابع equal?‎ في الصنف BasicObject في توثيق روبي الرسمي.