Rust pointer.align_offset用法及代码示例

本文简要介绍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-lang.org大神的英文原创作品 pointer.align_offset。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。