المعايير القياسية لكتابة الشفرة المصدرية
هذا الكتيب يتناول أهم معايير مكتبة 88/ع0 لكتابة الشيفرة المصدرية لذلك هو موجه بالدرجة
الأولي لجميع مبرمجين لغة مام . نحن هنا لن نتطرق لمكتبة 08/88 بشكل مفصل وإنما نتعرف
فقط على أهم معاييرها في كتابة الشيفرة . ولمن يرغب بالاطلاع على المزيد حول مكتبة مع
يمكن زيارة موقعها الرسمي على الرابط التلي 066.م11م.+:068//:م14
ما هي مكتبة ممعم ؟
إن كلمة عم هي اختصار للعبارة لمتزووم8 صمتاقتاط0م 200 صمأكمع رع مبرم
مخزن ملاحق وت 0١م‏ . وبعبارة أخرى ؛ نظام توزيع وإطار عمل لمكونات م«ام التي يمكن
الشيفرة أكثر سهولة في 0م . توفر هذه المكتبة وحدات نمطية (00000165) مفتوحة المصدر تقوم
حقوق لطبع :
جميع حقوق الطبع محفوظة للمؤلف ( ماجد سليمان المليحاني ) . لقد تم نشر هذا الكتيب
بشكل مجاني بصورته الرقمية فقط . ويحق لمن يريد إعادة نشره مجاناً بنفس الصورة الرقمية ذلك
دون إذن مسبق من المؤلف . ويجوز عند الطلب استخدام هذا الكتيب مجاناً لغير الأغراض التجارية.
| فتطوية 113

المعايير القياسية لكتابة الشفرة لمصدرية
محتويات الكتيب :
بإذن الله تعالي سوف نتطرق إلى أهم معايير مكتبة »6م في كتابة الشيفرة المصدرية المتمثلة فيما
بلي :
» الإزاحة وطول السطر - لمعا 08نا 2008 1008601108
« بنى التحكم - 50000610165 6001701
استدعاء الدوال - 68115 01026000
« تعريف الدوال - 061011005 0021100
تعريف الفئات (الأصناف) - 06601005 1355
« المصفوفات - 85م
تضمين الكود من ملف خارجي - 6006 102100108
* وسم بي اتش بي - 7385 6006 1108م
سوف نقوم ببعض الممارسات والتدريبات على كتابة شيفرة قياسية مثالية . ويجب التنبيه على أن
الشيفرات المذكورة في هذا الكتيب إنما هي للتوضيح تقط وليس لها أي استخدام برمجي فلا ترهق
نفسك في محاولة فهم الشيفرة حرفيا وإنما ركز على فكرة الشيفرة بشكل عام.

. ثري العربية.
4 دبليو ثري العرب المعايير القياسية لكتابة الشقرة لمصدرية
100801105 200 ‏الإزاحة وطول السطر - دوعا عدنا‎ .١
يقصد بالإزاحة الفراغ في بداية السطر البرمجي ؛ ويقصد بطول السطر عدد الأحرف
يخص الإزاحة وطول السطر هي كتالي :
- يجب أن تكون الإزاحة بمقدار أربع أحرف (فراغات) بدون استخدام الزر م78 .
- يجب أن يكون طول السطر البرمجي بين 49-18 حرف.
مثال لاختصار طول السطر :
طول هذه السطر البرمجي أكثر من ‎١7١‏ حرف
يمكن اختصاره بالشكل لتالي :
) لقعم - توفي , ممفمعوة عو ,مهم فقا
,لفقم و3) ممستةه_ عو
(ل1او536) معستو_ عدو
حيث قمنا بوضع عناصر المصفوفة على عدة اسطر مع إزاحتها إلى الداخل بمقدار أربع أحرف
وقوس نهاية المصفوفة في سطر مستقل بدون إزاحة. وهذا يجعل من الشيفرة أكثر قابلية للقراءة .

المعايير القياسية لكتابة الشفرة لمصدرية
؟". بنى لتحكم - 50102610165 001701
وتشمل كل من 50017 ,0/116 ,103 ,)ا وغيرها من بنى التحكم.
وهذا مثال لعبارة )ا لأنها الأكثر تعقيدا بينهم :
يجب أن يكون هناك فراغ واحد (بمقدار حرف واحد فقط) يفصل بين عبارة التحكم وقوس
اية جملة التحكم ولك للتفريق بنها وبين استدعاء الدوال وكذلك فراغ واحد بين علامات
المقارنة والشروط . مثل :
- يفضل دائما استخدام الأقواس المتعرجة ( ) حتى في الحالات التي يمكن الاستغناء عنها أو
التي يكون استخدامها اختياري . فاستخدامها يزيد من قابلة قراءة الشيفرة ويقلل من حدوث
الأخطاء المنطقية عند إضافة سطر لجملة التحكم.
تكتب عبارة التحكم في سطر لوحدها وينتهي السطر بعد قوس بداية التعليمة . مثال :
< يجب إزاحة الشيفرة داخل أقواس التعليمة ( ) بمقدار أربع أحرف . ويجب كتابة قوس نهاية
التعليمة في سطر مستقل. مثل :
| فتطوبة 1/9

المعايير القياسية لكتابة الشفرة المصدرية
ب أن تستخدم العلامات .88 و || بدلا من كلماتها 0ل0م و 08
ع .ع3 مص | فتطوي 103

اح يه ل جالعسية المعيير القياسية لكتابة الشفرة المصدرية
؟. استدعاء الدوال - كال ص«متتعصنرع
- يجب استدعاء الدالة بدون فراغ بين أسم_الدالة وقوس البداية. مثال :
- عند كتابة معطيات ( باراميترات ) الدالة يجب الفصل بينها بفراغ واحد فقط ويجب أن يكون
هذا الفراغ بعد الفاصلة وليس قبلها. مثل :
- لا يجب أن يكون هناك فراغ بين أول معطى وبين قوس بداية الدالة وكذلك بين آخر معطى
وقوس نهاية الدالة. مثال لدالة مثالية :
- يجب أن تعيد الدالة قيمة باستخدام التعليمة ورنةع+ .
- إزاحة علامة المساواة عندما يكون هناك متغير ذو اسم قصير وآخر ذو اسم طويل وا
لزيادة قابلية قراءة الكود . مثال :
+ لعوط) #صمطوي
تلطع تعة”_81009

اح دبليوثري العربية المعايير القياسية لكتابة الشفرة لمصدرية.
- ويمكن كسر قاعدة إزاحة علامة المساواة إذا كان أحد المتغيرات طويل جدا. مثال :
- ولزيادة قابلية قراءة الشيفرة عند استدعاء الدوال يمكن عمل إزاحة لمعطيات الدالة كما في
المثال التلي :
* اوعتط ا 2 ععع عسوعمم ‎١‏ ) لممقتاء هن
- من المستحيل أحيانا أن يكون طول السطر البرمجي للدالة بين 1/5 - 45 حرف وخصوصا
في حالة وجود معطيات كثيرة للدالة لذلك يمكن وضع المعطيات في أكثر من سطر كما بلي :
- علامة المساواة (. ‎ <‏ ) : يمكن تقسيم علامة المساواة على عدة اسطر إذا تجاوزت
المعاملات الحد المسموح به لطول السطر البرمجي ويجب أن تكون علامة المساواة في
السطر التالي مع إزاحة بمقدار أربع فراغات. مثل :

اح يع بعس المعايير القياسية لكتابة الشفرة لمصدرية.
؛. تعريف لدول - كصمتاتمتا 0 صوناعصاع
- يجب أن يكون قوس بداية الدالة وقوس نهاية الدالة في سطر لوحده ويجب إزاحة الشيفرة
بداخل أقواس الدالة بمقدار أربع فراغات. مثل :
- يجب أن تعيد الدالة قيمة باستخدام التعليمة 8801م .
- المعطيات (الباراميترات) التي تكون لها قيم افتراضية تكون في آخر قائمة المعطيات. مثال :
- قوعةة توعد
- مثل لدالة قياسية :
بلم 59 معناوع
- مثل لدالة قياسية أخرى :

المعايير القياسية لكتابة الشفرة المصدرية
بعتض معنطوع
- في حالة وجود معطيات كثيرة للدالة وتجاوزت الدالة الحد المسموح به في السطر البرمجي
يمكن وضع المعطيات في أكثر من سطر. حيث يمكن وضع بعض المعطيات في نفس السطر
مع اسم الدالة إذا كان هناك مساحة كافية والباقي في الأسطر التالية مع عمل إزاحة بمقدار
أربع فراغات. كما يجب وضع قوس نهاية معطيات الدالة وقوس بداية الدالة في سطر جديد
مثال :