Исполняемые доки C#: Substring

Q: Как работает Substring в C#?

s.Substring(start) возвращает символы от индекса start до конца; s.Substring(start, length) возвращает length символов, начиная с start. Индексы начинаются с 0, а второй аргумент это длина, а не конечный индекс: "Hello".Substring(1, 3) даёт "ell". Исходная строка не изменяется.

Q: Почему Substring выбрасывает ArgumentOutOfRangeException?

Потому что start отрицательный или больше длины строки, либо start + length выходит за конец. Самая частая причина: длина, вычисленная для более длинной строки, или результат IndexOf, равный -1, использованный как начало. Ограничивайте длину через Math.Min(length, s.Length - start) и проверяйте результаты IndexOf перед использованием.

Q: Как получить последние n символов строки в C#?

s.Substring(s.Length - n) возвращает последние n символов при условии n <= s.Length. Чтобы не падать на коротких строках, используйте s.Length <= n ? s : s.Substring(s.Length - n). В C# 8 и новее можно также написать s[^n..], который выбрасывает исключение так же, когда n слишком велико.

Q: Как получить подстроку между двумя символами в C#?

Найдите обе позиции через IndexOf, затем возьмите часть между ними: int start = s.IndexOf('(') + 1; int end = s.IndexOf(')', start); string inside = s.Substring(start, end - start);. Перед вызовом Substring проверьте, что каждый IndexOf что-то нашёл (не -1). Для сложных шаблонов понятнее регулярное выражение.

Q: Индексы в Substring начинаются с нуля?

Да. Первый символ находится по индексу 0, а последний по индексу Length - 1. Substring(0, 3) возвращает первые три символа. Передать в качестве начала сам Length разрешено: результатом будет пустая строка.

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);

Span нельзя хранить в полях обычных классов или использовать через await, поэтому их место в компактном синхронном коде. Для типичного прикладного кода правильный инструмент Substring.

Частые ошибки

Передача конечного индекса вместо длины. s.Substring(2, 5) означает пять символов начиная с индекса 2, а не «с индекса 2 по 5». Чтобы взять текст от индекса a до индекса b, не включая его, длина равна b - a.
Не проверять IndexOf на -1. Результатом будет либо исключение, либо, с + 1, случайно вся строка.
Считать, что короткие строки достаточно длинные. Имя, код или строка из файла могут оказаться короче, чем вы ожидаете. Ограничивайте через Math.Min или проверяйте Length.
Отбрасывать результат. s.Substring(1); в отдельной строке ничего полезного не делает.

Часто задаваемые вопросы

Как работает Substring в C#?

s.Substring(start) возвращает символы от индекса start до конца; s.Substring(start, length) возвращает length символов, начиная с start. Индексы начинаются с 0, а второй аргумент это длина, а не конечный индекс: "Hello".Substring(1, 3) даёт "ell". Исходная строка не изменяется.

Почему Substring выбрасывает ArgumentOutOfRangeException?

Потому что start отрицательный или больше длины строки, либо start + length выходит за конец. Самая частая причина: длина, вычисленная для более длинной строки, или результат IndexOf, равный -1, использованный как начало. Ограничивайте длину через Math.Min(length, s.Length - start) и проверяйте результаты IndexOf перед использованием.

Как получить последние n символов строки в C#?

s.Substring(s.Length - n) возвращает последние n символов при условии n <= s.Length. Чтобы не падать на коротких строках, используйте s.Length <= n ? s : s.Substring(s.Length - n). В C# 8 и новее можно также написать s[^n..], который выбрасывает исключение так же, когда n слишком велико.

Как получить подстроку между двумя символами в C#?

Найдите обе позиции через IndexOf, затем возьмите часть между ними: int start = s.IndexOf('(') + 1; int end = s.IndexOf(')', start); string inside = s.Substring(start, end - start);. Перед вызовом Substring проверьте, что каждый IndexOf что-то нашёл (не -1). Для сложных шаблонов понятнее регулярное выражение.

Индексы в Substring начинаются с нуля?

Да. Первый символ находится по индексу 0, а последний по индексу Length - 1. Substring(0, 3) возвращает первые три символа. Передать в качестве начала сам Length разрешено: результатом будет пустая строка.

Связанные концепции