`String::insert` în Rust

String Rust 1.0

Inserează un caracter (insert) sau un text (insert_str) la o poziție dată în octeți.

Sintaxă

pub fn insert(&mut self, idx: usize, ch: char)
pub fn insert_str(&mut self, idx: usize, string: &str)

Ce face `String::insert`

insert pune un char, iar insert_str pune un &str, la poziția idx. Tot ce urma după poziție se mută la dreapta. Poziția se măsoară în octeți, nu în litere, și trebuie să cadă la începutul unui caracter; altfel programul se oprește cu panică.

Pentru a afla poziția unei litere folosește find sau char_indices, care dau poziții corecte în octeți. Inserarea la început (0) și la final (len()) este mereu sigură. Inserarea mută restul textului, deci pe texte foarte mari este mai lentă decât push.

Parametri

Parametru	Descriere
`idx`	Poziția în octeți. Trebuie să fie ≤ `len()` și pe granița unui caracter (`is_char_boundary(idx)`).
`ch / string`	Caracterul sau textul inserat.

Ce returnează

Nimic. Textul este modificat pe loc.

Exemple

Exemplul 1: Inserare la început, la mijloc și la final

fn main() {
    let mut s = String::from("Popescu");
    s.insert_str(0, "Ana ");     // la început
    let len = s.len();
    s.insert(len, '!');           // la final
    println!("{s}");

    let mut data = String::from("20261019");
    data.insert(4, '-');
    data.insert(7, '-');
    println!("{data}");
}

Rezultat

Ana Popescu!
2026-10-19

Exemplul 2: Poziția găsită cu find

find returnează poziția în octeți, deci este sigur să inserăm acolo chiar dacă înainte sunt diacritice.

fn main() {
    let mut s = String::from("Târgu Mureș, jud. MS");
    if let Some(poz) = s.find(',') {
        s.insert_str(poz, " (oraș)");
    }
    println!("{s}");
}