本文简要介绍rust语言中 Function std::ptr::read_unaligned
的用法。
用法
pub unsafe fn read_unaligned<T>(src: *const T) -> T
从src
读取值而不移动它。这使src
中的内存保持不变。
与 read
不同,read_unaligned
适用于未对齐的指针。
安全性
如果违反以下任何条件,则行为未定义:
-
src
必须是 valid 才能读取。 -
src
必须指向T
类型的正确初始化值。
与 read
一样,read_unaligned
创建 T
的按位副本,无论 T
是否为 Copy
。如果 T
不是 Copy
,则同时使用返回值和 *src
处的值可以 violate memory safety 。
请注意,即使 T
的大小为 0
,指针也必须为非空。
在 packed
结构上
尝试创建一个指向unaligned
具有如下表达式的结构体字段&packed.unaligned as *const FieldType
在将其转换为原始指针之前创建一个中间未对齐引用。该引用是临时的并且立即强制转换是无关紧要的,因为编译器始终期望引用正确对齐。结果,使用&packed.unaligned as *const FieldType
立即引起未定义的行为在你的程序中。
相反,您必须使用 ptr::addr_of!
宏来创建指针。您可以将返回的指针与此函数一起使用。
不该做什么以及这与read_unaligned
有何关系的一个例子是:
#[repr(packed, C)]
struct Packed {
_padding: u8,
unaligned: u32,
}
let packed = Packed {
_padding: 0x00,
unaligned: 0x01020304,
};
// Take the address of a 32-bit integer which is not aligned.
// In contrast to `&packed.unaligned as *const _`, this has no undefined behavior.
let unaligned = std::ptr::addr_of!(packed.unaligned);
let v = unsafe { std::ptr::read_unaligned(unaligned) };
assert_eq!(v, 0x01020304);
直接使用例如访问未对齐的字段但是packed.unaligned
是安全的。
例子
从字节缓冲区中读取一个 usize 值:
use std::mem;
fn read_usize(x: &[u8]) -> usize {
assert!(x.len() >= mem::size_of::<usize>());
let ptr = x.as_ptr() as *const usize;
unsafe { ptr.read_unaligned() }
}
相关用法
- Rust read_to_string用法及代码示例
- Rust read_link用法及代码示例
- Rust read_dir用法及代码示例
- Rust read_volatile用法及代码示例
- Rust read用法及代码示例
- Rust ready用法及代码示例
- Rust rename用法及代码示例
- Rust remove_dir_all用法及代码示例
- Rust remove_file用法及代码示例
- Rust resume_unwind用法及代码示例
- Rust repeat用法及代码示例
- Rust remove_dir用法及代码示例
- Rust remove_var用法及代码示例
- Rust repeat_with用法及代码示例
- Rust replace用法及代码示例
- Rust range用法及代码示例
- Rust UdpSocket.set_multicast_loop_v6用法及代码示例
- Rust i64.overflowing_add_unsigned用法及代码示例
- Rust Box.downcast用法及代码示例
- Rust BTreeMap.last_key_value用法及代码示例
- Rust str.make_ascii_uppercase用法及代码示例
- Rust u128.checked_pow用法及代码示例
- Rust usize.wrapping_mul用法及代码示例
- Rust AtomicU8.fetch_sub用法及代码示例
- Rust PanicInfo.payload用法及代码示例
注:本文由纯净天空筛选整理自rust-lang.org大神的英文原创作品 Function std::ptr::read_unaligned。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。