‫تغییر در رفتار متد Reverse بر روی آرایه‌ها در C# 14

• یک دنباله جدید (sequence) معکوس‌شده از آرایه اصلی برمی‌گرداند.
• آرایه اصلی (x) بدون تغییر باقی می‌ماند (هیچ جهشی/تغییری یا mutation رخ نمی‌دهد).
• نوع بازگشتی، IEnumerable است که می‌توانید آن را به متغیر دیگری اختصاص دهید یا در حلقه‌ها استفاده کنید.

int[] x = new[] { 1, 2, 3 };
var y = x.Reverse(); // y حالا {3, 2, 1} است، اما x همچنان {1, 2, 3} باقی می‌ماند.
foreach (var item in y)
{
    Console.WriteLine(item); // خروجی: 3, 2, 1
}

• بهبودهای span در C# 14: C# 14 قوانین جدیدی برای تبدیل‌های built-in span و استنباط نوع (type inference) معرفی کرده است. این قوانین باعث می‌شوند که overloadهای مبتنی بر Span یا ReadOnlySpan در سناریوهای بیشتری قابل اعمال باشند. در نتیجه، کامپایلر Span را به عنوان یک گزینه خاص‌تر (more specific) نسبت به IEnumerable انتخاب می‌کند.
• تفاوت در رفتار: متد MemoryExtensions.Reverse آرایه را درجا (in-place) معکوس می‌کند و هیچ مقداری برنمی‌گرداند (نوع بازگشتی void است). این یعنی:
• آرایه اصلی (x) تغییر می‌کند (mutated می‌شود).
• اگر سعی کنید نتیجه را به یک متغیر اختصاص دهید (مثل var y = x.Reverse();)، y همیشه null خواهد بود، زیرا متد چیزی برنمی‌گرداند. این می‌تواند منجر به خطاهای کامپایل یا runtime شود.

int[] x = new[] { 1, 2, 3 };
var y = x.Reverse(); // حالا کامپایلر MemoryExtensions.Reverse را انتخاب می‌کند. y null است و x به {3, 2, 1} تغییر کرده است.
foreach (var item in x)
{
    Console.WriteLine(item); // خروجی: 3, 2, 1 (آرایه اصلی تغییر کرده!)
}

• در گذشته، extension methodهای span نمی‌توانستند مستقیماً بر روی آرایه‌ها اعمال شوند.
• حالا، با قوانین جدید، spanها در اولویت قرار می‌گیرند، که می‌تواند منجر به انتخاب متدهای ناخواسته شود.

• خطاهای کامپایل: اگر نتیجه Reverse را به متغیری اختصاص دهید، کامپایلر ممکن است خطا دهد زیرا نوع بازگشتی void است.
• تغییرات runtime: کد ممکن است اجرا شود، اما آرایه اصلی تغییر کند، که می‌تواند به باگ‌های پنهان منجر شود (مثلاً در الگوریتم‌هایی که انتظار عدم تغییر ورودی را دارند).
• سازگاری عقب‌گرد (backward compatibility): این مشکل تنها در ترکیب C# 14 با هدف‌های قدیمی رخ می‌دهد، اما اگر پروژه‌ای را به C# 14 ارتقا دهید بدون تغییر هدف، ممکن است شکست بخورد.
• ریسک‌های دیگر: در لامبداهای expression که با تفسیر (interpretation) کامپایل می‌شوند، انتخاب ReadOnlySpan می‌تواند منجر به exceptionهای runtime شود.

• فراخوانی صریح Enumerable.Reverse: به جای x.Reverse()، از Enumerable.Reverse(x) استفاده کنید. این کار کامپایلر را مجبور به انتخاب overload درست می‌کند.

var y = Enumerable.Reverse(x); // رفتار قدیمی حفظ می‌شود.

• تعریف extension method سفارشی: اگر نیاز به حفظ رفتار در چندین مکان دارید، یک متد extension برای آرایه تعریف کنید:

public static class ArrayExtensions
{
    public static IEnumerable<T> Reverse<T>(this T[] source) => Enumerable.Reverse(source);
}

• این متد اولویت بالاتری خواهد داشت.
• ارتقا به .NET 10 یا بالاتر: در این نسخه‌ها، overload Enumerable.Reverse(this T[]) به طور خودکار انتخاب می‌شود و مشکل حل می‌شود.
• بررسی کد با ابزارها: از ابزارهایی مانند ReSharper یا تحلیل‌گرهای استاتیک استفاده کنید تا کدهای تحت تأثیر را شناسایی کنید.

• بهبودهای type inference برای spanها: این اجازه می‌دهد spanها در سناریوهای بیشتری مانند لامبداها یا متدهای ژنریک استفاده شوند، اما می‌تواند overload resolution را پیچیده‌تر کند.
• تغییرات دیگر در overload resolution: برای مثال، در مواردی که متدهایی با ReadOnlySpan وجود دارند، ممکن است خطاهای runtime در آرایه‌های covariant ایجاد شود. مثلاً:

object[] objects = new string[] { "a" };
// در C# 14 ممکن است به Span<object> تبدیل شود و exception بدهد.

• پیشنهادهای API جدید: در .NET 10، برای حفظ سازگاری، متدهایی مانند Enumerable.Reverse اضافه شده‌اند. این بخشی از تلاش برای جلوگیری از شکست‌های گسترده است.
• نکته کلی: همیشه هنگام ارتقا به نسخه جدید C#، کد را با هدف‌های مختلف تست کنید و از مستندات مایکروسافت (مانند صفحه تغییرات شکست‌آمیز) استفاده کنید.