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

نسخة كاملة : Tips for clean code #3
أنت حالياً تتصفح نسخة خفيفة من المنتدى . مشاهدة نسخة كاملة مع جميع الأشكال الجمالية .
بسم الله الرحمن الرحيم

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






بعض النصائح الاضافية لكود واضح ومفهوم الجزء الثالث

تجدون الجزء الاول والثاني في الروابط ادناه:
Tips for clean code #1
Tips for clean code #2


1- في الدوال التي فيها اكثر من احتمال لاسترجاعها تجنب استخدام Multi return وبدلا من ذلك استخدم متغير لخزن واسترجاع القيمة:

PHP كود :
static string EvenOdd(int value)
{
if (
value == 0)
{
return 
"Even";
}
else if (
value == 1)
{
return 
"Odd";
}
else
return 
"Error";
}
// Bad

static string EvenOdd(int value)
{
string result;
if (
value == 0)
{
result "Even";
}
else if (
value == 1)
{
result "Odd";
}
else
{
result "Error";
}

return 
result;
}
// Ok 


2- استخدام (_) under score كبادئة للــ private fields الخاص بالـclass:
PHP كود :
private int age//Bad
private int _age//Ok 


3- تجنب استخدام in-line string literals

بدلا من ذلك احفظ النص في الـ resources او في الـ AppConfig او اجلعه Const مثل نص الاتصال بقاعدة البيانات أو مسار لموقع معين.


4-تجنب العدد الكبير من الباراميترات في الدالة>


5-  اكتب دالة تقوم بمهمة واحدة فقط.


6- قم بجعل المتغيرات Capital-Case في حال قمت بتعريفها كـ Constant Variable:
PHP كود :
const double PI=3.14


7- تجنب استخدام التعابير المقعدة داخل جملة الـif:
PHP كود :
int value 10;
if (
value && value == 0//Bad
{
Console.WriteLine($"{value} is Even number");
}

int value 10;
bool isEven value == 0;
bool isPositive value 0;
if (
isPositive && isEven// Ok
{
Console.WriteLine($"{value} is Even number");




والحمد لله رب العالمين
تسلم يدك
الله يعطيك العافية

السلام عليكم

اخي / Sajad

هل يمكن ان تضع  لنا    مقال عن كيف نسمي  باقي المتغيرات والفاكنشات  والااجرائات   الطريقة التي يستخدمها المحترفين  او الطريقة التي تستخدمها انت.

لا اقصد  الشروط   ان لا يبدا ب رقم   ان لا يحتوي على رموز  لا 

اقصد  البادئة   التي ترمز للنوع    مثل   الذي وضحتها  انت  في المتغير  int


كود :
private int age; //Bad
private int _age; //Ok
وعليكم السلام اخي العزيز

كل هذه الامور أوضحتها في الاجزاء الثلاث من الـTips for clean code

أما ما ذكرته انت بخصوص "اقصد البادئة التي ترمز للنوع مثل الذي وضحتها انت في المتغير int "

المقصود هنا أنه هنالك اختلاف بين الـ private fields and properties
فالـ properties تكون public ولا يسبق بـ (_) أما الـ private fields فيسبق بـ (_) لتمييزها عن الـ properties


تحياتي لكم
(22-11-17, 10:18 PM)Sajad كتب : [ -> ]وعليكم السلام اخي العزيز

كل هذه الامور أوضحتها في الاجزاء الثلاث من الـTips for clean code

أما ما ذكرته انت بخصوص "اقصد  البادئة   التي ترمز للنوع    مثل   الذي وضحتها  انت  في المتغير  int "

المقصود هنا أنه هنالك اختلاف بين الـ private fields and properties
فالـ properties تكون public ولا يسبق بـ (_) أما الـ private fields فيسبق بـ (_) لتمييزها عن الـ properties


تحياتي لكم
الله يبارك فيك
ويجزيك الف حسن على كل حرف وعن كل ثانية قضيتها في افادتنا


شكرا ايها المبدع

تم التقييم +1