عرض مصدر Kotlin/Any

يعد الصنف <code>Any</code> الجذر الرئيسيّ في الهرميّة العامّة لأيّ صنفٍ مُستخدَمٍ في Kotlin؛ أي أنّ كلَّ صنفٍ سيكون له الصنف الأعلى (superclass)‏ <code>Any</code>.<syntaxhighlight lang="kotlin">
open class Any
</syntaxhighlight><noinclude>{{DISPLAYTITLE:الصنف <code>‎‎Any‎</code>‎ في Kotlin}}</noinclude>
== الدوال البانية ==

=== <code>[[Kotlin/Any/Init|<int>]]</code> ===
يعيد التابع <code>Any()‎</code> نسخةً من الصنف <code>[[Kotlin/Any|Any]]</code> الذي هو الجذر الرئيسيّ في الهرميّة العامّة لأيّ صنفٍ مُستخدَمٍ أثناء البرمجة في Kotlin؛ أي أنّ كلَّ صنفٍ سيكون له الصنف الأعلى (superclass)‏ <code>[[Kotlin/Any|Any]]</code>.

== الدوال ==

=== <code>[[Kotlin/Any/equals|equals]]</code> ===
تتحقق الدالة <code>equals()</code>‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معها.

=== <code>[[Kotlin/Any/hashCode|hashCode]]</code> ===
تعيد الدالة <code>hashCode()</code>‎ قيمة الشيفرة hash code الخاصّة بالكائن الذي استُدعي معه.


=== <code>[[Kotlin/Any/toString|toString]]</code> ===
تحول الدالة <code>toString()‎</code> الكائن الذي استدعي معها إلى سلسلة نصية.

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

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

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

=== <code>[[Kotlin/also|also]]</code> ===
تستدعي الدالة <code>also()‎</code> بُنية (block) الدالة المُحدَّدة مع جعل قيمة <code>this</code> كوسيط (argument) وتُعيد قيمة <code>this</code>.

=== <code>[[Kotlin/apply|apply]]</code> ===
تستدعي الدالة <code>apply()‎</code> بُنية (block) الدالة المُحدَّدة مع جعل قيمة <code>this</code> كمستقبِلٍ (receiver) لها وتُعيد قيمة <code>this</code>.

=== <code>[[Kotlin/js/asDynamic|asDynamic]]</code> ===
تعيد الدالة <code>asDynamic()‎</code> قيمة الكائن الذي استدعيت عبره على شكل قيمةٍ من النوع الديناميكي (dynamic type)، الذي يُسمَح بإسناده إلى أي متغيّر أو تمريره كمتغيّر وسيط (argument) أيًّا كان نوعه.

=== <code>[[Kotlin/js/iterator|iterator]]</code> ===
تسمح الدالة <code>iterator()‎</code> بالتكرار (iterate) على كائنٍ ديناميكيّ (<code>dynamic</code>) في الحالات الآتية:
* إن كان لديه دالة تكراريّة (iterator function).
* إن كان مصفوفةً (array).
* إن كان نسخةً (instance) من <code>kotlin.collections.Iterable</code>.

=== <code>[[Kotlin/let|let]]</code> ===
تستدعي الدالة <code>let()‎</code> بنية (block) الدالة المُحدَّدة وذلك بجعل قيمة <code>this</code> كوسيط (argument) لها وتعيد ناتج التنفيذ.

=== <code>[[Kotlin/run|run]]</code> ===
يمكن استخدام الدالة <code>run()‎</code> بطريقتين:
* استدعاء بنية (block) الدالة المُحدَّدة وذلك بجعل قيمة <code>this</code> كمستقبِلٍ (receiver) له وإعادة قيمة ناتج البنية.
* استدعاء بنية (block) الدالة المُحدَّدة وإعادة ناتجها.

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

=== <code>[[Kotlin/takeUnless|takeUnless]]</code> ===
تعيد الدالة <code>takeUnless()‎</code> الكائن (object) الذي استُدعيت عبره إن '''لم''' يكن هذا الكائن يحقق شرطًا معيّنًا، أو يعيد القيمة <code>null</code> خلاف ذلك.

=== <code>[[Kotlin/to|to]]</code> ===
تنشئ الدالة <code>to()</code>‎ عنصرًا من النوع <code>Pair</code> الذي يتكون من الكائن الذي استُدعي عبره والوسيط (argument) الذي مُرّر إليه، أي العنصر <code>that</code>.

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

== مصادر ==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html صفحة الصنف Any في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Class]]
[[تصنيف:Kotlin Any]]