المواصفات القياسية للكود

جزاك الله خيرا , فان عملية كتابة الأكواد بالشكل الصحيح هى بداية نجاح العمل الجماعي.

انا لا أعمل لدى مؤسسه , لكن حبيت أضيف.

عموما انا قرات ان اسماء الـ المتغيرات تبدأ هكذا مثلا ( أول حرف في أول كلمه يكون صغير وأول حروف الكلمات التاليه تكون كبيره ::

string myOwnVariable;

واسماء الدوال تبدأ هكذا مثلا مع مراعاة كتابة حروف أول الكلمات كلها كبيره ::

void MyMethodName()
{
Body;
}

واذا كان لديك Properties , فيفضل ان تكتب اسم الـ Field مثلا هكذا بجعل أول حرف منه بشكل صغير وتجعله Private ::

private string name;

وتكتب الـ Property بتاعته مثلا هكذا مع جعل أول حرف فيها كبير ::

public string Name
{
get{ return name; }
set{ name = value; }
}

بالضبط كما قال معتز

استخدام ال_ Underscore في اسماء الvariables في البرمجة غير مستحب في اغلب الnotations عدا الhangarian الذي يضع اول حرف يدل على نوع المتغير و _ ثم اسم المتغير مثل m_myObjct و الm تعني member of a class يعني object او i_age و تعني ان age من نوع Integer

و لكن عامة في ال java مثلا لا تستخدم ال_ ابدا في اسماء الvariables او الfunctions

فالnotation الاساسي هو ان يكتب المتغير اذا كان من كلمة واحدة كله small letters و اذا كان يتكون من اكثر من مقطع يكون بداية كل مقطع عدى الاول captical مثال

name متغير من مقطع واحد

firstName متغير من مقطعين

و كذلك في اسماء الfunctions

getNameو setFirstName

اما الclasses فيجب ان تبدا بحرف Capital

مثل class Person

Person person = new Person()

اما في ال#C فهناك اختلاف بسيط

في اسماء الfunctions و الproperties فان الحرف الاول دائما capital

فاذا كان اسم المتغير الprivate داخل الclass مثلا name فان الaccessor او الproperty الخاصة به تكون Name

و لكن اي function يجب ان تبدأ ب Capital مثل Console.WriteLine و ايضا اسماء الclasses

اما فصل اسماء الvariables باستخدام ال_ لا يستخدم الا في الDatabase Notation مثل

First_Name او Last_Name او Birth_Date و استخدام الحرف الول Capital او Small ليس ضروريا و لكن في الDBMS التي تتبع الCase Sensitive يجب الحذر لان First_Name لا تكافئ first_name

مثلا موقع مثل phpfreaks يقدم دروس فى المعايير php coding standards

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

فى البيشو لا تستخدم الشارب للتعليق #

إنما نستخدم السلاش سلاش //

:)

الأخوة معتز شمس وبشمهندس، أنا لم أقصد أن أعطي طريقة صحيحة لكتابة الأكواد، حيث أن أي طريقة هي مقبولة طالما أنها موحدة بين فريق العمل في المؤسسة، وطبعاً يفضل أن تكون موحدة نوعاً ما مع المعايير العالمية، وذلك لأنه لايوجد معيار عالمي واحد.