它还提供了 Rust 版本的 memcpy、memmove 和 memset。

偏移量

该库提供的首要操作是 [Ptr::at()]，这是一个通用的指针算术操作。例如，它将接受任何整数作为输入，而不仅仅是 isize（尽管，像 [<*mut T>::offset]，偏移量值必须是有效的，可以转换为 isize）。

let mut ints = [0i32; 6];
let p = Ptr::from(&mut ints).element();

unsafe {
  // Pointer to the 4th element.
  let q = p.at(4);
  q.write(42);

  // Many operations have an `*_at` variant that internally calls .at().
  q.write_at(-1, 55);
}

assert_eq!(ints, [0, 0, 0, 55, 42, 0]);

默认情况下，at() 在元素的多倍上工作。要进行直接字节偏移，可以使用 offset::ByteOffset 类型。

use gep::offset::ByteOffset;

let mut ints = [0i32; 6];
let p = Ptr::from(&mut ints).element();

unsafe {
  p.write_at(ByteOffset(4), 4242);
}

assert_eq!(ints[1], 4242);

use gep::offset::Field;

struct Foo {
  a: i32,
  b: [i32; 3],
}

let foo = Foo { a: 0, b: [1, 2, 3] };

let p = Ptr::from(&foo);
let value = unsafe {
  p.read_at(gep::field!(Foo.b[1]))
};

assert_eq!(value, 2);