[][src]Function core::intrinsics::offset

#[must_use = "returns a new pointer rather than modifying its argument"]pub unsafe extern "rust-intrinsic" fn offset<T>(
    dst: *const T,
    offset: isize
) -> *const T
🔬 This is a nightly-only experimental API. (core_intrinsics)

intrinsics are unlikely to ever be stabilized, instead they should be used through stabilized interfaces in the rest of the standard library

Calculates the offset from a pointer.

This is implemented as an intrinsic to avoid converting to and from an integer, since the conversion would throw away aliasing information.

Safety

Both the starting and resulting pointer must be either in bounds or one byte past the end of an allocated object. If either pointer is out of bounds or arithmetic overflow occurs then any further use of the returned value will result in undefined behavior.

The stabilized version of this intrinsic is std::pointer::offset.