كانت لغة برمجة الكمبيوتر Microsoft Visual Basic شائعة في دوائر البرمجة لسنوات عديدة. يستخدمه المبرمجون لجميع أنواع المشاريع. يتم استخدام متغيرات لغة البرمجة هذه لصفحات الويب ، ويتم استخدام أنواع أخرى من برامج Visual Basic للعديد من تطبيقات Windows التي نستخدمها كل يوم. أحد العناصر الأساسية لـ Visual Basic هو القدرة على تضمين التعليقات ، وهي ملاحظات مضمنة في التعليمات البرمجية ليس لها غرض رمز وظيفي. يستخدم Visual Basic بروتوكول معين لتمييزها عن التعليمات البرمجية. تعد إضافة التعليقات مهمة للغاية في معظم المشاريع لمساعدة مشاهدي الكود البشري على قراءة وحدات الكود بشكل صحيح. إذا كنت بحاجة إلى إضافة تعليقات إلى Visual Basic ، فإليك بعض الخطوات الأساسية للتأكد من قيامك بذلك بشكل صحيح.
خطوات
الخطوة الأولى. حدد نوع التعليق الذي تريد إضافته
للمبرمجين عدة أغراض رئيسية مختلفة للتعليقات التي تحدد الشكل والأسلوب الدقيق لما سيتم تضمينه في التعليق.
- ضع في اعتبارك تعليقات وحدة التعليمات البرمجية. تعليقات الوحدة النمطية هي تعليقات ذات مستوى أعلى تصف عادةً الأغراض العامة لوحدة التعليمات البرمجية ، بالإضافة إلى معلومات أخرى مثل حقوق النشر والتأليف والمزيد.
- تقييم الحاجة إلى تعليقات الإجراءات. يجب أيضًا التعليق على إجراءات التعليمات البرمجية الوظيفية المختلفة. تتعلق التعليقات الإجرائية بالوظائف المحددة للكود ، وتساعد على تنبيه المبرمجين الآخرين حول النتائج الدقيقة للإجراء وفقًا لكيفية كتابته.
الخطوة 2. اختر فئات استخدام مفصلة لتعليقات التعليمات البرمجية الخاصة بك
بعض أنواع التعليقات ، مثل تعليقات الإجراءات ، تأتي أيضًا في أشكال مختلفة. افهم هذه الاستخدامات المختلفة لإضافة الأنواع الصحيحة من التعليقات إلى برنامجك.
- تقييم استخدام تعليقات الغرض للإجراءات. هذه تصف ما يفعله الإجراء.
- ضع في اعتبارك استخدام تعليقات دالة إرجاع القيمة. سيساعد ذلك الآخرين على فهم القيم التي يتم إرجاعها من خلال الإجراء.
- قم بتضمين التعليقات الشرطية. يمكن أن تصف التعليقات الشرطية حالات الخطأ المحتملة ومعالجة الأخطاء ، بالإضافة إلى الشروط التي يجب الوفاء بها حتى تعمل التعليمات البرمجية بشكل صحيح.
الخطوة 3. اختر تنسيقًا للتعليقات
هناك أيضًا مشكلة تتعلق بكيفية إضافة التعليقات إلى سطور معينة من التعليمات البرمجية.
- استخدم التعليقات اليسرى. تبدأ هذه التعليقات على يسار الشاشة وتستمر على طول الخط. بشكل عام ، يحتاج المبرمج إلى إنهاء التعليق بشكل تعسفي بالقرب من الجانب الأيمن من الشاشة ، والنزول إلى سطر جديد ومتابعة التعليق.
- استخدم التعليقات المضمنة. تحتوي التعليقات المضمنة على فاصلة عليا مباشرة بعد جزء من التعليمات البرمجية ويتم وضعها على نفس السطر.
الخطوة 4. استخدم الفاصلة العليا لتحديد بداية تعليقاتك
هذه هي الخطوة الأساسية لكتابة التعليقات فعليًا في الكود. الفاصلة العليا هي بروتوكول نص معين يتعرف عليه مترجم Visual Basic للتعليقات. بدون ذلك ، سيحاول الكمبيوتر قراءة التعليقات كرمز.
