عرض مصدر Kotlin/this expressions

<noinclude>{{DISPLAYTITLE:تعبير <code>this</code>}}</noinclude>
== تعبير <code>this</code> ==
يُستخدم التعبير <code>this</code> لتحديد المستقبِل (receiver) الحاليّ، ويختلف ذلك بحسب الحالتين:

* تعبِّر الكلمة المفتاحيّة <code>this</code> في أيّ من عناصر [[Kotlin/classes|الصنف]] (class member) عن الكائن (object) الحاليّ من هذا الصنف.

* وتعبِّر في [[Kotlin/extensions|الدالة الإضافيّة (extension functions)]] أو [[Kotlin/lambdas|قيمة الدالة مع المستقبِل (function literal with receiver)]] عن متحول المستقبِل الذي سيُمرَّر على الطرف اليساريّ من النقطة <code>.</code>.

وإذا لم يكن هناك أي تقييدٍ (qualification) مرتبطٍ مع الكلمة المفتاحيّة <code>this</code> فإنها ستعبِّر عن أقرب مجالٍ (scope) داخليّ محيطٍ بها (enclosing)، وللتعبير عن  مجالٍ آخر فتُستخدَم التسمية لتقييدها (qualified this).

== <code>this</code> المُقيَّدة ==
كي تعبِّر الكلمة المفتاحيّة <code>this</code> عن مجالٍ (scope) خارجيّ (مثل مجال [[Kotlin/classes|صنف (class)]] أو [[Kotlin/extensions|دالة إضافيّة (extension functions)]] أو [[Kotlin/lambdas|قيمة الدالة مع المستقبِل (function literal with receiver)]] ) فتُكتب بالصيغة <code>this@label</code> حيث تكون ‎<code>@label</code> تسميةً للمجال الذي تتبع له <code>this</code>، مثل:<syntaxhighlight lang="kotlin">
class A { // تسمية ضمنيّة باسم @A
    inner class B { // تسمية ضمنيّة باسم @B
        fun Int.foo() { // تسمية ضمنيّة باسم @foo
            val a = this@A // تابعة للصنف A
            val b = this@B // تابعة للصنف B

            val c = this // مستقبِل الدالة وهو قيمة صحيحة
            val c1 = this@foo // مستقبل الدالة وهو قيمة صحيحة

            val funLit = lambda@ fun String.() {
                val d = this // funLit مستقبل
            }


            val funLit2 = { s: String ->
                // مستقبِل الدالة foo()
                // لأنه لا يوجد أي مستقبِل في تعبير lambda
                val d1 = this
            }
        }
    }
}
</syntaxhighlight>

== مصادر ==
* [https://kotlinlang.org/docs/reference/this-expressions.html صفحة التعبير this في التوثيق الرسميّ للغة Kotlin]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Lambdas]]
[[تصنيف:Kotlin Functions]]
__لصق_فهرس__