Recherche…


Syntaxe

  • laisser raw_ptr = & pointee comme * const type // créer un pointeur brut constant sur certaines données
  • laisser raw_mut_ptr = & mut pointee comme * mut type // créer un pointeur brut mutable sur des données mutables
  • laisser deref = * raw_ptr // déréférencer un pointeur brut (nécessite un blocage non sécurisé)

Remarques

  • Les pointeurs bruts ne sont pas sûrs de pointer vers une adresse de mémoire valide et, par conséquent, une utilisation imprudente peut entraîner des erreurs inattendues (et probablement fatales).
  • Toute référence Rust normale (par exemple, &my_object où le type de my_object est T) contraindra à *const T De même, les références mutables contraignent *mut T
  • Les pointeurs bruts ne déplacent pas la propriété (contrairement aux valeurs Box qui)

Créer et utiliser des pointeurs bruts constants

// Let's take an arbitrary piece of data, a 4-byte integer in this case
let some_data: u32 = 14;

// Create a constant raw pointer pointing to the data above
let data_ptr: *const u32 = &some_data as *const u32;

// Note: creating a raw pointer is totally safe but dereferencing a raw pointer requires an
// unsafe block
unsafe {
    let deref_data: u32 = *data_ptr;
    println!("Dereferenced data: {}", deref_data);
}

Le code ci-dessus va sortir: Dereferenced data: 14

Créer et utiliser des pointeurs bruts mutables

// Let's take a mutable piece of data, a 4-byte integer in this case
let mut some_data: u32 = 14;

// Create a mutable raw pointer pointing to the data above
let data_ptr: *mut u32 = &mut some_data as *mut u32;

// Note: creating a raw pointer is totally safe but dereferencing a raw pointer requires an
// unsafe block
unsafe {
    *data_ptr = 20;
    println!("Dereferenced data: {}", some_data);
}

Le code ci-dessus va sortir: Dereferenced data: 20

Initialiser un pointeur brut sur null

Contrairement aux références Rust normales, les pointeurs bruts sont autorisés à prendre des valeurs nulles.

use std::ptr;

// Create a const NULL pointer
let null_ptr: *const u16 = ptr::null();

// Create a mutable NULL pointer
let mut_null_ptr: *mut u16 = ptr::null_mut();

Déréférencement de chaîne

Tout comme en C, les pointeurs bruts de Rust peuvent pointer vers d'autres pointeurs bruts (qui à leur tour peuvent indiquer d'autres pointeurs bruts).

// Take a regular string slice
let planet: &str = "Earth";

// Create a constant pointer pointing to our string slice
let planet_ptr: *const &str = &planet as *const &str;

// Create a constant pointer pointing to the pointer
let planet_ptr_ptr: *const *const &str = &planet_ptr as *const *const &str;

// This can go on...
let planet_ptr_ptr_ptr = &planet_ptr_ptr as *const *const *const &str;

unsafe {
    // Direct usage
    println!("The name of our planet is: {}", planet);
    // Single dereference
    println!("The name of our planet is: {}", *planet_ptr);
    // Double dereference
    println!("The name of our planet is: {}", **planet_ptr_ptr);
    // Triple dereference
    println!("The name of our planet is: {}", ***planet_ptr_ptr_ptr);
}

Cela va produire: The name of our planet is: Earth quatre fois.

Affichage des pointeurs bruts

Rust a un formateur par défaut pour les types de pointeurs qui peuvent être utilisés pour afficher des pointeurs.

use std::ptr;

// Create some data, a raw pointer pointing to it and a null pointer
let data: u32 = 42;
let raw_ptr = &data as *const u32;
let null_ptr = ptr::null() as *const u32;

// the {:p} mapping shows pointer values as hexadecimal memory addresses
println!("Data address: {:p}", &data);
println!("Raw pointer address: {:p}", raw_ptr); 
println!("Null pointer address: {:p}", null_ptr);

Cela va générer quelque chose comme ceci:

Data address: 0x7fff59f6bcc0
Raw pointer address: 0x7fff59f6bcc0
Null pointer address: 0x0


Modified text is an extract of the original Stack Overflow Documentation
Sous licence CC BY-SA 3.0
Non affilié à Stack Overflow