Kotlin/Any

الدوال البانية

<int>

يعيد التابع Any()‎ نسخةً من الصنف Any الذي هو الجذر الرئيسيّ في الهرميّة العامّة لأيّ صنفٍ مُستخدَمٍ أثناء البرمجة في Kotlin؛ أي أنّ كلَّ صنفٍ سيكون له الصنف الأعلى (superclass)‏ Any.

الدوال

equals

تبين الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت عبره

hashCode

يعيد التابع hashCode()‎ قيمة الشيفرة hash code الخاصّة بالكائن الذي استُدعي عبره، ويحقِّق التابع hashCode()‎ دائمًا الشرطين الآتيين:

• سيعيد نفس العدد الصحيح دائمًا في كل مرة يُستدعى على كائنٍ مُعيَّن شريطة عدم تغيُّر أيّ معلومة يستخدمها التابع equals()‎ لأجل المقارنة مع الكائن.
• إذا تساوى كائنان بحسب التابع equals()‎، فسينتج نفس العدد الصحيح (المُعبِّر عن الشيفرة hash code) عند استدعاء التابع hashCode()‎ على أيٍّ منهما.

toString

يعيد التابع toString()‎ تمثيلًا نصيًا للكائن الذي يُستدعى عبره.

الخاصيات الإضافية (Extension Properties)

javaClass

تعيد الخاصيّة javaClass صنف Java الخاص بالكائن (object) الذي تُستدعى عبره أثناء التشغيل (runtime)، وتُعرَّف هذه الخاصيّة في جميع الأصناف الفرعيّة (sub-classes) من الصنف Any.

الدوال الإضافية (Extension Functions)

also

تستدعي الدالة also()‎ بُنية (block) الدالة المُحدَّدة مع جعل قيمة this كوسيط (argument) وتُعيد قيمة this.

apply

تستدعي الدالة apply()‎ بُنية (block) الدالة المُحدَّدة مع جعل قيمة this كمستقبِلٍ (receiver) لها وتُعيد قيمة this.

asDynamic

تعيد الدالة asDynamic()‎ قيمة الكائن الذي استدعيت عبره على شكل قيمةٍ من النوع الديناميكي (dynamic type)، الذي يُسمَح بإسناده إلى أي متغيّر أو تمريره كمتغيّر وسيط (argument) أيًّا كان نوعه.

iterator

يسمح التابع iterator()‎ بالتكرار (iterate) على كائنٍ ديناميكيّ (dynamic) في الحالات الآتية:

• إن كان لديه دالة تكراريّة (iterator function).
• إن كان مصفوفةً (array).
• إن كان نسخةً (instance) من kotlin.collections.Iterable.

let

تستدعي الدالة let()‎ بنية (block) الدالة المُحدَّدة وذلك بجعل قيمة this كوسيط (argument) لها وتعيد ناتج التنفيذ.

run

يمكن استخدام الدالة run()‎ بطريقتين:

• استدعاء بنية (block) الدالة المُحدَّدة وذلك بجعل قيمة this كمستقبِلٍ (receiver) له وإعادة قيمة ناتج البنية.
• استدعاء بنية (block) الدالة المُحدَّدة وإعادة ناتجها.

takeIf

تعيد الدالة takeIf()‎ الكائن (object) الذي استُدعيت عبره إن كان ذلك الكائن يحقق شرطًا معيّنًا، أو تعيد القيمة null خلاف ذلك.

takeUnless

تعيد الدالة takeUnless()‎ الكائن (object) الذي استُدعيت عبره إن لم يكن هذا الكائن يحقق شرطًا معيّنًا، أو يعيد القيمة null خلاف ذلك.

to

تنشئ الدالة to()‎ عنصرًا من النوع Pair الذي يتكون من الكائن الذي استُدعي عبره والوسيط (argument) الذي مُرّر إليه، أي العنصر that.

unsafeCast

يحوِّل المعامل as الكائن الذي استُدعي عبره إلى نوعٍ  آخر (T) بشكلٍ غير آمن (unsafe) أي بدون التحقُّق من الأنواع، فإن كان التحويل غير جائزٍ، فسيُعلِم المُترجم بوجود خطأٍ، ويعبِّر المعامل as عن استدعاء الدالة unsafeCast()‎ التي تقوم بالتحويل الفعليّ.

مصادر

• الصفحة Any في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.