本文简要介绍rust语言中 pointer.align_offset
的用法。
用法
pub fn align_offset(self, align: usize) -> usize
计算需要应用于指针以使其与 align
对齐的偏移量。
如果无法对齐指针,则执行返回usize::MAX
。允许实施总是返回usize::MAX
。只有算法的性能取决于在这里获得可用的偏移量,而不是其正确性。
偏移量以T
元素的数量表示,而不是字节数。返回的值可以与wrapping_add
方法一起使用。
无法保证偏移指针不会溢出或超出指针指向的分配。由调用者确保返回的偏移量在除对齐之外的所有方面都是正确的。
Panics
如果 align
不是 power-of-two,则函数会发生Panics。
例子
以u16
访问相邻的u8
let x = [5u8, 6u8, 7u8, 8u8, 9u8];
let ptr = x.as_ptr().add(n) as *const u8;
let offset = ptr.align_offset(align_of::<u16>());
if offset < x.len() - n - 1 {
let u16_ptr = ptr.add(offset) as *const u16;
assert_ne!(*u16_ptr, 500);
} else {
// while the pointer can be aligned via `offset`, it would point
// outside the allocation
}
相关用法
- Rust pointer.add用法及代码示例
- Rust pointer.as_uninit_ref用法及代码示例
- Rust pointer.as_ptr用法及代码示例
- Rust pointer.as_mut_ptr用法及代码示例
- Rust pointer.as_mut用法及代码示例
- Rust pointer.as_ref用法及代码示例
- Rust pointer.offset_from用法及代码示例
- Rust pointer.is_null用法及代码示例
- Rust pointer.get_unchecked用法及代码示例
- Rust pointer.wrapping_add用法及代码示例
- Rust pointer.wrapping_offset用法及代码示例
- Rust pointer.wrapping_sub用法及代码示例
- Rust pointer.len用法及代码示例
- Rust pointer.get_unchecked_mut用法及代码示例
- Rust pointer.sub用法及代码示例
- Rust pointer.set_ptr_value用法及代码示例
- Rust pointer.offset用法及代码示例
- Rust pointer用法及代码示例
- Rust poll_fn用法及代码示例
- Rust park用法及代码示例
- Rust panicking用法及代码示例
- Rust panic用法及代码示例
- Rust println用法及代码示例
- Rust pending用法及代码示例
- Rust print用法及代码示例
注:本文由纯净天空筛选整理自rust-lang.org大神的英文原创作品 pointer.align_offset。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。