[سجن البرمجة] ستايل البرمجة – كود مرتّب (2)
مدرج تحت قسم: دروس
ترتيب الأداة الشرطية
أهم أشياء يجب الآنتباه لها خلال ترتيب الأداة الشرطية
- التعليق على كل جزء من الأداة لأن الأداة الشرطية هي أكثر أداة تؤخر المبرمجين في تطوير البرنامج لذلك اشرح كل جزء حتى تعرف ما عملها في المستقبل
- المسافات بعد “}” مهمة جداً.
مثال على المسافات
Conditional Statement
{
echo "Out Man ..";
}
ألاحظت المسافة بين echo و أول السطر؟ كذلك هنالك ملاحظة مهمة على ترتيب الجمل الشرطية وهي عدم دمج جملتين في سطر واحد او وضع أكثر من “}” في نفس السطر كالتالي:
Conditional Statement{echo "Out Man ..";}else{echo "do some thing";}
كما ترى الكود السابق سلطة جميلة.
الآن سنستعرض معاً ترتيب بعضاً من أوامر و دوال اللغة.
أولاً – جملة IF
من المفترض أن نشرح عمل هذه الأداة ومن ثم نشرح ماذا تقوم به كالتالي
//What to do ?
if ($_GET['do'] == "show")
{
// Show the program
echo "hi Man .. ";
}
// if $_GET['do'] != show
else
{
// Do this statement
echo "Out Man ..";
} // The End
كما ترى شرحنا ماذا تفعل هذه الدالة ومن ثم علقنا على الكلام. لاحظ هنالك مسافات.
ثانياً – جملة else و elseif
الآن في حالة الجملة الشرطية المتشعبة.
//What to do ?
if ($_GET['do'] == "show")
{
// Show the program
// أكتب برنامجك هنا
}
// else the last statement if the (do)'s = play
elseif ($_GET['do'] == "play")
{
// Play the program
// Play Here
}
//else all that
else
{
// Do this statement
// code Here
}
// The End
ثالثاً – جملة switch
الآن نتطرق لترتيب وتعليق جملة switch الذي تعتبر إحدى الجمل الشرطية.
// Switch the variable $x
switch ($x)
{
// case $x == 1
case 1:
// echo the num 1 .
echo "Number 1";
// Break case 1 .
break;
// case $x == 2
case 2:
// echo the num 2
echo "Number 2";
// Break case 2 .
break;
// the default if none of the last statements right
default:
// echo no num
echo "No number";
}
الشيفرات البرمجية السابقة توضح ما أرمي إليه.
كما لاحظنا:
- تعليق لكل سطر
- مسطرة بين سطر و آخر
ترتيب Functions & Classes
ما فائدة ترتيب Function أو Class؟
الفائدة وبكل بساطة هي تنظيم عمل Class أو Function
فأن ترتيب Class يؤدي لترتيب Functions التي يحتويها هذا الكلاس ومن ثم إفادة في تطوير البرنامج مستقبلياً، و إراحة المطورين لبرنامجك، لأن Class يعتبر لبنة الأساس في البرامج الراقية – وضع خط تحت الراقية -.
كيف يمكنني ترتيب Class أو Function؟
أولاً دعونا نتفق على أن نشرح Class لأنه شامل Functions.
نقوم في بداية Class بشرح عمل هذا الكلاس ومن ثم تفصيل عمل كل Function داخله مع ملاحظة المسافات في حالة “}” كما في حالة “IF”.
مثال:
/*-------------------------------------------------------|
Name : Common
--------------------------------------------|
Describe : including common functions to help me in
the program.
--------------------------------------------|
Author : Dr.Nabhan
--------------------------------------------|
Last Update : 24/9/2005
--------------------------------------------------------*/
Class common
{
# Function : Began head (To began the tag head) #
function head ()
{
echo "";
}
# Function : close head (To close the tag head) #
function head ()
{
echo "";
}
}
كما نرى بدأنا Class بمقدمة بسيطة عن عمله و اسمه، ومن ثم قمنا بتفصيل كل function داخل Class بحيث نصف عمله، ولاحظ المسافات بين كلمة function وبداية السطر وكذلك بين echo وبداية السطر. إنها تريح النظر عندما تفحص كل function، ولا تحتاج لخبراء في تحليل الخطوط و نظارات وتلسكوب كي تحلل هذا function.
