الإرجاع المبكر

جزء من قسم Logic & Flow في رحلة C# على Coddy — الدرس 18 من 66.

تُعد العودة المبكرة (Early returns) تقنية نخرج من خلالها من الدالة بمجرد حصولنا على النتيجة أو مواجهة حالة غير صالحة، بدلاً من استخدام الشروط المتداخلة.

لنقارن بين نهجين للتحقق من صحة اسم المستخدم:

بدون عمليات العودة المبكرة (الشروط المتداخلة):

public bool ValidateUsername(string username)
{
    bool isValid = false;
    
    if (username != null)
    {
        if (username.Length >= 3)
        {
            if (username.Length <= 20)
            {
                isValid = true;
            }
        }
    }
    
    return isValid;
}

مع عمليات الإرجاع المبكر (Early Returns):

public bool ValidateUsername(string username)
{
    // إرجاع مبكر إذا كان اسم المستخدم فارغاً (null)
    if (username == null)
        return false;
        
    // إرجاع مبكر إذا كان اسم المستخدم قصيراً جداً
    if (username.Length < 3)
        return false;
        
    // إرجاع مبكر إذا كان اسم المستخدم طويلاً جداً
    if (username.Length > 20)
        return false;
        
    // إذا وصلنا إلى هنا، فإن اسم المستخدم صالح
    return true;
}

تجعل العودة المبكرة الكود أكثر قابلية للقراءة وتقلل من مستويات الإزاحة.

التحدي

سهل

اكتب طريقة (method) تسمى ProcessPayment تحدد ما إذا كان من الممكن معالجة الدفع بناءً على:

يجب أن يكون مبلغ الدفع موجباً
يجب أن يكون رصيد الحساب كافياً
يجب ألا يكون الحساب مغلقاً

استخدم عمليات الإرجاع المبكر (early returns) للتحقق من كل شرط وإرجاع رسائل الخطأ المناسبة.

يجب أن تقوم الطريقة بـ:

تأخذ ثلاثة معاملات (parameters): decimal paymentAmount، و decimal accountBalance، و bool isAccountLocked
ترجع سلسلة نصية (string) تحتوي إما على "Payment processed successfully" أو رسالة خطأ
تستخدم عمليات الإرجاع المبكر للتحقق من الصحة

اطبع رسائل الخطأ بهذه التنسيقات تماماً:

"Error: Payment amount must be positive"
"Error: Insufficient funds"
"Error: Account is locked"

ورقة مرجعية

تخرج العودة المبكرة (Early returns) من الطريقة (method) فور استيفاء شرط معين، مما يتجنب الشروط المتداخلة ويقلل من مستويات الإزاحة (indentation).

بدون العودة المبكرة (الشروط المتداخلة):

public bool ValidateUsername(string username)
{
    bool isValid = false;
    
    if (username != null)
    {
        if (username.Length >= 3)
        {
            if (username.Length <= 20)
            {
                isValid = true;
            }
        }
    }
    
    return isValid;
}

مع العودة المبكرة:

public bool ValidateUsername(string username)
{
    // Return early if username is null
    if (username == null)
        return false;
        
    // Return early if username is too short
    if (username.Length < 3)
        return false;
        
    // Return early if username is too long
    if (username.Length > 20)
        return false;
        
    // If we get here, username is valid
    return true;
}

تجعل العودة المبكرة الكود أكثر قابلية للقراءة وتقلل من مستويات الإزاحة.

جرّب بنفسك

using System;

public class Program
{
    public static string ProcessPayment(decimal paymentAmount, decimal accountBalance, bool isAccountLocked)
    {
        // اكتب كودك هنا
    }
    
    public static void Main(string[] args)
    {
        decimal paymentAmount = decimal.Parse(Console.ReadLine());
        decimal accountBalance = decimal.Parse(Console.ReadLine());
        bool isAccountLocked = bool.Parse(Console.ReadLine());
        
        string result = ProcessPayment(paymentAmount, accountBalance, isAccountLocked);
        Console.WriteLine(result);
    }
}