منتدى فيجوال بيسك لكل العرب | منتدى المبرمجين العرب
Tips for clean code #2 - نسخة قابلة للطباعة

+- منتدى فيجوال بيسك لكل العرب | منتدى المبرمجين العرب (http://vb4arb.com/vb)
+-- قسم : قسم لغة السي شارب C#.NET (http://vb4arb.com/vb/forumdisplay.php?fid=175)
+--- قسم : قسم مقالات C#.NET (http://vb4arb.com/vb/forumdisplay.php?fid=177)
+--- الموضوع : Tips for clean code #2 (/showthread.php?tid=22631)



Tips for clean code #2 - Sajad - 19-11-17

بسم الله الرحمن الرحيم
(رب اشرح لي صدري ويسر لي امري واحلل عقدة من لساني يفقهوا قولي)




نستكمل في هذا الدرس بذكر بعض النصائح والارشادات لكتابة كود واضح ومفهوم


1- عدم استخدام اسماء مختصر للمعرّفات كأسماء (الكلاسات، الدوال، المتغيرات ....الخ)

PHP كود :
exAdd2Num()// Bad --> AddTwoNumber() // Ok
exnum1num2 // Bad --> firstNumber, secondNumber //Ok
exfName // Bad --> firstName // Ok 



2- يفضل ان يكون تعريف الدالة بصيغة الفعل:
PHP كود :
exAllEmployees() //Bad --> GetAllEmployees() // Ok 



3- عند المقارنة بين كلمتين قم باستخدام دوال جاهزة تؤدي هذا الغرض بدلا من استخدام معامل المقارنة (==):
PHP كود :
string name "Ahmed";
if(
name.Equals"AHMED"StringComparison.OrdinalIgnoreCase))
{
Console.WriteLine("Ok");




4- لا يفضل استخدام Hungarian notation في تعريف المتغيرات، ويقصد بها استخدام اول حرفين أو ثلاث للدلالة على نوع المتغير:
PHP كود :
exstring strNameText txtName //Bad don't use prefix 



5- عند تعريف دوال او متغيرات من نوع Boolean يفضل ان يكون بصيغة السؤال:
PHP كود :
exisValidhasHighScore 



6- لا تعمل مقارنة لمتغير او دالة من نوع Boolean مع True or False لانه بالنتيجة ناتج العملية هي إما True or False:
PHP كود :
ex: if (isValid == true// Bad --> if (isValid) //Ok 




والحمد لله رب العالمين



RE: Tips for clean code #2 - قاسم - 21-11-17

شكر لك
الله يبارك فيك