English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية
في هذا المقال، ستتعرف على تعليقات 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! إلى الشاشة
لا يجب أن تُستبدل التعليقات بالتفسيرات السيئة لكود باللغة الإنجليزية. يجب كتابة كود ذي بنية جيدة وقابل للقراءة، ثم استخدام التعليقات.
في معظم الحالات، تستخدم التعليقات لتوضيح 'لماذا' وليس 'كيف'، فقط اتبع هذا المبدأ.