Ownership e borrowing

Rust References and Borrowing

Let a function use a value without taking it: & to read, &mut to change.

Intermediário
3 min de leitura
1 exemplo executável

O que você vai aprender

& and &mut
Borrowing in function calls
Many readers or one writer

Executar código →

Borrow → what it allows

length(&message)read only

add_exclamation(&mut message)can change it

let first = &messagemany readers are fine

Use a value without owning it

A reference lets code use a value without owning it. This is called borrowing. &value borrows for reading and &mut value borrows for changing.

length only reads the text, so it takes &str and message can still be used afterwards. add_exclamation needs &mut String to change it. Rust allows many readers at once or one writer, but never both, which rules out data races at compile time.

Pontos-chave

&value borrows for reading.
&mut value borrows for changing.
Many readers or one writer, never both.

Exemplo executável de Rust

Rust

Executar código →

main.rs

fn length(text: &str) -> usize {
    text.len()
}

fn add_exclamation(text: &mut String) {
    text.push('!');
}

fn main() {
    let mut message = String::from("Borrow me");

    let size = length(&message); // immutable borrow
    println!("{message} has {size} bytes");

    add_exclamation(&mut message); // mutable borrow
    println!("{message}");

    let first = &message;
    let second = &message; // many readers are fine
    println!("{first} {second}");
}

Gerar um botão Run para este exemplo Resultado da execução

Borrow me has 9 bytes
Borrow me!
Borrow me! Borrow me!

Pratique

Abra o exemplo no compilador online, mude um valor ou adicione uma linha e tente prever a saída antes de executar. Depois quebre o código de propósito e leia a mensagem do compilador.

Terminou esta lição?

Marque como aprendida para acompanhar seu progresso.

Próxima: Slices →

Pratique com um desafio

Use o conteúdo desta lição para resolver um problema real. Cada desafio roda no navegador, com testes instantâneos e uma revisão por IA.

Todos os desafios