Rust pointer.offset用法及代碼示例

用法

pub unsafe fn offset(self, count: isize) -> *const T

計算與指針的偏移量。

count以T為單位；例如，count 為 3 表示 3 * size_of::<T>() 字節的指針偏移量。

安全性

如果違反以下任何條件，則結果為未定義行為：

• 起始指針和結果指針都必須位於同一 allocated object 的邊界內或超出末尾一個字節。

• 計算出的偏移量，以字節為單位，不能溢出isize.

• 範圍內的偏移量不能依賴於“wrapping around” 地址空間。也就是說，以字節為單位的無限精度和必須適合使用大小。

編譯器和標準庫通常會嘗試確保分配永遠不會達到需要考慮偏移量的大小。例如，Vec 和 Box 確保它們分配的字節數永遠不會超過 isize::MAX，因此 vec.as_ptr().add(vec.len()) 始終是安全的。

大多數平台根本無法構建這樣的分配。例如，沒有已知的 64 位平台可以為 2⁶³由於page-table 限製或拆分地址空間而導致的字節數。但是，一些 32 位和 16 位平台可能會成功處理超過isize::MAX字節與物理地址擴展之類的東西。因此，直接從分配器或內存映射文件獲取內存可能太大而無法處理此函數。

如果這些約束難以滿足，請考慮使用wrapping_offset。此方法的唯一優點是它可以實現更積極的編譯器優化。

例子

基本用法：

let s: &str = "123";
let ptr: *const u8 = s.as_ptr();

unsafe {
    println!("{}", *ptr.offset(1) as char);
    println!("{}", *ptr.offset(2) as char);
}