ExpertiDict

Rust · Essencial · Português · Técnico

referência mutável

/ʁe.fe.ˈɾẽ.sjɐ mu.ˈta.vew/substantivo

Referência &mut T que permite alterar o valor emprestado. O Rust garante que só exista uma por vez, e sem outras referências ativas ao mesmo dado.

Onde usar

É o centro do erro 'cannot borrow as mutable more than once'. Em code review, a pergunta comum é se dá para encurtar o escopo dessa referência.

Em código

fn dobra(n: &mut i32) {
  *n *= 2;
}
let mut x = 4;
dobra(&mut x);
println!("{x}");

Exemplos

A função recebe uma referência mutável para alterar a lista.

O compilador reclamou de duas referências mutáveis ao mesmo tempo.

Cuidado

Não é um ponteiro livre como em C: enquanto ela está viva, nem o dono pode ler o valor.

Sinônimos

&mut

Antônimos

referência compartilhada

Veja também

Todos os termos de Rust