nordic-dev.net/rust
nordic-dev.net/rust
2
0
Fork 0
mirror of https://github.com/rust-lang/rust.git synced 2025-06-05 11:48:30 +00:00
Code Issues Packages Projects Releases Wiki Activity

Document futility of printing temporary pointers

Browse Source
This commit is contained in:
Kornel 2024-07-17 22:39:31 +01:00
parent 6de928dce9
commit 56fb89acee
No known key found for this signature in database
1 changed files with 10 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
library/core/src/fmt/mod.rs
View File

@ -975,9 +975,17 @@ pub trait UpperHex {
/// `p` formatting. /// `p` formatting.
/// ///
/// The `Pointer` trait should format its output as a memory location. This is commonly presented /// The `Pointer` trait should format its output as a memory location. This is commonly presented
/// as hexadecimal. /// as hexadecimal. For more information on formatters, see [the module-level documentation][module].
/// ///
/// For more information on formatters, see [the module-level documentation][module]. /// Printing of pointers is not a reliable way to discover how Rust programs are implemented.
/// The act of reading an address changes the program itself, and may change how the data is represented
/// in memory, and may affect which optimizations are applied to the code.
///
/// The printed pointer values are not guaranteed to be stable nor unique identifiers of objects.
/// Rust allows moving values to different memory locations, and may reuse the same memory locations
/// for different purposes.
///
/// There is no guarantee that the printed value can be converted back to a pointer.
/// ///
/// [module]: ../../std/fmt/index.html /// [module]: ../../std/fmt/index.html
/// ///