Ownership et emprunt

Rust References and Borrowing

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

Intermédiaire
3 min de lecture
1 exemple exécutable

Ce que vous allez apprendre

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

Exécuter le code →

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.

Points clés

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

Exemple Rust exécutable

Rust

Exécuter le code →

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}");
}

Obtenir un bouton Run pour cet exemple Résultat de l'exécution

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

S'entraîner

Ouvrez l'exemple dans le compilateur en ligne, modifiez une valeur ou ajoutez une ligne, et devinez la sortie avant de l'exécuter. Cassez ensuite le code exprès et lisez le message du compilateur.

Leçon terminée ?

Marquez-la comme apprise pour suivre votre progression.

Suivante : Slices →

S'entraîner avec un défi

Utilisez le contenu de cette leçon pour résoudre un vrai problème. Chaque défi s'exécute dans le navigateur, avec des tests instantanés et une revue par l'IA.

Tous les défis