الفرق بين المراجعتين لصفحة: «Kotlin/keyword reference»

→ التعديل السابق التعديل اللاحق ←

مرئينص الويكي

مراجعة 11:55، 25 مارس 2018

الكلمات المفتاحيّة الثابتة (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

@@ سطر 82: / سطر 82: @@
 *<code>companion</code>للتصريح عن [[Kotlin/object declarations|الكائن المرافق]]
 *<code>const</code> لجعل [[Kotlin/properties|الخاصّيّة (property) كثابتٍ أثناء التنفيذ (compile-time constant)]]
-*<code>crossinline</code> لمنع [[Kotlin/inline functions|الرجوع غير المحليّ (non-local return) في تعبير lambda المُمرَّر إلى الدالة السطريّة (inline function)]]
+*<code>crossinline</code> لمنع [[Kotlin/inline functions|الرجوع غير المحليّ (non-local return) في تعبير lambda المُمرَّر إلى الدالة المباشرة (inline function)]]
 *<code>data</code> <nowiki/>[[Kotlin/data classes|لإعلام المُترجِم (compiler) بتوليد عناصر قانونيةٍ للصنف (class)]]
 *<code>enum</code> للتصريح عن [[Kotlin/enum classes|الثوابت المُتعدِّدة (enumeration)]]
@@ سطر 89: / سطر 89: @@
 *<code>final</code> لمنع [[Kotlin/classes|إعادة تعريف (overriding) عنصر الصنف (class member)]]
 *<code>infix</code> للسماح [[Kotlin/functions|باستدعاء الدالة (function) بالتدوين الداخليّ (infix notation)]]
-*<code>inline</code> لإعلام المُترجِم [[Kotlin/inline functions|بتضمين الدالة (function) وتعبير lambda المُمرَّر لها سطريًا (inline) في موقع الاستدعاء (call site)]]
+*<code>inline</code> لإعلام المُترجِم [[Kotlin/inline functions|بتضمين الدالة (function) وتعبير lambda المُمرَّر لها مباشرةً (inline) في موقع الاستدعاء (call site)]]
 *<code>inner</code> للسماح بالإشارة لكائن الصنف الخارجيّ (outer class instance) من [[Kotlin/nested classes|الصنف المتداخِل (nested)]]
 *<code>internal</code> لجعل التصريح [[Kotlin/visibility modifiers|مرئيًّا في الوحدة (module) الحاليّة]]
 *<code>lateinit</code> تسمح [[Kotlin/properties|بتهيئة (initializing) الخاصّيّة غير الفارغة (non-null property) خارج الباني (constructor)]]
-*<code>noinline</code> تمنع [[Kotlin/inline functions|التضمين السطريّ (inlining) لتعبير lambda المُمرَّر إلى الدالة (function) السطريّة]]
+*<code>noinline</code> تمنع [[Kotlin/inline functions|التضمين المباشر (inlining) لتعبير lambda المُمرَّر إلى الدالة (function) المباشرة]]
 *<code>open</code> للسماح بإنشاء [[Kotlin/classes|أصناف فرعيّة (subclasses) من الصنف أو إعادة تعريف (override) عنصرٍ منه]]
 *<code>operator</code> لتحديد الدالة [[Kotlin/operator overloading|كتحميلٍ زائدٍ (overloading) للمعامِل أو تعريف استخدام اصطلاحيّ]]
@@ سطر 101: / سطر 101: @@
 *<code>protected</code> لجعل التصريح [[Kotlin/visibility modifiers|مرئيًا في الصنف (class) الحاليّ أو أصنافه الفرعيّة (subclasses)]]
 *<code>public</code> لجعل التصريح [[Kotlin/visibility modifiers|مرئيًا في كلِّ مكان]]
-*<code>reified</code> لجعل [[Kotlin/inline functions|متحوّل النوع للدالة السطريّة (inline function) متاحًا للوصول أثناء التنفيذ (runtime)]]
+*<code>reified</code> لجعل [[Kotlin/inline functions|متحوّل النوع للدالة المباشرة (inline function) متاحًا للوصول أثناء التنفيذ (runtime)]]
 *<code>sealed</code> للتصريح عن [[Kotlin/sealed classes|صنفٍ مغلقٍ ( sealed class) (محدود الأصناف الفرعيّة [subclasses])]]
 *<code>suspend</code> تحديد الدالة (function) أو تعبير lambda [[Kotlin/coroutines|كنوع تأخيرٍ (قابلٍ للاستخدام كروتيناتٍ مساعدة [coroutines])]]