التنبيهات التالية ظهرت :
Warning [2] count(): Parameter must be an array or an object that implements Countable - Line: 864 - File: showthread.php PHP 7.4.33 (Linux)
File Line Function
/showthread.php 864 errorHandler->error



تقييم الموضوع :
  • 0 أصوات - بمعدل 0
  • 1
  • 2
  • 3
  • 4
  • 5
Tips for clean code #1
#1
بسم الله الرحمن الرحيم
(رب اشرح لي صدري ويسر لي امري واحلل عقدة  من لساني يفقهوا قولي)

 
أحبيت أن اوضح أمرا مهما لكل مبرمج مبتدئ أو حتى فوق المتوسط يجب أن ياخذها بنظر الاعتبار ألا وهي تنظيم الكود البرمجي
الذي تكتبه وهنا أقصد من خلال كتابة المتغيرات، الكلاسات، الدوال ….الخ

النقطة الاولى في اغلب لغات البرمجة هنالك نمط محدد لكتابة أسماء الدوال او الكلاسات الجاهزة وحتى الـProperties
مثلا لغة C#.NET يستخدم نمط Pascal-Case بينما لغة Java يستخدم نمط Camel-Case.
لنقم بتوضيح هذه المصطلحات:

Pascal-Case: في هذا النمط يتم كتابة المعرفات بحرف كبير بما في ذلك المعرفات المركبة.



كود :
ex: FirstName, Age, WriteLine() ....etc.

 
Camel-Case: في هذا النمط يتم كتابة المعرفات بحرف صغير، أما المعرفات المركبة تبدأ بحرف صغير للكلمة الاولى وحرف كبير للكلمات التي تليها.



كود :
ex: firstName, age, getText() .....etc.

 
وكمبرمج يفضل لك ان تختار النمط الذي تريده او حتى تختار نمطك الخاص، مثال على ذلك من الممكن ان تجعل أول حرف من المتغير اول حرف من اسمك او من الممكن ان تفصل الاسماء بفاصلة _ under score.
النقطة الثانية: وضوح اسماء الـ Identifiers المعرفات من (متغيرات، اسماء دوال، اسماء كلاسات … الخ).

مثال/ لو اردنا جمع عددين فيفضل تسمية المتغيرات بتسميات ذات معنى بالشكل التالي:



كود :
firstNum, secondNum

ولا يفضل تسمية المتغيرات بهذا الشكل:


كود :
x, y

 
أما بالنسبة لاسماء الدوال انظر الى الامثلة التالية:


كود :
Add2Num not just Add

كود :
PrintEmployeeInfo not just Print ... etc

بمعنى اخر يفضل أن تختار اسماء دالة على المحتوى.
 
النقطة الثالثة: واكثرنا نهملها ألا وهي التعليقات الـ Comments و التعليقات مهمة جدا خصوصا اذا كان المشروع يتكون من مئات او حتى الاف الاسطر البرمجية بحيث تكون هنالك سهولة في مراجعة الكود وتعديلها لانه مهمة كل كود سواء كانت دالة كلاس متغير كلها تكون واضحة من خلال الـComments.


PHP كود :
const int level 100;// The level mark is constant to 100 can't be changed
const decimal turnaround 45.67  // The turnaround is constant and can't be placed more 
 



تحياتي لكم
الرد }}}
تم الشكر بواسطة: sendbad100 , قاسم , قاسم , محمد كريّم


الردود في هذا الموضوع
Tips for clean code #1 - بواسطة Sajad - 05-11-17, 10:32 PM
RE: Tips for clean code #1 - بواسطة sendbad100 - 06-11-17, 02:20 AM
RE: Tips for clean code #1 - بواسطة قاسم - 06-11-17, 03:07 AM

المواضيع المحتمل أن تكون متشابهة .
الموضوع : الكاتب الردود : المشاهدات : آخر رد
  Perfect Code 1 Sajad 3 4,156 18-03-21, 12:39 AM
آخر رد: bfdnfh
  Dapper Code Builder Sample khodor1985 3 3,986 18-03-21, 12:39 AM
آخر رد: bfdnfh
  Perfect Code 2 Sajad 2 2,423 11-02-19, 04:26 AM
آخر رد: حريف برمجة
  Tips for clean code #3 Sajad 3 2,635 25-11-17, 12:35 AM
آخر رد: قاسم
  Tips for clean code #2 Sajad 2 2,230 21-11-17, 05:42 PM
آخر رد: قاسم
  Entity Framework Code First Abu Ehab 1 2,515 10-06-17, 03:39 PM
آخر رد: sendbad100
  Tips and tricks - مقدمة RaggiTech 1 2,263 14-10-12, 03:06 PM
آخر رد: RaggiTech
  Tips and Tricks : الفرق بين const و static readonly RaggiTech 0 3,249 14-10-12, 03:05 PM
آخر رد: RaggiTech
  Tips and tricks - رقم 2 - المعامل Equals والمعامل Clone RaggiTech 1 2,529 01-10-12, 07:43 PM
آخر رد: RaggiTech
  Tips and tricks - رقم 1 - StringBuilder RaggiTech 0 2,249 01-10-12, 07:39 PM
آخر رد: RaggiTech

التنقل السريع :


يقوم بقرائة الموضوع: بالاضافة الى ( 1 ) ضيف كريم