نحو البرمجة بـ Xcode لاتهمل التعليقات !!
ننصحك بجدية ان توثق شفرتك البرمجية، انها استثمار
مستقبلي . فبالاضافة الى ذلك تلعب عملية التوثيق دورها الرئيس لا يمكنك التقليل من قيمة التعليقات، فهيا مفيدة جداً لشرح متى ما قمت بمشاركة شفرتك البرمجية مع مبرمجين آخرين. تداخل خطوات البرنامج بلغة صريحة وواضحة. ان شرح ما تقوم به الشفرة البرمجية يمكن المبرمجين من تحديد الجزء الاولى بالتفحص والمعاينة .
ولعمل ملحوظة أو تعليق ضعها بعد سطرين مائلين .
// This is a
comment
يظهر Xcode التعليقات باللون الاخضر. متى ما كان التعليق طويل ويمتد لاكثر من سطر، ضعه ما بين */ و / *
/* This is a comment extending over two lines */
يجدر بك استخدام التعليقات لشرح الاوامر والتعليمات الاجرائية التي توصف وتشرح البرنامج ، حيث يستحيل بدونها فهم وتفسير دور بعض تلك الاجزاء من البرنامج عند الاعتماد على الشفرة
فقط .
سنتطرق لعمليات تقصي اخطاء البرنامج قريباً، حيث يوفر لك Xcode عدد من الامكانيات الفريدة وان احد الطرق الاقدم في كمثال لبرنامج حسابي يستخدم معامل رياضي مبني من خلال وصف تفصيلي وارد بأحد الكتب يجدر بك التنويه عن ذلك خلال ادراج جزء من الشفرة البرمجية بين تلك الاسطر المائلة حتى الارتباط بتعليقات داخل شفرتك البرمجية. وفي بعض الاحيان يفضل القيام بعمل كتابة التعليقات قبل البدء الفعلي بكتابة
التقصي
يطلق عليها اللاتعليقات outcommenting وذلك من
ترى كيف تعمل بقية اوامر الشفرة .
الشفرة البرمجية. تلك التعليقات تعينك اثناء بناء البرنامج هذا الاسلوب يمكنك من تقصى الاخطاء البرمجية متى ما كان وستكون نتائج المعاينة افضل وايسر.
الجزء المحجوب متسببا في تلك الاخطاء، كأن تحجب قيمة احد المتغيرات، حيث يمكنك حجبها مؤقتاً، ثم اسناد قيمة اختبارية
ان امثلة الكتاب ليست بالضرورة موثقة كما
هي
لتجربة اداء بقية اجزاء الشفرة البرمجية مع تلك القيمة الاختبارية. ذلك انها ترد إليك وهي محاصرة بالشرح والتوضيح .
الحال دائماً،
ص ٢٢