arith_offset in core::intrinsics - Rust
Description: Calculates the offset from a pointer, potentially wrapping.
Keywords: rust, rustlang, rust-lang, arith_offset

# Function core::intrinsics::arith_offset
[−][src]

    #[must_use = "returns a new pointer rather than modifying its argument"]
    pub unsafe extern "rust-intrinsic" fn arith_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, potentially wrapping.

This is implemented as an intrinsic to avoid converting to and from an integer, since the conversion inhibits certain optimizations.

# Safety

Unlike the `offset` intrinsic, this intrinsic does not restrict the resulting pointer to point into or one byte past the end of an allocated object, and it wraps with two’s complement arithmetic. The resulting value is not necessarily valid to be used to actually access memory.

The stabilized version of this intrinsic is `pointer::wrapping_offset`.