دوال النصوص في C#: Split وReplace وContains وIndexOf وTrim وJoin وغيرها

في System.String عشرات الدوال. تغطي هذه الصفحة الدوال التي تؤدي معظم العمل في الشيفرة الحقيقية، مع الخيارات والأفخاخ المهمة. قاعدة واحدة تنطبق عليها جميعًا: النصوص غير قابلة للتغيير، فكل دالة تعيد نصًا جديدًا (أو قيمة) وتترك الأصلي دون تغيير. s.Trim(); في سطر وحدها لا تفعل شيئًا؛ اكتب s = s.Trim();.

Split

تقسم Split النص إلى مصفوفة string[] عند كل فاصل:

using System;

class Program
{
    static void Main()
    {
        string csv = "apple,banana,cherry";
        string[] fruits = csv.Split(',');
        Console.WriteLine(fruits.Length);
        foreach (string f in fruits) Console.WriteLine(f);

        // Several separator characters
        string messy = "red;green, blue|yellow";
        string[] colors = messy.Split(new[] { ';', ',', '|' });
        Console.WriteLine(string.Join("/", colors));

        // A separator longer than one character
        string log = "INFO -> started -> ready";
        string[] steps = log.Split(new[] { " -> " }, StringSplitOptions.None);
        Console.WriteLine(string.Join("/", steps));
    }
}

المخرجات:

3
apple
banana
cherry
red/green/ blue/yellow
INFO/started/ready

لاحظ " blue": تقطع Split عند الفاصل بالضبط وتحتفظ بأي مسافات. خياران يعالجان التنظيفات الشائعة:

using System;
using System.Linq;

class Program
{
    static void Main()
    {
        string tags = "c#, ,dotnet,,  linq ";

        string[] raw = tags.Split(',');
        Console.WriteLine(raw.Length);   // empty and blank parts included

        string[] noEmpty = tags.Split(new[] { ',' }, StringSplitOptions.RemoveEmptyEntries);
        Console.WriteLine(noEmpty.Length);

        string[] clean = tags.Split(',')
            .Select(t => t.Trim())
            .Where(t => t.Length > 0)
            .ToArray();
        Console.WriteLine(string.Join("|", clean));

        // Limit the number of parts: the last one keeps the rest
        string header = "Subject: Re: Meeting: Friday";
        string[] kv = header.Split(new[] { ':' }, 2);
        Console.WriteLine($"key=[{kv[0]}] value=[{kv[1].Trim()}]");

        string words = "one  two   three";
        Console.WriteLine(words.Split((char[])null, StringSplitOptions.RemoveEmptyEntries).Length); // split on any whitespace
    }
}

المخرجات:

5
4
c#|dotnet|linq
key=[Subject] value=[Re: Meeting: Friday]
3

يحذف RemoveEmptyEntries الأجزاء ذات الطول صفر لكن لا الأجزاء المكوّنة من مسافات فقط (نجا " " أعلاه). أضافت .NET 5 الخيار StringSplitOptions.TrimEntries، ويمكن الجمع بين الاثنين: tags.Split(',', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries) تعطي النتيجة النظيفة في استدعاء واحد. وتمرير null كفاصل يقسم عند أي مسافة بيضاء، وهي الطريقة المعتادة لتقسيم نص إلى كلمات.

التقسيم عند char واحد (Split(',')) لا يحتاج إلى مصفوفة. الأشكال التي تأخذ char مع خيارات، أو string واحدًا، موجودة منذ .NET Core 2.0؛ أما أشكال المصفوفات المستخدمة أعلاه فتعمل في كل مكان، بما في ذلك .NET Framework وUnity.

Replace

تستبدل Replace كل ظهور لمحرف أو لجزء نصي:

using System;
using System.Text.RegularExpressions;

class Program
{
    static void Main()
    {
        string phone = "555-123-4567";
        Console.WriteLine(phone.Replace("-", ""));       // remove
        Console.WriteLine(phone.Replace('-', '.'));      // char overload

        string text = "Cats and cats and CATS";
        Console.WriteLine(text.Replace("cats", "dogs")); // case-sensitive
        Console.WriteLine(text.Replace("cats", "dogs", StringComparison.OrdinalIgnoreCase));

        // Only the first occurrence
        var first = new Regex("cats", RegexOptions.IgnoreCase);
        Console.WriteLine(first.Replace(text, "dogs", 1));

        // Collapse repeated spaces
        Console.WriteLine(Regex.Replace("too    many   spaces", @"\s+", " "));
    }
}

المخرجات:

5551234567
555.123.4567
Cats and dogs and CATS
dogs and dogs and dogs
dogs and cats and CATS
too many spaces

الشكل الذي يأخذ وسيط StringComparison متاح في .NET Core 2.0 وما بعده. وفي .NET Framework يتم الاستبدال غير الحساس لحالة الأحرف بـ Regex.Replace(text, Regex.Escape(find), replacement, RegexOptions.IgnoreCase). الاستبدال بـ "" هو طريقة حذف المحارف، وسلسلة عدة استدعاءات Replace مقبولة لبضعة استبدالات.

Contains وIndexOf وStartsWith وEndsWith

هذه الدوال تبحث. تجيب Contains بنعم أو لا؛ وتعيد IndexOf وLastIndexOf موضعًا، أو -1 حين لا تطابق؛ وتختبر StartsWith وEndsWith الطرفين.

using System;

class Program
{
    static void Main()
    {
        string subject = "Invoice #4471 overdue: please pay";

        Console.WriteLine(subject.Contains("overdue"));                    // True
        Console.WriteLine(subject.Contains("OVERDUE"));                    // False: case-sensitive
        Console.WriteLine(subject.Contains("OVERDUE", StringComparison.OrdinalIgnoreCase));
        Console.WriteLine(subject.IndexOf("OVERDUE", StringComparison.OrdinalIgnoreCase) >= 0);

        Console.WriteLine(subject.IndexOf('#'));            // 8
        Console.WriteLine(subject.IndexOf("pay"));          // first "pay"
        Console.WriteLine(subject.LastIndexOf('e'));
        Console.WriteLine(subject.IndexOf("refund"));       // -1: not found
        Console.WriteLine(subject.IndexOf('e', 10));        // search from index 10

        string file = "photo.JPG";
        Console.WriteLine(file.EndsWith(".jpg"));           // False
        Console.WriteLine(file.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase));
        Console.WriteLine("https://coddy.tech".StartsWith("https://"));
    }
}

المخرجات:

True
False
True
True
8
30
28
-1
16
False
True
True

كلها حساسة لحالة الأحرف افتراضيًا. توجد Contains(string, StringComparison) في .NET Core 2.1 وما بعده؛ والشكل IndexOf(...) >= 0 يعمل في كل إصدار، ولهذا تراه في الشيفرات الأقدم. تجد IndexOfAny(new[] { ',', ';' }) أول محرف من عدة محارف.

ملاحظة عن الثقافة: دون StringComparison تستخدم StartsWith وEndsWith وIndexOf(string) وCompareTo قواعد حساسة للثقافة، بينما تقارن Contains وReplace وIndexOf(char) ترتيبيًا (ordinal). تمرير StringComparison.Ordinal أو OrdinalIgnoreCase صراحة يزيل الالتباس، وتوصي به أدوات تحليل الشيفرة.

Trim وTrimStart وTrimEnd

تزيل Trim المسافات البيضاء (المسافات والجدولات والأسطر الجديدة) من الطرفين. وتزيل TrimStart وTrimEnd من طرف واحد. وإن أُعطيت محارف فإنها تزيلها بدلًا من ذلك:

using System;

class Program
{
    static void Main()
    {
        string input = "  \t ana@example.com \n";
        Console.WriteLine($"[{input.Trim()}]");
        Console.WriteLine($"[{input.TrimStart()}]".Replace("\n", "\\n"));
        Console.WriteLine($"[{"  x  ".TrimEnd()}]");

        Console.WriteLine("***SALE***".Trim('*'));
        Console.WriteLine("007".TrimStart('0'));
        Console.WriteLine("path/to/dir///".TrimEnd('/'));
        Console.WriteLine("1,234.50 USD".TrimEnd(' ', 'U', 'S', 'D'));
    }
}

المخرجات:

[ana@example.com]
[ana@example.com \n]
[  x]
SALE
7
path/to/dir
1,234.50

لا تمسّ Trim إلا الطرفين؛ وتبقى المسافات داخل النص. تعيد TrimStart('0') على "000" نصًا فارغًا، لذا اقرأ نصوص الأرقام بـ int.Parse بدل تجريد الأصفار يدويًا.

ToUpper وToLower

using System;

class Program
{
    static void Main()
    {
        string name = "maya Lopez";
        Console.WriteLine(name.ToUpper());
        Console.WriteLine(name.ToLower());
        Console.WriteLine(name.ToUpperInvariant());

        // Capitalize the first letter
        string word = "coffee";
        string capital = char.ToUpper(word[0]) + word.Substring(1);
        Console.WriteLine(capital);
    }
}

المخرجات:

MAYA LOPEZ
maya lopez
MAYA LOPEZ
Coffee

تتبع ToUpper وToLower الثقافة الحالية، ففي التركية تكون "i".ToUpper() حرف İ كبيرًا منقوطًا لا I. للمعرّفات والمفاتيح وأسماء الملفات استخدم ToUpperInvariant وToLowerInvariant. وللمقارنة استخدم StringComparison بدل تحويل حالة الأحرف أصلًا (راجع النصوص). ولتكبير أول حرف في كل كلمة توجد CultureInfo.CurrentCulture.TextInfo.ToTitleCase(text)، مع أنها تترك الكلمات المكتوبة كلها بأحرف كبيرة كما هي.

PadLeft وPadRight

يضيف التبطين محارف حتى يبلغ النص عرضًا كليًا. وهو مفيد للمخرجات ذات العرض الثابت ولتبطين الرموز بالأصفار:

using System;

class Program
{
    static void Main()
    {
        Console.WriteLine("42".PadLeft(6, '0'));
        Console.WriteLine("[" + "Tea".PadRight(8) + "]");
        Console.WriteLine("[" + "Tea".PadLeft(8) + "]");
        Console.WriteLine("Too long already".PadLeft(4));   // never truncates

        string[] items = { "Espresso", "Latte", "Mocha" };
        decimal[] prices = { 2.40m, 3.60m, 3.95m };
        for (int i = 0; i < items.Length; i++)
        {
            Console.WriteLine(items[i].PadRight(10, '.') + prices[i].ToString("F2").PadLeft(6));
        }
    }
}

المخرجات:

000042
[Tea     ]
[     Tea]
Too long already
Espresso..  2.40
Latte.....  3.60
Mocha.....  3.95

تؤدي محاذاة الاستيفاء ({name,-10}) المهمة نفسها ضمن السطر.

Join وConcat

تضع string.Join فاصلًا بين عناصر أي مجموعة. وتضمّ string.Concat دون فاصل:

using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        var guests = new List<string> { "Ana", "Ben", "Chloe" };
        Console.WriteLine(string.Join(", ", guests));
        Console.WriteLine(string.Join(" + ", new[] { 1, 2, 3 }));   // any type
        Console.WriteLine(string.Join(",", new string[0]) == "");    // empty input: empty string

        Console.WriteLine(string.Concat("2026", "-", "09"));
        Console.WriteLine(string.Concat(guests));

        // "A, B and C"
        string list = guests.Count > 1
            ? string.Join(", ", guests.GetRange(0, guests.Count - 1)) + " and " + guests[guests.Count - 1]
            : string.Join("", guests);
        Console.WriteLine(list);
    }
}

المخرجات:

Ana, Ben, Chloe
1 + 2 + 3
True
2026-09
AnaBenChloe
Ana, Ben and Chloe

Join هي الطريقة الصحيحة لبناء قائمة مفصولة: لا فاصل زائد في النهاية لإزالته، وتبني النتيجة في مرور واحد. تستدعي ToString() على كل عنصر، فتعمل مع الأرقام والكائنات أيضًا.

Reverse وInsert وRemove

لا توجد دالة string.Reverse تعيد نصًا. الطريقتان المعتادتان:

using System;
using System.Linq;

class Program
{
    static void Main()
    {
        string word = "stressed";

        char[] chars = word.ToCharArray();
        Array.Reverse(chars);
        Console.WriteLine(new string(chars));

        Console.WriteLine(new string(word.Reverse().ToArray()));   // LINQ

        string racecar = "Racecar";
        string lower = racecar.ToLowerInvariant();
        Console.WriteLine(lower == new string(lower.Reverse().ToArray()));  // palindrome?

        Console.WriteLine("2026-09".Insert(4, "/Q3"));     // insert at an index
        Console.WriteLine("Hello, World".Remove(5));        // everything from index 5 removed
        Console.WriteLine("Hello, World".Remove(5, 2));     // 2 chars removed at 5
    }
}

المخرجات:

desserts
desserts
True
2026/Q3-09
Hello
HelloWorld

تعيد word.Reverse() وحدها IEnumerable<char> لا نصًا؛ وطباعتها تُظهر اسم نوع. كلتا الطريقتين تعكس وحدات ترميز UTF-16، وهذا يكسر المحارف المكوّنة من وحدتين (معظم الرموز التعبيرية) والأحرف ذات علامات التشكيل المركّبة.

مرجع سريع