Kotlin/this expressions

تعبير this

يُستخدم التعبير this لتحديد المستقبِل (receiver) الحاليّ، ويختلف ذلك بحسب الحالتين:

• تعبِّر الكلمة المفتاحيّة this في أيّ من عناصر الصنف (class member) عن الكائن (object) الحاليّ من هذا الصنف.

• وتعبِّر في الدالة الإضافيّة (extension functions) أو قيمة الدالة مع المستقبِل (function literal with receiver) عن معامل المستقبِل الذي سيُمرَّر على الطرف اليساريّ من النقطة ..

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

this المُقيَّدة

كي تعبِّر الكلمة المفتاحيّة this عن مجالٍ (scope) خارجيّ (مثل مجال صنف (class) أو دالة إضافيّة (extension functions) أو قيمة الدالة مع المستقبِل (function literal with receiver) ) فتُكتب بالصيغة this@label حيث تكون ‎@label تسميةً للمجال الذي تتبع له this، مثل:

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
            }
        }
    }
}

مصادر

• صفحة التعبير this في التوثيق الرسميّ للغة Kotlin