Когда передавать String, &str и &mut String в Rust

Разбираем три сигнатуры на одном примере и выясняем, почему компилятор иногда запрещает изменять строку, которую мы ещё читаем.

Функция получает имя из String. Перед выбором сигнатуры ответь на вопрос: она должна прочитать имя, изменить исходную строку или забрать её себе? Тип параметра показывает это уже в месте вызова.

Для чтения достаточно &str

fn display_name(raw: &str) -> &str {
    raw.trim()
}

fn main() {
    let raw = String::from("  Мила  ");
    let name = display_name(&raw);

    assert_eq!(name, "Мила");
    assert_eq!(raw, "  Мила  ");
    assert_eq!(display_name("  Рома  "), "Рома");
}

trim() возвращает срез исходной строки. Символы остаются в прежнем буфере, а результат ссылается на участок без пробелов. &str позволяет принять и срез String, и строковый литерал. Возвращаемый срез зависит от входных данных: его нельзя использовать после того, как исходная строка уничтожена.

Для изменения возьми &mut String

fn add_label(name: &mut String) {
    name.push_str(" (участник)");
}

fn main() {
    let mut name = String::from("Мила");
    add_label(&mut name);
    assert_eq!(name, "Мила (участник)");
}

Функция дописывает текст в тот же String. На время изменяемого заимствования доступ к строке через другие активные ссылки ограничен. Так push_str может расширить буфер без риска оставить читателю ссылку на старую память.

Для передачи владения используй String

struct Member {
    name: String,
}

fn enroll(name: String) -> Member {
    Member { name }
}

fn main() {
    let name = String::from("Мила");
    let member = enroll(name);
    assert_eq!(member.name, "Мила");
}

Строка теперь принадлежит member. Попытка обратиться к переменной name после enroll(name) приведёт к ошибке компиляции. В этом сценарии передача владения обходится без clone(): функция забирает уже созданную строку.

Найди, где закончится заимствование

Этот пример намеренно не компилируется:

let mut raw = String::from("  Мила  ");
let name = raw.trim();
raw.push_str("!");
println!("{name}");

name ещё нужен после вызова push_str, поэтому неизменяемое заимствование остаётся активным во время изменения. Перенеси println! выше push_str и запусти снова. Если name больше нигде не используется, компилятор завершит заимствование после печати. Если же прежнее имя нужно хранить и после изменения raw, создай отдельный String через raw.trim().to_owned().

Ссылки и заимствования в The Rust Programming Language.