عرض مشاركة واحدة
عضو نشيط
تاريخ التسجيل: Mar 2005-
#6 (permalink)  
[سجن البرمجة] ستايل البرمجة - كود مرتّب (2)

ترتيب الأداة الشرطية تابع ترتيب الكود

أهم أشياء يجب الآنتباه لها خلال ترتيب الأداة الشرطية
1- التعليق على كل جزء من الأداة لأن الأداة الشرطية هي أكثر أداة تؤخر المبرمجين
في تطوير البرنامج لذلك اشرح كل جزء حتى تعرف ما عملها في المستقبل
2- المسافات بعد } مهمة جداً جداً ..
مثال على المسافات
كود PHP:
Conditional Statement
{
    echo 
"Out Man ..";

ألاحظت المسافة بين echo و أول السطر .. !؟؟
كذلك هنالك ملاحظة مهمة على ترتيب الجمل الشرطية
عدم دمج جملتين في سطر واحد

او وضع أكثر من } في نفس السطر كالتالي .. :
كود PHP:
Conditional Statement{echo "Out Man ..";}else{
echo 
"do some thing";} 
كما ترى الكود السابق سلطة جميلة ..
الآن سنستعرض معاً ترتيب بعضاً من أوامر و دوال اللغة ..
أولاًً - جملة IF :
من المفترض أن نشرح عمل هذه الأداة ومن ثم نشرح ماذا تقوم به كالتالي
كود PHP:
//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 :
الآن في حالة الجملة الشرطية المتشعبة ..
كود PHP:
//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 الذي تعتبر إحدى الجمل الشرطية طبعاًً
كود PHP:
// 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)
مثال :
كود PHP:
/*-------------------------------------------------------|
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 داخل الكلاس بحيث نصف عمله
ولاحظ المسافات بين كلمة function وبداية السطر .. وكذلك بين echo وبداية السطر
إنها تريح النظر عندما تفحص كل فانكشن.
ولا تحتاج لخبراء في تحليل الخطوط و نظارات وتلسكوب كي تحلل هذا الفانكشن .

انتهى قسم ترتيب الكود : تابع لكود مرتب
الآن قسم برنامج مترب
في الرد التالي

تاريخ الكتابة :
15 أغسطس 2006






__________________
حينما يموت الحل ... يولد الإبداع
شباب القمر
سجن البرمجة
أحد مستخدمي : MySmartBB
Dr.Nabhan غير متواجد حالياً   قديم 07-01-2008, 11:17 AM
رد مع اقتباس