Kotlin/keyword reference

 الكلمات المفتاحيّة الثابتة (Hard Keywords)

تُعدُّ الكلمات الآتية كلماتٍ مفتاحيّةً في لغة Kotlin وليس ممكنًا استخدامها كمُعرِّفات (identifiers):

• as
  • تُستخدَم في التحويلات ما بين الأنواع (typecasts)
  • تُحدِّد تسميةً بديلةً (alias) عند عملية الاستيراد (import)
• as?‎ للتحويلات الحافظة للنوع (safe type casts)

• break لإنهاء تنفيذ الحلقات (loops)
• class للتصريح عن الأصناف
• continue  للاستمرار بالخطوة التالية لأقرب حلقة محيطة (enclosing)
• do للبدء بحلقة do/while (والتي يُختبَر الشرط فيها لاحقًا)
• else لتعريف فرعٍ (branch) من تعبير الشرط if والذي سيُنفَّذ عندما يكون الشرط بالقيمة false
• false لتحديد القيمة false من النوع المنطقيّ (boolean)
• for للبدء بحلقة for
• fun للتصريح عن الدالة (function)
• if للبدء بتعبير الشرط if
• in
  • لتحديد الكائن (object) الذي يتم المرور بعناصره (iterated) في حلقة for
  • يُستخدَم كمعاملٍ ضمنيّ (infix) للتحقُّق من انتماء القيمة إلى مجالٍ (range) أو مجموعةٍ (collection) أو أيّ كيانٍ (entity) يُعرِّف التابع contains
  • يُستخدَم في تعبير when ولنفس الهدف السابق
  • يجعل متحوّل النوع contravariant

• ‎!in
  • يُستخدَم كمعاملٍ للتأكّد من أن القيمة لا تنتمي إلى مجالٍ (range) أو مجموعةٍ (collection) أو أيّ كيانٍ (entity) يُعرِّف التابع contains
  • يُستخدَم في تعبير when ولنفس الهدف السابق
• interface للتصريح عن الواجهة
• is
  • للتحقُّق من أنّ القيمة من نوعٍ (type) مُحدَّدٍ
  • يُستخدَم في تعبير when ولنفس الهدف السابق
• ‎!is
  • للتحقُّق من أنّ القيمة ليست من نوعٍ (type) مُحدَّدٍ
  • يُستخدَم في تعبير when ولنفس الهدف السابق
• null هي قيمة ثابتة (constant) تمثِّل مرجعيةً كائنيةً (object reference) لا تشير إلى أيّ كائنٍ.
• object للتصريح عن الصنف (class) والكائن (instance) منه معًا
• package لتحديد الحزمة الحاليّة للملف (file)
• return للعودة من أقرب دالةٍ محيطةٍ (enclosing function) أو دالةٍ مجهولةٍ (anonymous function)
• super
  • تشير إلى تعريف استخدام (implementation) الصنف الأعلى (superclass) للتابع (method) أو الخاصّيّة (property)
  • لاستدعاء باني الصنف الأعلى (superclass constructor) من الباني الثانويّ (secondary constructor)
• this
  • تشير إلى المُستقبِل (receiver) الحاليّ
  • لاستدعاء بانٍ (constructor) آخر من نفس الصنف (class) عبر بانٍ ثانويّ (secondary constructor)
• throw لرمي استثناءٍ (exception)
• true لتحديد القيمة true من النوع المنطقيّ (boolean)
• try  لبدء قسم التعامل مع الاستثناء (exception)
• typealias للتصريح عن التسمية البديلة (alias) للأنواع
• val للتصريح عن خاصّيّةٍ للقراءة فقط (read-only) أو متحوّلٍ محليّ (local variable)
• var للتصريح عن خاصّيّة متغيّرةٍ (mutable) أو متحوّلٍ محليّ (local variable)
• when للبدء بتعبير when (لتنفيذ إحدى الحالات الفرعيّة الواردة)
• while للبدء بحلقة while (التي تختبِر الشرط أولًا)

الكلمات المفتاحيّة المرنة (Soft Keywords)

قد تُستخدَم الكلمات الآتية ككلماتٍ مفتاحيّةٍ في سياقٍ (context) ما أو كمُعرِّفاتٍ (identifiers) في سياقٍ آخر:

• by
  • لتعميم (delegate) تعريف استخدام (implementation) الواجهة إلى كائنٍ (object) آخر
  • لتعميم (delegate) تعريف الاستخدام (implementation) لعمليات الوصول للخاصّيّة (property accessors) إلى كائنٍ (object) آخر
• catch  للبدء بالقسم الذي يُعالِج (handle) نوع استثناءٍ (exception) مُحدَّد
• constructor للتصريح عن بانٍ أساسيّ (primary) أو ثانويّ (secondary)
• delegate تُستخدَم كتوصيفٍ (annotation) لهدف موقع الاستخدام (use-site target)
• dynamic تُستخدَم كمرجعيةٍ (reference) لنوعٍ ديناميكيٍّ في شيفرة Kotlin/JS
• field تُستخدَم كتوصيفٍ (annotation) لهدف موقع الاستخدام (use-site target)
• fileتُستخدَم كتوصيفٍ (annotation) لهدف موقع الاستخدام (use-site target)
• finally للبدء بالقسم الذي سيُنفَّذُ عند الخروج من الجزء try
• get
  • لتعريف الوصول عبر getter للخاصّيّة
  • تُستخدَم كتوصيفٍ (annotation) لهدف موقع الاستخدام (use-site target)
• import لاستيراد التصريح من حزمةٍ أخرى للملفّ (file) الحالي
• init للبدء بجزء التهيئة (initializer block)
• param تُستخدَم كتوصيفٍ (annotation) لهدف موقع الاستخدام (use-site target)
• propertyتُستخدَم كتوصيفٍ (annotation) لهدف موقع الاستخدام (use-site target)
• receiverتُستخدَم كتوصيفٍ (annotation) لهدف موقع الاستخدام (use-site target)
• set
  • لتعريف الوصول عبر setter للخاصّيّة
  • تُستخدَم كتوصيفٍ (annotation) لهدف موقع الاستخدام (use-site target)
• setparamتُستخدَم كتوصيفٍ (annotation) لهدف موقع الاستخدام (use-site target)
• where لتحديد القيود (constraints) لمتحوِّل النوع المُعمَّم

المُحدِّدات (Modifier Keywords)

قد تُستخدَم الكلمات الآتية كمُحدِّداتٍ (modifiers) في التصريحات، أو كمُعرِّفاتٍ (identifiers) في أيّ سياقٍ آخر:

• actual للإشارة إلى تعريف الاستخدام (implementation) الخاصّ بالمنصّة (platform) في المشاريع متعدِّدة المنصّات (multiplatforms)
• abstract لجعل الصنف (class) (أو عنصرٍ منه) مُجرَّدًا
• annotation للتصريح عن صنف (class) التوصيف
• companionللتصريح عن الكائن المرافق
• const لجعل الخاصّيّة (property) كثابتٍ أثناء التنفيذ (compile-time constant)
• crossinline لمنع الرجوع غير المحليّ (non-local return) في تعبير lambda المُمرَّر إلى الدالة المباشرة (inline function)
• data لإعلام المُترجِم (compiler) بتوليد عناصر قانونيةٍ للصنف (class)
• enum للتصريح عن الثوابت المُتعدِّدة (enumeration)
• expectلجعل التصريح خاصًا بالمنصّة (platform-specific) إذ يُتوقَّع تعريف استخدامه (implementation) في وحدة المنصّة
• external لجعل التصريح قابلًا لتعريف الاستخدام (implementation) خارج Kotlin (عبر JNI أو في JavaScript)
• final لمنع إعادة تعريف (overriding) عنصر الصنف (class member)
• infix للسماح باستدعاء الدالة (function) بالتدوين الداخليّ (infix notation)
• inline لإعلام المُترجِم بتضمين الدالة (function) وتعبير lambda المُمرَّر لها مباشرةً (inline) في موقع الاستدعاء (call site)
• inner للسماح بالإشارة لكائن الصنف الخارجيّ (outer class instance) من الصنف المتداخِل (nested)
• internal لجعل التصريح مرئيًّا في الوحدة (module) الحاليّة
• lateinit تسمح بتهيئة (initializing) الخاصّيّة غير الفارغة (non-null property) خارج الباني (constructor)
• noinline تمنع التضمين المباشر (inlining) لتعبير lambda المُمرَّر إلى الدالة (function) المباشرة
• open للسماح بإنشاء أصناف فرعيّة (subclasses) من الصنف أو إعادة تعريف (override) عنصرٍ منه
• operator لتحديد الدالة كتحميلٍ زائدٍ (overloading) للمعامِل أو تعريف استخدام اصطلاحيّ
• out لجعل متحوّل النوع covariant
• override لجعل العنصر كإعادة تعريفٍ (overriding) لعنصرٍ من الصنف الأعلى (superclass)
• private لجعل التصريح مرئيًا في الصنف (class) الحاليّ أو الملف (file) فقط
• protected لجعل التصريح مرئيًا في الصنف (class) الحاليّ أو أصنافه الفرعيّة (subclasses)
• public لجعل التصريح مرئيًا في كلِّ مكان
• reified لجعل متحوّل النوع للدالة المباشرة (inline function) متاحًا للوصول أثناء التنفيذ (runtime)
• sealed للتصريح عن صنفٍ مغلقٍ ( sealed class) (محدود الأصناف الفرعيّة [subclasses])
• suspend تحديد الدالة (function) أو تعبير lambda كنوع تأخيرٍ (قابلٍ للاستخدام كروتيناتٍ مساعدة [coroutines])
• tailrec لجعل الدالة تعاوديّةً (tail-recursive) (تسمح للمترجِم [compiler] باستخدام التكرار [iteration] بدلًا من التعاودية [recursion])
• vararg للسماح بتمرير عددٍ متغيّرٍ من المتحولات (arguments) للمتحول الوسيط (parameter)

المُعرِّفات الخاصّة (Special Identifiers)

وهي مُعرَّفةٌ لدى المُترجِم (compiler) بسياقٍ معيّنٍ ويمكن استخدامها كمعرِّفات (identifiers) في سياقٍ آخر:

• field تُستخدَم داخل عمليات الوصول (accessors) إلى الخاصّيّة (property) للإشارة إلى الحقل المساعد (backing field) للخاصّيّة
• it  تُستخدَم داخل تعبير lambda للإشارة إلى متحولها الوحيد ضمنيًا (implicitly)

المُعامِلات والرموز الخاصّة (Operators and Special Symbols)

• + و - و * و / و % لتنفيذ العمليات الحسابيّة
  • * يُستخدَم أيضًا لتمرير مصفوفةٍ (array) إلى متحولٍ وسيطٍ (parameter) متغيّرِ العدد
• =
  • معامل الإسناد (assignment)
  • لتحديد القيم الافتراضيّة للمتحولات الوسيطة (parameters)
• ‎+=‎ و ‎-=‎ و ‎*=‎ و ‎/=‎ و ‎%=‎ معامِلات الإسناد المُحسَّنة (augmented assignment)
• ++ و-- معاملات الزيادة (increment) والنقصان (decrement)
• && و || و ! معاملات العمليّات المنطقيّة and و or و not (وللقيام بالعمليات على مستوى الخانة الثنائيّة [bitwise] تُستخدَم الدالة الموافقة بالصيغة الداخليّة [infix function])
• == و ‎!=‎ معاملات التساوي (تُترجَم لاستدعاءاتٍ للدالة equals()‎ وذلك للأنواع غير الأساسيّة [non-primitive])
• === و ‎!==‎ معاملات التساوي بالمرجعيّة (referential equality)
• ‎<‎ و ‎>‎ و ‎<=‎ و ‎>=‎ معاملات المقارنة (تُترجَم لاستدعاءاتٍ للدالة compareTo()‎ وذلك للأنواع غير الأساسيّة [non-primitive])
• [و ] معامل الوصول المُفهرَس (indexed) (تُترجَم لاستدعاءاتٍ للدالتين get و set)
• !! للتأكيد على أنّ التعبير ليس بقيمة null
• ‎?.‎ للاستدعاء الآمن (safe call) (استدعاء تابعٍ [method] أو الوصول إلى الخاصّيّة [property] عندما لا يكون المُستقبِل [receiver] بالقيمة null)
• ‎?:‎ الحصول على القيمة بالطرف الأيمن إن كانت القيمة بالطرف الأيسر null (معامل elvis)
• ::  لإنشاء مرجعيّة عنصرٍ (member reference) أو مرجعيّة صنفٍ (class reference)
• .. لإنشاء المجال (range)
• : للفصل ما بين الاسم والنوع (type) في التصريحات
• ? لجعل النوع nullable (يقبل القيمة الفارغة null)
• ‎->‎
  • للفصل بين المتحولات (parameters) وبُنية تعبير lambda
  • للفصل بين المتحولات (parameters) وتصريح النوع المُعاد في نوع الدالة (function type)
  • للفصل بين الشرط والبُنية (block) في الفرع (branch) من تعبير when
• @
  • إنشاء توصيفٍ (annotation)
  • إنشاء مرجعيّةٍ لتسمية الحلقة ( loop label)
  • إنشاء مرجعيّةٍ لتسمية تعبير lambda
  • إنشاء مرجعيّةٍ لتعبير this من مجالٍ خارجيّ (outer scope)
  • إنشاء مرجعيّةٍ للصنف الأعلى الخارجيّ (outer superclass)
• ; للفصل بين التعليمات المتعدِّدة الواقعة في نفس السطر
• $ مرجعيّة لمتحولٍ (variable) أو تعبيرٍ (expression) في قالب السلسلة النصية (string template)
• _
  • بديلٌ عن المتحول غير المُستخدَم في تعبير lambda
  • بديلٌ عن المتحول غير المُستخدَم في التصريح بالتفكيك (destructuring declaration)

مصادر

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