Substring في C#: استخراج جزء من نص بأمان

تعيد Substring نصًا جديدًا مكوّنًا من جزء من نص موجود. لها شكلان:

• s.Substring(startIndex): من startIndex حتى النهاية.
• s.Substring(startIndex, length): عدد length من المحارف، بدءًا من startIndex.

تبدأ الفهارس من 0، والوسيط الثاني طول لا موضع نهاية. هذا هو الفرق عن substring(start, end) في JavaScript وsubstring(begin, end) في Java، ومصدر أخطاء إزاحة كثيرة حين تُنقل الشيفرة.

using System;

class Program
{
    static void Main()
    {
        string sku = "SHOE-4271-BLK";
        //            0123456789...

        Console.WriteLine(sku.Substring(5));        // from index 5 to the end
        Console.WriteLine(sku.Substring(0, 4));     // 4 chars from index 0
        Console.WriteLine(sku.Substring(5, 4));     // 4 chars from index 5
        Console.WriteLine(sku.Substring(10, 3));    // last 3
        Console.WriteLine(sku.Substring(sku.Length).Length); // start == Length: empty string

        Console.WriteLine(sku);                     // unchanged: strings are immutable
    }
}

المخرجات:

4271-BLK
SHOE
4271
BLK
0
SHOE-4271-BLK

مثل كل دوال النصوص، لا تعدّل Substring الأصل؛ بل تعيد نصًا جديدًا، فأسند النتيجة.

ArgumentOutOfRangeException وكيف تتجنّبه

ترمي Substring الاستثناء ArgumentOutOfRangeException حين لا يتّسع النطاق المطلوب داخل النص: startIndex سالب، أو startIndex أكبر من Length، أو length سالب، أو startIndex + length أكبر من Length. لا يوجد اقتطاع صامت، بخلاف شرائح Python.

using System;

class Program
{
    static void Show(string label, Func<string> take)
    {
        try
        {
            Console.WriteLine($"{label} -> \"{take()}\"");
        }
        catch (ArgumentOutOfRangeException)
        {
            Console.WriteLine($"{label} -> ArgumentOutOfRangeException");
        }
    }

    static void Main()
    {
        string word = "Coffee";   // Length 6

        Show("Substring(2, 4)", () => word.Substring(2, 4));
        Show("Substring(2, 5)", () => word.Substring(2, 5));   // 2 + 5 > 6
        Show("Substring(6)", () => word.Substring(6));         // allowed: empty
        Show("Substring(7)", () => word.Substring(7));
        Show("Substring(-1)", () => word.Substring(-1));
        Show("Substring(0, 10)", () => word.Substring(0, 10));
    }
}

المخرجات:

Substring(2, 4) -> "ffee"
Substring(2, 5) -> ArgumentOutOfRangeException
Substring(6) -> ""
Substring(7) -> ArgumentOutOfRangeException
Substring(-1) -> ArgumentOutOfRangeException
Substring(0, 10) -> ArgumentOutOfRangeException

الحماية المعتادة تقييد الطول بما تبقّى من النص عبر Math.Min:

using System;

class Program
{
    static string SafeSubstring(string s, int start, int length)
    {
        if (string.IsNullOrEmpty(s) || start >= s.Length) return "";
        if (start < 0) start = 0;
        return s.Substring(start, Math.Min(length, s.Length - start));
    }

    static void Main()
    {
        Console.WriteLine(SafeSubstring("Coffee", 2, 100));
        Console.WriteLine(SafeSubstring("Tea", 1, 2));
        Console.WriteLine($"[{SafeSubstring("Tea", 5, 2)}]");
        Console.WriteLine($"[{SafeSubstring(null, 0, 2)}]");
    }
}

المخرجات:

ffee
ea
[]
[]

استدعاء Substring على نص null يرمي NullReferenceException لا ArgumentOutOfRangeException، ولهذا تفحص الدالة المساعدة null أولًا.

أول n محارف وآخرها

أخذ بادئة أو لاحقة هو الاستخدام الأشيع لـ Substring. كلاهما يرمي حين يكون النص أقصر من n، لذا تفحص شيفرة الإنتاج الطول:

using System;

class Program
{
    static string Left(string s, int n) => s.Length <= n ? s : s.Substring(0, n);
    static string Right(string s, int n) => s.Length <= n ? s : s.Substring(s.Length - n);

    static void Main()
    {
        string card = "4111111111111111";
        Console.WriteLine("**** " + Right(card, 4));

        string title = "An Unexpectedly Long Product Name";
        Console.WriteLine(Left(title, 12) + "...");

        Console.WriteLine(Left("Hi", 12));     // shorter than n: returned whole
        Console.WriteLine(Right("Hi", 4));
    }
}

المخرجات:

**** 1111
An Unexpecte...
Hi
Hi

حين يكون الجزء الأول من النص هو ما تريد حذفه، تكفي Substring(n) وحدها: "#FF8800".Substring(1) تساوي "FF8800". أما الدالة ذات الصلة Remove(start, count) فتفعل عكس Substring: تعيد النص بعد حذف ذلك النطاق منه.

Substring مع IndexOf

معظم الأجزاء الحقيقية يُعثر عليها ولا تُعدّ. تعيد IndexOf موضع محرف أو نص (أو -1 إن لم يكن موجودًا)، وتبحث LastIndexOf من النهاية. اجمعهما مع Substring لقصّ النص حول فاصل:

using System;

class Program
{
    static void Main()
    {
        string email = "maya.lopez@example.com";
        int at = email.IndexOf('@');
        Console.WriteLine(email.Substring(0, at));       // before the @
        Console.WriteLine(email.Substring(at + 1));      // after the @

        string file = "report.final.v2.pdf";
        int dot = file.LastIndexOf('.');
        Console.WriteLine(file.Substring(dot + 1));      // extension
        Console.WriteLine(file.Substring(0, dot));       // name without extension

        string log = "2026-09-24 [WARN] Disk almost full";
        int open = log.IndexOf('[');
        int close = log.IndexOf(']', open + 1);
        Console.WriteLine(log.Substring(open + 1, close - open - 1)); // between [ and ]
        Console.WriteLine(log.Substring(close + 2));                  // the message
    }
}

المخرجات:

maya.lopez
example.com
pdf
report.final.v2
WARN
Disk almost full

تتبع العملية الحسابية قاعدة واحدة: لأخذ النص بين الموضعين a وb (دون أي منهما)، البداية a + 1 والطول b - a - 1.

الخطر أن تعيد IndexOf القيمة -1. ترمي email.Substring(0, -1)، والأسوأ أن email.Substring(-1 + 1) تعيد النص كله بصمت. افحص دائمًا:

using System;

class Program
{
    static string Domain(string email)
    {
        int at = email.IndexOf('@');
        if (at < 0) return null;
        return email.Substring(at + 1);
    }

    static void Main()
    {
        Console.WriteLine(Domain("leo@shop.io") ?? "(none)");
        Console.WriteLine(Domain("not-an-email") ?? "(none)");
    }
}

المخرجات:

shop.io
(none)

Split كبديل

حين يكون النص قائمة حقول بفاصل، تكون Split أبسط من سلسلة استدعاءات IndexOf وSubstring، ولا حساب فهارس فيها قد تخطئ فيه:

using System;

class Program
{
    static void Main()
    {
        string row = "1042;Ana Silva;Porto;31";
        string[] fields = row.Split(';');
        Console.WriteLine(fields[1]);
        Console.WriteLine(fields[2]);

        string email = "maya.lopez@example.com";
        string user = email.Split('@')[0];
        Console.WriteLine(user);

        string path = "images/2026/09/beach.jpg";
        string[] parts = path.Split('/');
        Console.WriteLine(parts[parts.Length - 1]);   // last segment
    }
}

المخرجات:

Ana Silva
Porto
maya.lopez
beach.jpg

تحجز Split مصفوفة ونصًا لكل حقل، لذا لقصّة واحدة في حلقة ساخنة تكون IndexOf وSubstring أرخص. ولكل ما عدا ذلك تفوز سهولة القراءة. خيارات أكثر (عدة فواصل، إزالة المدخلات الفارغة، عدد أقصى) في دوال النصوص. وللأنماط مثل "الأرقام بعد ID:" يكون التعبير النمطي عادة الأداة الأوضح.

معامل النطاق (C# 8 وما بعده)

أضافت C# 8 صياغة الفهرس والنطاق، التي تعمل على النصوص والمصفوفات. تعني ^n "n من النهاية"، وa..b هو النطاق من a حتى b دون تضمين b، فالرقم الثاني فهرس نهاية لا طول:

// C# 8 and later
string sku = "SHOE-4271-BLK";

string first4 = sku[..4];      // "SHOE"        same as Substring(0, 4)
string middle = sku[5..9];     // "4271"        same as Substring(5, 4)
string last3  = sku[^3..];     // "BLK"         same as Substring(sku.Length - 3)
string noEnds = sku[1..^1];    // "HOE-4271-BL" drop first and last
char lastChar = sku[^1];       // 'K'

على النص يُترجم النطاق إلى استدعاء Substring، فيحجز نصًا جديدًا ويرمي ArgumentOutOfRangeException في حالات الخروج عن الحدود نفسها. أيهما تستخدم مسألة أسلوب؛ والنطاقات أسهل قراءة حين يُقاس الطرفان من جهتين مختلفتين ([1..^1]).

أجزاء النص دون نسخ: Span

كل استدعاء لـ Substring يحجز نصًا جديدًا. في شيفرة التحليل الحساسة للأداء (قراءة ملفات كبيرة، معالجة طلبات كثيرة) توفّر .NET Core 2.1 وما بعدها النوع ReadOnlySpan<char>، وهو نافذة على جزء من النص الأصلي دون نسخ:

ReadOnlySpan<char> line = "2026-09-24,42.50,EUR".AsSpan();
ReadOnlySpan<char> amount = line.Slice(11, 5);          // "42.50", no allocation
decimal value = decimal.Parse(amount, provider: CultureInfo.InvariantCulture);

لا يمكن تخزين Spans في حقول الأصناف العادية ولا استخدامها عبر await، لذا مكانها الشيفرة المتزامنة المحكمة. أما لشيفرة التطبيقات المعتادة فإن Substring هي الأداة الصحيحة.

أخطاء شائعة

• تمرير فهرس نهاية بدل الطول. تعني s.Substring(2, 5) خمسة محارف من الفهرس 2، لا "من الفهرس 2 إلى 5". لأخذ النص من الفهرس a حتى الفهرس b دون تضمينه، الطول هو b - a.
• عدم فحص IndexOf للقيمة -1. إما استثناء، أو مع + 1 النص كله عن غير قصد.
• افتراض أن النصوص القصيرة طويلة بما يكفي. الاسم أو الرمز أو السطر من ملف قد يكون أقصر مما تتوقع. قيّد بـ Math.Min أو افحص Length.
• تجاهل النتيجة. s.Substring(1); في سطر وحدها لا تفعل شيئًا مفيدًا.