Skip to main content

Module intrinsics

Module intrinsics 

Source
🔬This is a nightly-only experimental API. (core_intrinsics)
Expand description

Compiler intrinsics.

The functions in this module are implementation details of core and should not be used outside of the standard library. We generally provide access to intrinsics via stable wrapper functions. Use these instead.

These are the imports making intrinsics available to Rust code. The actual implementations live in the compiler. Some of these intrinsics are lowered to MIR in https://github.com/rust-lang/rust/blob/HEAD/compiler/rustc_mir_transform/src/lower_intrinsics.rs. The remaining intrinsics are implemented for the LLVM backend in https://github.com/rust-lang/rust/blob/HEAD/compiler/rustc_codegen_ssa/src/mir/intrinsic.rs and https://github.com/rust-lang/rust/blob/HEAD/compiler/rustc_codegen_llvm/src/intrinsic.rs, and for const evaluation in https://github.com/rust-lang/rust/blob/HEAD/compiler/rustc_const_eval/src/interpret/intrinsics.rs.

§Const intrinsics

In order to make an intrinsic unstable usable at compile-time, copy the implementation from https://github.com/rust-lang/miri/blob/master/src/intrinsics to https://github.com/rust-lang/rust/blob/HEAD/compiler/rustc_const_eval/src/interpret/intrinsics.rs and make the intrinsic declaration below a const fn. This should be done in coordination with wg-const-eval.

If an intrinsic is supposed to be used from a const fn with a rustc_const_stable attribute, #[rustc_intrinsic_const_stable_indirect] needs to be added to the intrinsic. Such a change requires T-lang approval, because it may bake a feature into the language that cannot be replicated in user code without compiler support.

§Volatiles

The volatile intrinsics provide operations intended to act on I/O memory, which are guaranteed to not be reordered by the compiler across other volatile intrinsics. See read_volatile and write_volatile.

§Atomics

The atomic intrinsics provide common atomic operations on machine words, with multiple possible memory orderings. See the atomic types docs for details.

§Unwinding

Rust intrinsics may, in general, unwind. If an intrinsic can never unwind, add the #[rustc_nounwind] attribute so that the compiler can make use of this fact.

However, even for intrinsics that may unwind, rustc assumes that a Rust intrinsics will never initiate a foreign (non-Rust) unwind, and thus for panic=abort we can always assume that these intrinsics cannot unwind.

Modules§

fallbackExperimental
gpuExperimental
Intrinsics for GPU targets.
mirExperimental
Rustc internal tooling for hand-writing MIR.
simdExperimental
SIMD compiler intrinsics.

Enums§

AtomicOrderingExperimentalvalidated
A type for atomic ordering parameters for intrinsics. This is a separate type from atomic::Ordering so that we can make it ConstParamTy and fix the values used here without a risk of leaking that to stable code.

Functions§

copyDeprecatedvalidated
This is an accidentally-stable alias to ptr::copy; use that instead.
copy_nonoverlappingDeprecatedvalidated
This is an accidentally-stable alias to ptr::copy_nonoverlapping; use that instead.
transmuteDeprecatedvalidated
Reinterprets the bits of a value of one type as another type.
write_bytesDeprecatedvalidated
This is an accidentally-stable alias to ptr::write_bytes; use that instead.
abortExperimentalvalidated
Aborts the execution of the process.
add_with_overflowExperimentalvalidated
Performs checked integer addition.
aggregate_raw_ptrExperimentalvalidated
Lowers in MIR to Rvalue::Aggregate with AggregateKind::RawPtr.
align_ofExperimentalvalidated
The minimum alignment of a type.
align_of_valExperimentalvalidated
The required alignment of the referenced value.
arith_offsetExperimentalvalidated
Calculates the offset from a pointer, potentially wrapping.
assert_inhabitedExperimentalvalidated
A guard for unsafe functions that cannot ever be executed if T is uninhabited: This will statically either panic, or do nothing. It does not guarantee to ever panic, and should only be called if an assertion failure will imply language UB in the following code.
assert_mem_uninitialized_validExperimentalvalidated
A guard for std::mem::uninitialized. This will statically either panic, or do nothing. It does not guarantee to ever panic, and should only be called if an assertion failure will imply language UB in the following code.
assert_zero_validExperimentalvalidated
A guard for unsafe functions that cannot ever be executed if T does not permit zero-initialization: This will statically either panic, or do nothing. It does not guarantee to ever panic, and should only be called if an assertion failure will imply language UB in the following code.
assumeExperimentalvalidated
Informs the optimizer that a condition is always true. If the condition is false, the behavior is undefined.
atomic_andExperimentalvalidated
Bitwise and with the current value, returning the previous value. T must be an integer or pointer type. U must be the same as T if that is an integer type, or usize if T is a pointer type.
atomic_cxchgExperimentalvalidated
Stores a value if the current value is the same as the old value. T must be an integer or pointer type.
atomic_cxchgweakExperimentalvalidated
Stores a value if the current value is the same as the old value. T must be an integer or pointer type. The comparison may spuriously fail.
atomic_fenceExperimentalvalidated
An atomic fence.
atomic_loadExperimentalvalidated
Loads the current value of the pointer. T must be an integer or pointer type.
atomic_maxExperimentalvalidated
Maximum with the current value using a signed comparison. T must be a signed integer type.
atomic_minExperimentalvalidated
Minimum with the current value using a signed comparison. T must be a signed integer type.
atomic_nandExperimentalvalidated
Bitwise nand with the current value, returning the previous value. T must be an integer or pointer type. U must be the same as T if that is an integer type, or usize if T is a pointer type.
atomic_orExperimentalvalidated
Bitwise or with the current value, returning the previous value. T must be an integer or pointer type. U must be the same as T if that is an integer type, or usize if T is a pointer type.
atomic_singlethreadfenceExperimentalvalidated
An atomic fence for synchronization within a single thread.
atomic_storeExperimentalvalidated
Stores the value at the specified memory location. T must be an integer or pointer type.
atomic_umaxExperimentalvalidated
Maximum with the current value using an unsigned comparison. T must be an unsigned integer type.
atomic_uminExperimentalvalidated
Minimum with the current value using an unsigned comparison. T must be an unsigned integer type.
atomic_xaddExperimentalvalidated
Adds to the current value, returning the previous value. T must be an integer or pointer type. U must be the same as T if that is an integer type, or usize if T is a pointer type.
atomic_xchgExperimentalvalidated
Stores the value at the specified memory location, returning the old value. T must be an integer or pointer type.
atomic_xorExperimentalvalidated
Bitwise xor with the current value, returning the previous value. T must be an integer or pointer type. U must be the same as T if that is an integer type, or usize if T is a pointer type.
atomic_xsubExperimentalvalidated
Subtract from the current value, returning the previous value. T must be an integer or pointer type. U must be the same as T if that is an integer type, or usize if T is a pointer type.
autodiffExperimentalvalidated
Generates the LLVM body for the automatic differentiation of f using Enzyme, with df as the derivative function and args as its arguments.
bitreverseExperimentalvalidated
Reverses the bits in an integer type T.
black_boxExperimentalvalidated
See documentation of std::hint::black_box for details.
breakpointExperimentalvalidated
Executes a breakpoint trap, for inspection by a debugger.
bswapExperimentalvalidated
Reverses the bytes in an integer type T.
caller_locationExperimentalvalidated
Gets a reference to a static Location indicating where it was called.
carrying_mul_addExperimentalvalidated
Performs full-width multiplication and addition with a carry: multiplier * multiplicand + addend + carry.
carryless_mulExperimentalvalidated
Carryless multiply.
catch_unwindExperimentalvalidated
Rust’s “try catch” construct for unwinding. Invokes the function pointer try_fn with the data pointer data, and calls catch_fn if unwinding occurs while try_fn runs. Returns 1 if unwinding occurred and catch_fn was called; returns 0 otherwise.
ceilf16Experimentalvalidated
Returns the smallest integer greater than or equal to an f16.
ceilf32Experimentalvalidated
Returns the smallest integer greater than or equal to an f32.
ceilf64Experimentalvalidated
Returns the smallest integer greater than or equal to an f64.
ceilf128Experimentalvalidated
Returns the smallest integer greater than or equal to an f128.
cold_pathExperimentalvalidated
Hints to the compiler that current code path is cold.
compare_bytesExperimentalvalidated
Lexicographically compare [left, left + bytes) and [right, right + bytes) as unsigned bytes, returning negative if left is less, zero if all the bytes match, or positive if left is greater.
const_allocateExperimental
Allocates a block of memory at compile time. At runtime, just returns a null pointer.
const_deallocateExperimental
Deallocates a memory which allocated by intrinsics::const_allocate at compile time. At runtime, it does nothing.
const_eval_selectExperimentalvalidated
Selects which function to call depending on the context.
const_make_globalExperimentalvalidated
Convert the allocation this pointer points to into immutable global memory. The pointer must point to the beginning of a heap allocation. This operation only makes sense during compile time. At runtime, it does nothing.
contract_check_ensuresExperimental
Check if the post-condition cond has been met.
contract_check_requiresExperimental
Check if the pre-condition cond has been met.
copysignf16Experimentalvalidated
Copies the sign from y to x for f16 values.
copysignf32Experimentalvalidated
Copies the sign from y to x for f32 values.
copysignf64Experimentalvalidated
Copies the sign from y to x for f64 values.
copysignf128Experimentalvalidated
Copies the sign from y to x for f128 values.
cosf16Experimentalvalidated
Returns the cosine of an f16.
cosf32Experimentalvalidated
Returns the cosine of an f32.
cosf64Experimentalvalidated
Returns the cosine of an f64.
cosf128Experimentalvalidated
Returns the cosine of an f128.
ctlzExperimentalvalidated
Returns the number of leading unset bits (zeroes) in an integer type T.
ctlz_nonzeroExperimentalvalidated
Like ctlz, but extra-unsafe as it returns undef when given an x with value 0.
ctpopExperimentalvalidated
Returns the number of bits set in an integer type T
cttzExperimentalvalidated
Returns the number of trailing unset bits (zeroes) in an integer type T.
cttz_nonzeroExperimentalvalidated
Like cttz, but extra-unsafe as it returns undef when given an x with value 0.
discriminant_valueExperimentalvalidated
Returns the value of the discriminant for the variant in ‘v’; if T has no discriminant, returns 0.
disjoint_bitorExperimentalvalidated
Combine two values which have no bits in common.
exact_divExperimentalvalidated
Performs an exact division, resulting in undefined behavior where x % y != 0 or y == 0 or x == T::MIN && y == -1
exp2f16Experimentalvalidated
Returns 2 raised to the power of an f16.
exp2f32Experimentalvalidated
Returns 2 raised to the power of an f32.
exp2f64Experimentalvalidated
Returns 2 raised to the power of an f64.
exp2f128Experimentalvalidated
Returns 2 raised to the power of an f128.
expf16Experimentalvalidated
Returns the exponential of an f16.
expf32Experimentalvalidated
Returns the exponential of an f32.
expf64Experimentalvalidated
Returns the exponential of an f64.
expf128Experimentalvalidated
Returns the exponential of an f128.
fabsExperimentalvalidated
Returns the absolute value of a floating-point value.
fadd_algebraicExperimentalvalidated
Float addition that allows optimizations based on algebraic rules.
fadd_fastExperimentalvalidated
Float addition that allows optimizations based on algebraic rules. Requires that inputs and output of the operation are finite, causing UB otherwise.
fdiv_algebraicExperimentalvalidated
Float division that allows optimizations based on algebraic rules.
fdiv_fastExperimentalvalidated
Float division that allows optimizations based on algebraic rules. Requires that inputs and output of the operation are finite, causing UB otherwise.
field_offsetExperimentalvalidated
The offset of a field queried by its field representing type.
float_to_int_uncheckedExperimentalvalidated
Converts with LLVM’s fptoui/fptosi, which may return undef for values out of range (https://github.com/rust-lang/rust/issues/10184)
floorf16Experimentalvalidated
Returns the largest integer less than or equal to an f16.
floorf32Experimentalvalidated
Returns the largest integer less than or equal to an f32.
floorf64Experimentalvalidated
Returns the largest integer less than or equal to an f64.
floorf128Experimentalvalidated
Returns the largest integer less than or equal to an f128.
fmaf16Experimentalvalidated
Returns a * b + c for f16 values.
fmaf32Experimentalvalidated
Returns a * b + c for f32 values.
fmaf64Experimentalvalidated
Returns a * b + c for f64 values.
fmaf128Experimentalvalidated
Returns a * b + c for f128 values.
fmul_algebraicExperimentalvalidated
Float multiplication that allows optimizations based on algebraic rules.
fmul_fastExperimentalvalidated
Float multiplication that allows optimizations based on algebraic rules. Requires that inputs and output of the operation are finite, causing UB otherwise.
fmuladdf16Experimentalvalidated
Returns a * b + c for f16 values, non-deterministically executing either a fused multiply-add or two operations with rounding of the intermediate result.
fmuladdf32Experimentalvalidated
Returns a * b + c for f32 values, non-deterministically executing either a fused multiply-add or two operations with rounding of the intermediate result.
fmuladdf64Experimentalvalidated
Returns a * b + c for f64 values, non-deterministically executing either a fused multiply-add or two operations with rounding of the intermediate result.
fmuladdf128Experimentalvalidated
Returns a * b + c for f128 values, non-deterministically executing either a fused multiply-add or two operations with rounding of the intermediate result.
forgetExperimentalvalidated
Moves a value out of scope without running drop glue.
frem_algebraicExperimentalvalidated
Float remainder that allows optimizations based on algebraic rules.
frem_fastExperimentalvalidated
Float remainder that allows optimizations based on algebraic rules. Requires that inputs and output of the operation are finite, causing UB otherwise.
fsub_algebraicExperimentalvalidated
Float subtraction that allows optimizations based on algebraic rules.
fsub_fastExperimentalvalidated
Float subtraction that allows optimizations based on algebraic rules. Requires that inputs and output of the operation are finite, causing UB otherwise.
is_val_statically_knownExperimentalvalidated
Returns whether the argument’s value is statically known at compile-time.
likelyExperimentalvalidated
Hints to the compiler that branch condition is likely to be true. Returns the value passed to it.
log2f16Experimentalvalidated
Returns the base 2 logarithm of an f16.
log2f32Experimentalvalidated
Returns the base 2 logarithm of an f32.
log2f64Experimentalvalidated
Returns the base 2 logarithm of an f64.
log2f128Experimentalvalidated
Returns the base 2 logarithm of an f128.
log10f16Experimentalvalidated
Returns the base 10 logarithm of an f16.
log10f32Experimentalvalidated
Returns the base 10 logarithm of an f32.
log10f64Experimentalvalidated
Returns the base 10 logarithm of an f64.
log10f128Experimentalvalidated
Returns the base 10 logarithm of an f128.
logf16Experimentalvalidated
Returns the natural logarithm of an f16.
logf32Experimentalvalidated
Returns the natural logarithm of an f32.
logf64Experimentalvalidated
Returns the natural logarithm of an f64.
logf128Experimentalvalidated
Returns the natural logarithm of an f128.
maximum_number_nsz_f16Experimental
Returns the maximum of two f16 values, ignoring NaN.
maximum_number_nsz_f32Experimentalvalidated
Returns the maximum of two f32 values, ignoring NaN.
maximum_number_nsz_f64Experimental
Returns the maximum of two f64 values, ignoring NaN.
maximum_number_nsz_f128Experimental
Returns the maximum of two f128 values, ignoring NaN.
maximumf16Experimental
Returns the maximum of two f16 values, propagating NaN.
maximumf32Experimental
Returns the maximum of two f32 values, propagating NaN.
maximumf64Experimental
Returns the maximum of two f64 values, propagating NaN.
maximumf128Experimental
Returns the maximum of two f128 values, propagating NaN.
minimum_number_nsz_f16Experimental
Returns the minimum of two f16 values, ignoring NaN.
minimum_number_nsz_f32Experimentalvalidated
Returns the minimum of two f32 values, ignoring NaN.
minimum_number_nsz_f64Experimental
Returns the minimum of two f64 values, ignoring NaN.
minimum_number_nsz_f128Experimental
Returns the minimum of two f128 values, ignoring NaN.
minimumf16Experimental
Returns the minimum of two f16 values, propagating NaN.
minimumf32Experimental
Returns the minimum of two f32 values, propagating NaN.
minimumf64Experimental
Returns the minimum of two f64 values, propagating NaN.
minimumf128Experimental
Returns the minimum of two f128 values, propagating NaN.
mul_with_overflowExperimentalvalidated
Performs checked integer multiplication
needs_dropExperimentalvalidated
Returns true if the actual type given as T requires drop glue; returns false if the actual type provided for T implements Copy.
nontemporal_storeExperimentalvalidated
Emits a nontemporal store, which gives a hint to the CPU that the data should not be held in cache. Except for performance, this is fully equivalent to ptr.write(val).
offloadExperimentalvalidated
Generates the LLVM body of a wrapper function to offload a kernel f.
offsetExperimentalvalidated
Calculates the offset from a pointer.
offset_ofExperimentalvalidated
The offset of a field inside a type.
overflow_checksExperimentalvalidated
Returns whether we should perform some overflow-checking at runtime. This eventually evaluates to cfg!(overflow_checks), but behaves different from cfg! when mixing crates built with different flags: if the crate has overflow checks enabled or carries the #[rustc_inherit_overflow_checks] attribute, evaluation is delayed until monomorphization (or until the call gets inlined into a crate that does not delay evaluation further); otherwise it can happen any time.
powf16Experimentalvalidated
Raises an f16 to an f16 power.
powf32Experimentalvalidated
Raises an f32 to an f32 power.
powf64Experimentalvalidated
Raises an f64 to an f64 power.
powf128Experimentalvalidated
Raises an f128 to an f128 power.
powif16Experimentalvalidated
Raises an f16 to an integer power.
powif32Experimentalvalidated
Raises an f32 to an integer power.
powif64Experimentalvalidated
Raises an f64 to an integer power.
powif128Experimentalvalidated
Raises an f128 to an integer power.
prefetch_read_dataExperimental
The prefetch intrinsic is a hint to the code generator to insert a prefetch instruction for the given address if supported; otherwise, it is a no-op. Prefetches have no effect on the behavior of the program but can change its performance characteristics.
prefetch_read_instructionExperimental
The prefetch intrinsic is a hint to the code generator to insert a prefetch instruction for the given address if supported; otherwise, it is a no-op. Prefetches have no effect on the behavior of the program but can change its performance characteristics.
prefetch_write_dataExperimental
The prefetch intrinsic is a hint to the code generator to insert a prefetch instruction for the given address if supported; otherwise, it is a no-op. Prefetches have no effect on the behavior of the program but can change its performance characteristics.
prefetch_write_instructionExperimental
The prefetch intrinsic is a hint to the code generator to insert a prefetch instruction for the given address if supported; otherwise, it is a no-op. Prefetches have no effect on the behavior of the program but can change its performance characteristics.
ptr_guaranteed_cmpExperimentalvalidated
See documentation of <*const T>::guaranteed_eq for details. Returns 2 if the result is unknown. Returns 1 if the pointers are guaranteed equal. Returns 0 if the pointers are guaranteed inequal.
ptr_maskExperimentalvalidated
Masks out bits of the pointer according to a mask.
ptr_metadataExperimentalvalidated
Lowers in MIR to Rvalue::UnaryOp with UnOp::PtrMetadata.
ptr_offset_fromExperimentalvalidated
See documentation of <*const T>::offset_from for details.
ptr_offset_from_unsignedExperimentalvalidated
See documentation of <*const T>::offset_from_unsigned for details.
raw_eqExperimentalvalidated
Determines whether the raw bytes of the two values are equal.
read_via_copyExperimentalvalidated
This is an implementation detail of crate::ptr::read and should not be used anywhere else. See its comments for why this exists.
rotate_leftExperimentalvalidated
Performs rotate left.
rotate_rightExperimentalvalidated
Performs rotate right.
round_ties_even_f16Experimentalvalidated
Returns the nearest integer to an f16. Rounds half-way cases to the number with an even least significant digit.
round_ties_even_f32Experimentalvalidated
Returns the nearest integer to an f32. Rounds half-way cases to the number with an even least significant digit.
round_ties_even_f64Experimentalvalidated
Returns the nearest integer to an f64. Rounds half-way cases to the number with an even least significant digit.
round_ties_even_f128Experimentalvalidated
Returns the nearest integer to an f128. Rounds half-way cases to the number with an even least significant digit.
roundf16Experimentalvalidated
Returns the nearest integer to an f16. Rounds half-way cases away from zero.
roundf32Experimentalvalidated
Returns the nearest integer to an f32. Rounds half-way cases away from zero.
roundf64Experimentalvalidated
Returns the nearest integer to an f64. Rounds half-way cases away from zero.
roundf128Experimentalvalidated
Returns the nearest integer to an f128. Rounds half-way cases away from zero.
rustc_peekExperimentalvalidated
Magic intrinsic that derives its meaning from attributes attached to the function.
saturating_addExperimentalvalidated
Computes a + b, saturating at numeric bounds.
saturating_subExperimentalvalidated
Computes a - b, saturating at numeric bounds.
select_unpredictableExperimentalvalidated
Returns either true_val or false_val depending on condition b with a hint to the compiler that this condition is unlikely to be correctly predicted by a CPU’s branch predictor (e.g. a binary search).
sinf16Experimentalvalidated
Returns the sine of an f16.
sinf32Experimentalvalidated
Returns the sine of an f32.
sinf64Experimentalvalidated
Returns the sine of an f64.
sinf128Experimentalvalidated
Returns the sine of an f128.
size_ofExperimentalvalidated
The size of a type in bytes.
size_of_valExperimentalvalidated
The size of the referenced value in bytes.
slice_get_uncheckedExperimentalvalidated
Projects to the index-th element of slice_ptr, as the same kind of pointer as the slice was provided – so &mut [T] → &mut T, &[T] → &T, *mut [T] → *mut T, or *const [T] → *const T – without a bounds check.
sqrtf16Experimentalvalidated
Returns the square root of an f16
sqrtf32Experimentalvalidated
Returns the square root of an f32
sqrtf64Experimentalvalidated
Returns the square root of an f64
sqrtf128Experimentalvalidated
Returns the square root of an f128
sub_with_overflowExperimentalvalidated
Performs checked integer subtraction
three_way_compareExperimentalvalidated
Does a three-way comparison between the two arguments, which must be of character or integer (signed or unsigned) type.
transmute_uncheckedExperimentalvalidated
Like transmute, but even less checked at compile-time: rather than giving an error for size_of::<Src>() != size_of::<Dst>(), it’s Undefined Behavior at runtime.
truncf16Experimentalvalidated
Returns the integer part of an f16.
truncf32Experimentalvalidated
Returns the integer part of an f32.
truncf64Experimentalvalidated
Returns the integer part of an f64.
truncf128Experimentalvalidated
Returns the integer part of an f128.
type_idExperimentalvalidated
Gets an identifier which is globally unique to the specified type. This function will return the same value for a type regardless of whichever crate it is invoked in.
type_id_eqExperimentalvalidated
Tests (at compile-time) if two crate::any::TypeId instances identify the same type. This is necessary because at const-eval time the actual discriminating data is opaque and cannot be inspected directly.
type_id_vtableExperimental
Check if a type represented by a TypeId implements a trait represented by a TypeId. It can only be called at compile time, the backends do not implement it. If it implements the trait the dyn metadata gets returned for vtable access.
type_nameExperimentalvalidated
Gets a static string slice containing the name of a type.
type_ofExperimental
Compute the type information of a concrete type. It can only be called at compile time, the backends do not implement it.
typed_swap_nonoverlappingExperimentalvalidated
Non-overlapping typed swap of a single value.
ub_checksExperimentalvalidated
Returns whether we should perform some UB-checking at runtime. This eventually evaluates to cfg!(ub_checks), but behaves different from cfg! when mixing crates built with different flags: if the crate has UB checks enabled or carries the #[rustc_preserve_ub_checks] attribute, evaluation is delayed until monomorphization (or until the call gets inlined into a crate that does not delay evaluation further); otherwise it can happen any time.
unaligned_volatile_loadExperimentalvalidated
Performs a volatile load from the src pointer The pointer is not required to be aligned.
unaligned_volatile_storeExperimentalvalidated
Performs a volatile store to the dst pointer. The pointer is not required to be aligned.
unchecked_addExperimentalvalidated
Returns the result of an unchecked addition, resulting in undefined behavior when x + y > T::MAX or x + y < T::MIN.
unchecked_divExperimentalvalidated
Performs an unchecked division, resulting in undefined behavior where y == 0 or x == T::MIN && y == -1
unchecked_funnel_shlExperimentalvalidated
Funnel Shift left.
unchecked_funnel_shrExperimentalvalidated
Funnel Shift right.
unchecked_mulExperimentalvalidated
Returns the result of an unchecked multiplication, resulting in undefined behavior when x * y > T::MAX or x * y < T::MIN.
unchecked_remExperimentalvalidated
Returns the remainder of an unchecked division, resulting in undefined behavior when y == 0 or x == T::MIN && y == -1
unchecked_shlExperimentalvalidated
Performs an unchecked left shift, resulting in undefined behavior when y < 0 or y >= N, where N is the width of T in bits.
unchecked_shrExperimentalvalidated
Performs an unchecked right shift, resulting in undefined behavior when y < 0 or y >= N, where N is the width of T in bits.
unchecked_subExperimentalvalidated
Returns the result of an unchecked subtraction, resulting in undefined behavior when x - y > T::MAX or x - y < T::MIN.
unlikelyExperimentalvalidated
Hints to the compiler that branch condition is likely to be false. Returns the value passed to it.
unreachableExperimentalvalidated
Informs the optimizer that this point in the code is not reachable, enabling further optimizations.
va_argExperimentalvalidated
Loads an argument of type T from the va_list ap and increment the argument ap points to.
va_copyExperimental
Duplicates a variable argument list. The returned list is initially at the same position as the one in src, but can be advanced independently.
va_endExperimental
Destroy the variable argument list ap after initialization with va_start (part of the desugaring of ...) or va_copy.
variant_countExperimentalvalidated
Returns the number of variants of the type T cast to a usize; if T has no variants, returns 0. Uninhabited variants will be counted.
volatile_copy_memoryExperimentalvalidated
Equivalent to the appropriate llvm.memmove.p0i8.0i8.* intrinsic, with a size of count * size_of::<T>() and an alignment of align_of::<T>().
volatile_copy_nonoverlapping_memoryExperimentalvalidated
Equivalent to the appropriate llvm.memcpy.p0i8.0i8.* intrinsic, with a size of count * size_of::<T>() and an alignment of align_of::<T>().
volatile_loadExperimentalvalidated
Performs a volatile load from the src pointer.
volatile_set_memoryExperimentalvalidated
Equivalent to the appropriate llvm.memset.p0i8.* intrinsic, with a size of count * size_of::<T>() and an alignment of align_of::<T>().
volatile_storeExperimentalvalidated
Performs a volatile store to the dst pointer.
vtable_alignExperimentalvalidated
The intrinsic will return the alignment stored in that vtable.
vtable_sizeExperimentalvalidated
The intrinsic will return the size stored in that vtable.
wrapping_addExperimentalvalidated
Returns (a + b) mod 2N, where N is the width of T in bits.
wrapping_mulExperimentalvalidated
Returns (a * b) mod 2N, where N is the width of T in bits.
wrapping_subExperimentalvalidated
Returns (a - b) mod 2N, where N is the width of T in bits.
write_via_moveExperimentalvalidated
This is an implementation detail of crate::ptr::write and should not be used anywhere else. See its comments for why this exists.