قواعد التسمية

جزء من قسم Fundamentals في رحلة C++ على Coddy — الدرس 12 من 74.

في البرمجة، من المهم اتباع اتفاقيات التسمية للحفاظ على قابلية قراءة التعليمات البرمجية الخاصة بك وسهولة صيانتها. ومع ذلك، هناك بعض القواعد والاتفاقيات التي يجب عليك اتباعها عند تسمية الأشياء في C++:

يمكن أن تحتوي الأسماء على أحرف وأرقام وشرطات سفلية.
يجب أن تبدأ الأسماء بحرف أو بشرطة سفلية.

الأسماء حساسة لحالة الأحرف (myVariable و myvariable مختلفان).
لا يمكن أن تكون الأسماء كلمات محجوزة في لغة C++‎ (مثل int، و float، و if، وما إلى ذلك).

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

camelCase — يتم دمج الكلمات معاً، بحيث تبدأ كل كلمة بعد الكلمة الأولى بحرف كبير (على سبيل المثال، totalAmount، numberOfStudents). تُستخدم عادةً لأسماء المتغيرات والدوال في لغة ++C.
PascalCase — مشابهة لـ camelCase، ولكن الكلمة الأولى تبدأ أيضاً بحرف كبير (على سبيل المثال، TotalAmount، MyClass). تُستخدم عادةً لأسماء الأصناف (classes) في لغة ++C.

snake_case — تكون الكلمات كلها بأحرف صغيرة ويفصل بينها بشرطة سفلية (على سبيل المثال، total_amount، number_of_students). تُستخدم غالباً في لغة C++ لأسماء الملفات أو في لغات أخرى مثل Python.
SCREAMING_SNAKE_CASE — مثل snake_case ولكن بجميع الأحرف الكبيرة (على سبيل المثال، MAX_SIZE، TOTAL_AMOUNT). تُستخدم عادةً للثوابت والماكرو (macros) في لغة C++.

كن وصفياً وتجنب الأسماء القصيرة جداً (على سبيل المثال، numberOfStudents أفضل من n).
تجنب استخدام أسماء متغيرات مكونة من حرف واحد، باستثناء العدادات البسيطة (على سبيل المثال، i، j، k).

إليك بعض الأمثلة على أسماء المتغيرات الجيدة والسيئة:

// جيد
int age = 30;
double totalPrice = 150.99;      // camelCase
int numberOfStudents = 25;       // camelCase
const int MAX_STUDENTS = 100;    // SCREAMING_SNAKE_CASE للثوابت

// سيئ
int a = 30;  // قصير جداً وغير واضح
double TOTAL_PRICE = 150.99;  // الأحرف الكبيرة ليست للمتغيرات العادية
int n = 25;  // قصير جداً وغير واضح

ورقة مرجعية

قواعد التسمية في C++:

يمكن أن تحتوي الأسماء على أحرف، وأرقام، وشرطات سفلية (underscores)
يجب أن تبدأ الأسماء بحرف أو بشرطة سفلية
الأسماء حساسة لحالة الأحرف (myVar ≠ myvar)
لا يمكن أن تكون الأسماء من كلمات C++ المحجوزة (مثل int، float)

اتفاقيات التسمية الشائعة:

camelCase — للمتغيرات والدوال: totalAmount
PascalCase — لأسماء الفئات (classes): MyClass
snake_case — لأسماء الملفات / لغات أخرى: total_amount
SCREAMING_SNAKE_CASE — للثوابت والماكرو: MAX_SIZE
كن وصفياً؛ تجنب الأسماء القصيرة أو غير الواضحة (يفضل numberOfStudents على n)
الأسماء المكونة من حرف واحد مقبولة فقط للعدادات البسيطة (i، j، k)

int age = 30;                    // جيد
double totalPrice = 150.99;      // camelCase
const int MAX_STUDENTS = 100;    // SCREAMING_SNAKE_CASE

int a = 30;                      // سيء: غير واضح
double TOTAL_PRICE = 150.99;     // سيء: أحرف كبيرة لغير الثوابت

جرّب بنفسك

لا يتضمّن هذا الدرس تحدّيًا برمجيًا.