Dokumentasi C# interaktif: Substring

Q: Bagaimana cara kerja Substring di C#?

s.Substring(start) mengembalikan karakter dari indeks start sampai akhir; s.Substring(start, length) mengembalikan length karakter mulai dari start. Indeks dimulai dari 0, dan argumen kedua adalah panjang, bukan indeks akhir: "Hello".Substring(1, 3) adalah "ell". String aslinya tidak berubah.

Q: Kenapa Substring melempar ArgumentOutOfRangeException?

Karena start bernilai negatif atau lebih besar dari panjang string, atau start + length melewati akhir string. Penyebab paling umum adalah panjang yang dihitung untuk string yang lebih panjang, atau hasil -1 dari IndexOf yang dipakai sebagai posisi awal. Batasi panjangnya dengan Math.Min(length, s.Length - start) dan periksa hasil IndexOf sebelum memakainya.

Q: Bagaimana cara mengambil n karakter terakhir dari string di C#?

s.Substring(s.Length - n) mengembalikan n karakter terakhir, selama n <= s.Length. Agar aman untuk string pendek, pakai s.Length <= n ? s : s.Substring(s.Length - n). Di C# 8 dan sesudahnya kamu juga bisa menulis s[^n..], yang melempar exception dengan cara yang sama jika n terlalu besar.

Q: Bagaimana cara mengambil substring di antara dua karakter di C#?

Cari kedua posisinya dengan IndexOf, lalu ambil bagian di antaranya: int start = s.IndexOf('(') + 1; int end = s.IndexOf(')', start); string inside = s.Substring(start, end - start);. Pastikan setiap IndexOf menemukan sesuatu (bukan -1) sebelum memanggil Substring. Untuk pola yang rumit, regular expression lebih jelas.

Q: Apakah Substring di C# dimulai dari nol?

Ya. Karakter pertama ada di indeks 0 dan yang terakhir di Length - 1. Substring(0, 3) mengembalikan tiga karakter pertama. Memberikan Length itu sendiri sebagai posisi awal diizinkan dan mengembalikan string kosong.

Substring mengembalikan string baru yang dibuat dari sebagian string yang sudah ada. Method ini punya dua overload:

s.Substring(startIndex): dari startIndex sampai akhir.
s.Substring(startIndex, length): sebanyak length karakter, mulai dari startIndex.

Indeks dimulai dari 0, dan argumen keduanya adalah panjang, bukan posisi akhir. Itulah perbedaannya dengan substring(start, end) di JavaScript dan substring(begin, end) di Java, dan menjadi sumber banyak bug selisih indeks saat kode dipindahkan dari bahasa lain.

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
    }
}

Output:

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

Seperti semua method string, Substring tidak mengubah string aslinya; ia mengembalikan string baru, jadi simpan hasilnya.

ArgumentOutOfRangeException dan cara menghindarinya

Substring melempar ArgumentOutOfRangeException jika rentang yang diminta tidak muat di dalam string: startIndex negatif, startIndex lebih besar dari Length, length negatif, atau startIndex + length lebih besar dari Length. Tidak ada pemotongan diam-diam, berbeda dengan slice di 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));
    }
}

Output:

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

Pengaman yang biasa dipakai adalah membatasi panjangnya sesuai sisa string dengan 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)}]");
    }
}

Output:

ffee
ea
[]
[]

Memanggil Substring pada string null melempar NullReferenceException, bukan ArgumentOutOfRangeException, itulah sebabnya helper di atas memeriksa null lebih dulu.

n karakter pertama dan terakhir

Mengambil awalan atau akhiran adalah pemakaian Substring yang paling umum. Keduanya melempar exception jika string lebih pendek dari n, jadi kode produksi memeriksa panjangnya:

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

Output:

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

Jika yang ingin kamu buang adalah bagian awal string, Substring(n) saja sudah cukup: "#FF8800".Substring(1) adalah "FF8800". Method terkait, Remove(start, count), melakukan kebalikan dari Substring: ia mengembalikan string dengan rentang itu dihapus.

Substring dengan IndexOf

Kebanyakan substring di dunia nyata ditemukan, bukan dihitung. IndexOf mengembalikan posisi sebuah karakter atau string (atau -1 jika tidak ada), dan LastIndexOf mencari dari ujung. Gabungkan keduanya dengan Substring untuk memotong teks di sekitar sebuah pemisah:

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
    }
}

Output:

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

Perhitungannya mengikuti satu aturan: untuk mengambil teks di antara posisi a dan b (keduanya tidak termasuk), posisi awalnya a + 1 dan panjangnya b - a - 1.

Bahayanya adalah IndexOf yang mengembalikan -1. email.Substring(0, -1) melempar exception, dan yang lebih buruk, email.Substring(-1 + 1) diam-diam mengembalikan seluruh string. Selalu periksa:

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

Output:

shop.io
(none)

Split sebagai alternatif

Jika sebuah string adalah daftar field dengan pemisah, Split lebih sederhana daripada rangkaian pemanggilan IndexOf dan Substring, dan tidak ada perhitungan indeks yang bisa salah:

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
    }
}

Output:

Ana Silva
Porto
maya.lopez
beach.jpg

Split mengalokasikan sebuah array plus satu string untuk setiap field, jadi untuk satu potongan saja di perulangan yang sering dijalankan, IndexOf dan Substring lebih hemat. Untuk kasus lainnya, keterbacaan lebih penting. Option lainnya (beberapa pemisah, membuang entri kosong, jumlah maksimum) ada di method string. Untuk pola seperti "digit setelah ID:", regular expression biasanya menjadi alat yang paling jelas.

Operator range (C# 8 dan sesudahnya)

C# 8 menambahkan sintaks index dan range, yang bisa dipakai pada string dan array. ^n berarti "n dari ujung", dan a..b adalah rentang dari a sampai sebelum b (ujung akhirnya tidak termasuk), jadi angka keduanya adalah indeks akhir, bukan panjang:

// 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'

Pada string, range dikompilasi menjadi pemanggilan Substring, jadi ia mengalokasikan string baru dan melempar ArgumentOutOfRangeException untuk kasus di luar batas yang sama. Memilih yang mana hanya soal gaya; range lebih enak dibaca jika kedua ujungnya diukur dari sisi yang berbeda ([1..^1]).

Substring tanpa menyalin: Span

Setiap pemanggilan Substring mengalokasikan string baru. Di kode parsing yang sensitif terhadap performa (membaca file besar, menangani banyak request), .NET Core 2.1 dan sesudahnya menyediakan ReadOnlySpan<char>, sebuah tampilan ke sebagian string asli tanpa penyalinan:

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 tidak bisa disimpan di field class biasa atau dipakai melewati await, jadi tempatnya di kode sinkron yang ketat. Untuk kode aplikasi pada umumnya, Substring adalah alat yang tepat.

Kesalahan umum

Memberikan indeks akhir sebagai panjang. s.Substring(2, 5) berarti lima karakter mulai dari indeks 2, bukan "indeks 2 sampai 5". Untuk mengambil teks dari indeks a sampai sebelum indeks b, panjangnya adalah b - a.
Tidak memeriksa -1 dari IndexOf. Hasilnya bisa exception atau, dengan + 1, tanpa sengaja seluruh string.
Mengira string pendek cukup panjang. Nama, kode, atau baris dari sebuah file bisa lebih pendek dari yang kamu kira. Batasi dengan Math.Min atau periksa Length.
Membuang hasilnya. s.Substring(1); di barisnya sendiri tidak melakukan hal yang berguna.

Pertanyaan yang sering diajukan

Bagaimana cara kerja Substring di C#?

s.Substring(start) mengembalikan karakter dari indeks start sampai akhir; s.Substring(start, length) mengembalikan length karakter mulai dari start. Indeks dimulai dari 0, dan argumen kedua adalah panjang, bukan indeks akhir: "Hello".Substring(1, 3) adalah "ell". String aslinya tidak berubah.

Kenapa Substring melempar ArgumentOutOfRangeException?

Karena start bernilai negatif atau lebih besar dari panjang string, atau start + length melewati akhir string. Penyebab paling umum adalah panjang yang dihitung untuk string yang lebih panjang, atau hasil -1 dari IndexOf yang dipakai sebagai posisi awal. Batasi panjangnya dengan Math.Min(length, s.Length - start) dan periksa hasil IndexOf sebelum memakainya.

Bagaimana cara mengambil n karakter terakhir dari string di C#?

s.Substring(s.Length - n) mengembalikan n karakter terakhir, selama n <= s.Length. Agar aman untuk string pendek, pakai s.Length <= n ? s : s.Substring(s.Length - n). Di C# 8 dan sesudahnya kamu juga bisa menulis s[^n..], yang melempar exception dengan cara yang sama jika n terlalu besar.

Bagaimana cara mengambil substring di antara dua karakter di C#?

Cari kedua posisinya dengan IndexOf, lalu ambil bagian di antaranya: int start = s.IndexOf('(') + 1; int end = s.IndexOf(')', start); string inside = s.Substring(start, end - start);. Pastikan setiap IndexOf menemukan sesuatu (bukan -1) sebelum memanggil Substring. Untuk pola yang rumit, regular expression lebih jelas.

Apakah Substring di C# dimulai dari nol?

Ya. Karakter pertama ada di indeks 0 dan yang terakhir di Length - 1. Substring(0, 3) mengembalikan tiga karakter pertama. Memberikan Length itu sendiri sebagai posisi awal diizinkan dan mengembalikan string kosong.

Konsep terkait

Substring di C#: Mengambil Bagian dari String dengan Aman

ArgumentOutOfRangeException dan cara menghindarinya

n karakter pertama dan terakhir

Substring dengan IndexOf

Split sebagai alternatif

Operator range (C# 8 dan sesudahnya)

Substring tanpa menyalin: Span

Kesalahan umum

Pertanyaan yang sering diajukan

Belajar coding dengan Coddy