English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

دليل Kotlin الأساسي

تحكم Kotlin

الوظائف في Kotlin

الخطوط في Kotlin

Kotlin موجه الأجراء (OOP)

تعليقات Kotlin

في هذا المقال، ستتعرف على تعليقات Kotlin، ولماذا وكيف تستخدمها.

في البرمجة، التعليقات هي جزء من البرنامج، مصممة لتسهيل فهمك وكودك الآخر من قبل المبرمجين الآخرين. يخطي معالج Kotlin (Kompiler) هذه التعليقات بشكل كامل.

مثل Java، هناك نوعان من التعليقات في Kotlin

  • /* ... */

  • // ....

تعليقات تقليدية / * ... * /

هذا تعليق متعدد الأسطر، يمكنه التخطي عبر الأسطر. سيقوم معالج Kotlin بتخطي جميع المحتويات من /* إلى */.

/* هذا تعليق متعدد الأسطر.
 * يطبع المشكلة "Hello،World!" إلى الصدور القياسية.
 */
fun main(args: Array<String>) {
   println("Hello, World!")
{}

تعليقات تقليدية تستخدم أيضًا لتسجيل كود Kotlin (KDoc) وتبدو بشكل مختلف قليلًا. تعليقات KDoc تبدأ ب / ** وتنتهي ب * /.

تعليقات نهاية السطر //

المعالج سيقوم بتخطي جميع المحتويات من // حتى نهاية السطر . على سبيل المثال،

// برنامج Kotlin Hello World
fun main(args: Array<String>) {
   println("Hello, World!")       // إخراج Hello, World! إلى الشاشة
{}

البرنامج أعلاه يحتوي على تعليقات خطية أربعة:

// برنامج Kotlin Hello World

و

// إخراج Hello, World! إلى الشاشة

استخدام التعليقات بشكل صحيح

لا يجب أن تُستبدل التعليقات بالتفسيرات السيئة لكود باللغة الإنجليزية. يجب كتابة كود ذي بنية جيدة وقابل للقراءة، ثم استخدام التعليقات.

في معظم الحالات، تستخدم التعليقات لتوضيح 'لماذا' وليس 'كيف'، فقط اتبع هذا المبدأ.