`String::push_str` în Rust

String Rust 1.0

Adaugă la finalul unui String un text (push_str) sau un singur caracter (push).

Sintaxă

pub fn push_str(&mut self, string: &str)
pub fn push(&mut self, ch: char)

Ce face `String::push_str`

push_str lipește un &str la sfârșitul textului; push lipește un singur char (scris cu apostrofuri: '!'). Ambele modifică textul pe loc, deci variabila trebuie să fie mut, și nu returnează nimic.

push_str primește un împrumut, deci textul adăugat rămâne utilizabil după. Pentru a adăuga un String, dă-i o referință: s.push_str(&alt). Pentru text formatat (numere, mai multe valori) se poate folosi și write! cu fmt::Write, sau +=, care face același lucru ca push_str.

Parametri

Parametru	Descriere
`string`	Textul adăugat (`&str`).
`ch`	Caracterul adăugat (`char`). Poate fi orice caracter Unicode, de exemplu `'ș'` sau `'€'`.

Ce returnează

Nimic (()). Textul original este modificat.

Exemple

Exemplul 1: push_str, push și +=

fn main() {
    let mut adresa = String::from("Str. Lăpușneanu");
    adresa.push_str(" nr. 12");
    adresa.push(',');
    adresa += " Iași";

    let tara = String::from("România");
    adresa.push_str(", ");
    adresa.push_str(&tara);      // împrumut: tara rămâne validă

    println!("{adresa}");
    println!("țara: {tara}");
}

Rezultat

Str. Lăpușneanu nr. 12, Iași, România
țara: România

Exemplul 2: Construirea unui text din caractere

Inversăm un cuvânt literă cu literă. chars().rev() parcurge caracterele de la coadă, iar push le adaugă pe rând.

fn main() {
    let cuvant = "țară";
    let mut invers = String::new();
    for c in cuvant.chars().rev() {
        invers.push(c);
    }
    println!("{cuvant} -> {invers}");
}