10-02-19, 09:28 PM
بسم الله الرحمن الرحيم
نصائح برمجية:
اثناء كتابتك لدالة ما بلغتك البرمجية المفضلة يفضل (لست مجبوراً) ان تأخذ بعض الامور بعين الاعتبار وتقوم بايجاد تسمية مناسبة للدالة:
1- هل الدالة وظيفتها التحويل؟ تحويل رقم الى رقم ثنائي (binary) على سبيل المثال ،في هذه الحالة يفضل ان يسبق اسم الدالة كلمة (To) او (ConvertTo).
PHP كود :
public static string ToBinary(int number) => Convert.ToString(number, 2);
//or
public static string ConvertToBinary(int number) => Convert.ToString(number, 2);
3- هل الدالة وظيفتها التحويل الى الاصل؟ مثلا قمت بتحويل صورة الى مصفوفة من Bytes لخزنها في قاعدة البيانات وتريد ان تعمل دالة لتحويل الـ Bytes وارجاعها الى شكلها الاصلي (الى صورة) في هذه الحالة يفضل ان تستخدم كلمة (From) مع اسم الدالة:
PHP كود :
public static Image FromBytes(byte[] imageBytes) => Image.FromStream(new MemoryStream(imageBytes));
3- هل الدالة وظيفتها جلب معلومات معينة؟ جلب معلومات الموظفين مثلا ،في هذه الحالة يفضل ان يسبق اسم الدالة كلمة تدل على الاسترجاع مثلا (Get).
ادناه مثال يحاكي عملية جلب معلومات الموظفين.
PHP كود :
public static List<Employee> GetAllEmployees() => new List<Employee>()
{
new Employee
{
EmployeeId = 1,
EmployeeName = "Ahmed"
},
new Employee
{
EmployeeId = 2,
EmployeeName = "Mohammed"
}
};
public class Employee
{
public int EmployeeId { get; set; }
public string EmployeeName { get; set; }
}
4- هل الدالة وظيفتها التحقق من امر ما؟ مثال: هل الرقم Armstrong؟ في هذه الحالة يفضل ان يسبق اسم الدالة كلمات دالة على السؤال مثل (Is, Has, ...etc) وان يكون نوع الارجاع قيمة بوليانية.
PHP كود :
public static bool IsArmstrong(int number)
{
var n = number.ToString();
return number == n.Sum(c => Math.Pow(int.Parse((c.ToString())), n.Length));
}
5- هل الدالة وظيفتها العد؟ مثلا ايجاد عدد الارقام الفردية ،في هذه الحالة يفضل ان يسبق اسم الدالة كلمة (Count):
PHP كود :
public static int CountOdds(int[] numbers) => numbers.Count(number => number % 2 != 0);
المزيد من النصائح في مقالات اخرى باذن الله.
تحياتي لكم