منتدى فيجوال بيسك لكل العرب | منتدى المبرمجين العرب

نسخة كاملة : Tips for clean code #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 
 



تحياتي لكم
السلام عليكم
شكرا على هذا التوضيح
الله يجعل كل حرف كتبته في ميزان حسناتك
(05-11-17, 10:32 PM)Sajad كتب : [ -> ]
بسم الله الرحمن الرحيم
(رب اشرح لي صدري ويسر لي امري واحلل عقدة  من لساني يفقهوا قولي)

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

النقطة الاولى في اغلب لغات البرمجة هنالك نمط محدد لكتابة أسماء الدوال او الكلاسات الجاهزة وحتى الـ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 
 



تحياتي لكم

شكرا لك
كنت احتاج هذه النصيحة
ربنا يبارك لك