قواعد التسمية
جزء من قسم Fundamentals في رحلة C# على Coddy — الدرس 12 من 69.
اصطلاحات التسمية تشبه قواعد الطريق للمبرمجين. فهي تساعد في الحفاظ على الكود منظماً ومفهوماً.
تخيل لو كانت لافتات الشوارع عشوائية وغير متسقة - ستعم الفوضى! وبالمثل، بدون اتفاقيات التسمية، يمكن أن تصبح التعليمات البرمجية فوضوية ومربكة.
في لغة C#، يعد اتباع اتفاقيات تسمية متسقة أمراً بالغ الأهمية لكتابة كود نظيف، وقابل للصيانة، وتشاركي. إليك بعض الاتفاقيات الرئيسية التي يجب وضعها في الاعتبار:
- PascalCase: يُستخدم لأسماء الفئات (class names)، وأسماء الدوال (method names)، وأسماء الخصائص (property names). تبدأ كل كلمة بحرف كبير، على سبيل المثال:
MyClass،CalculateTotal،FirstName.
- camelCase: تُستخدم للمتغيرات المحلية ومعاملات الدوال (method parameters). تبدأ الكلمة الأولى بحرف صغير، وكل كلمة تالية تبدأ بحرف كبير، على سبيل المثال:
myVariable،customerName،calculateTotal.
- _underscorePrefix: يُستخدم للحقول الخاصة (المتغيرات داخل الفئة). ابدأ بشرطة سفلية متبوعة بتنسيق camelCase، على سبيل المثال:
_myPrivateField،_customerAge.
- UPPER_CASE: تُستخدم للثوابت. جميع الحروف كبيرة، والكلمات مفصولة بشرطات سفلية، على سبيل المثال،
MAX_VALUE،PI،DEFAULT_TIMEOUT.
إليك بعض النصائح الإضافية:
- استخدم أسماءً وصفية تشير بوضوح إلى الغرض من المتغير أو الطريقة (method).
- تجنب الاختصارات أو الأوائلية ما لم تكن مفهومة على نطاق واسع في سياق الكود الخاص بك.
- كن متسقاً مع الاصطلاحات التي اخترتها طوال مشروعك.
ورقة مرجعية
تساعد اصطلاحات التسمية في C# على إبقاء الكود منظماً وقابلاً للصيانة:
- PascalCase: لأسماء الفئات (classes)، وأسماء الدوال (methods)، وأسماء الخصائص (properties)
MyClass, CalculateTotal, FirstName - camelCase: للمتغيرات المحلية ومعاملات الدوال (parameters)
myVariable, customerName, calculateTotal - _underscorePrefix: للحقول الخاصة (private fields) (شرطة سفلية + camelCase)
_myPrivateField, _customerAge - UPPER_CASE: للثوابت (أحرف كبيرة مع شرطات سفلية)
MAX_VALUE, PI, DEFAULT_TIMEOUT
نصائح إضافية:
- استخدم أسماء وصفية تشير بوضوح إلى الغرض
- تجنب الاختصارات إلا إذا كانت مفهومة على نطاق واسع
- كن متسقاً في جميع أنحاء مشروعك
جرّب بنفسك
لا يتضمّن هذا الدرس تحدّيًا برمجيًا.
يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.
جميع دروس Fundamentals
4المعاملات - الجزء الأول
المعاملات الحسابيةمعامل باقي القسمةالزيادة والنقصانالزيادة والنقصان اللاحقاختصارات العمليات الحسابية7أساسيات الإدخال والإخراج (Basic IO)
الإخراج الأساسيتضمين النصوص (String Interpolation)قراءة المدخلاتالتحليل (Parse)مراجعة - حتى 120مراجعة - True أو False5المعاملات - الجزء الثاني
معاملات المقارنةالمعاملات المنطقية - الجزء الأولالمعاملات المنطقية - الجزء الثانيمراجعة - المنطق البسيطالمعاملات المنطقية - الجزء الثالث