intrinsics

import std::core::intrinsics; — in the prelude · source

core::intrinsics declares the operations the compiler lowers directly to LLVM rather than to a call. Nothing here has a body, and the list below is abbreviated by width where a family repeats.

intrinsic function malloc(size: u64) -> void*;
intrinsic function realloc(ptr: void*, new_size: u64) -> void*;
intrinsic function free(ptr: void*) -> void;
intrinsic function ptr_diff(a: void*, b: void*) -> i64;

intrinsic function panic(message: string, file: string, line: u32) -> never;
intrinsic function try_catch(body: void*, data: void*) -> boolean;
intrinsic function trap() -> never;
intrinsic function debugtrap() -> void;
intrinsic function frame_address(level: u32) -> void*;
intrinsic function return_address(level: u32) -> void*;

intrinsic function atomic_fence(order: u32) -> void;
intrinsic function atomic_load_u8(ptr: u8*, order: u32) -> u8;                 // ... _u32, _u64
intrinsic function atomic_store_u8(ptr: u8*, value: u8, order: u32) -> void;   // ... _u32, _u64
intrinsic function atomic_add_u8(ptr: u8*, value: u8, order: u32) -> u8;       // ... _u32, _u64
intrinsic function atomic_sub_u8(ptr: u8*, value: u8, order: u32) -> u8;       // ... _u32, _u64
intrinsic function atomic_and_u8(ptr: u8*, value: u8, order: u32) -> u8;       // ... _u32, _u64
intrinsic function atomic_or_u8(ptr: u8*, value: u8, order: u32) -> u8;        // ... _u32, _u64
intrinsic function atomic_xor_u8(ptr: u8*, value: u8, order: u32) -> u8;       // ... _u32, _u64
intrinsic function atomic_swap_u8(ptr: u8*, value: u8, order: u32) -> u8;      // ... _u32, _u64
intrinsic function atomic_cmpxchg_u8(ptr: u8*, cmp: u8, new: u8,
                                     succ: u32, fail: u32, out_ok: boolean*) -> u8;   // ... _u32, _u64

intrinsic function fpclass(value: f64, test: i32) -> boolean;
intrinsic function fabs64(value: f64) -> f64;
intrinsic function fabs32(value: f32) -> f32;
intrinsic function floor64(value: f64) -> f64;
intrinsic function ceil64(value: f64) -> f64;
intrinsic function ftrunc64(value: f64) -> f64;
intrinsic function round64(value: f64) -> f64;
intrinsic function copysign64(magnitude: f64, sign: f64) -> f64;
intrinsic function sqrt64(value: f64) -> f64;
intrinsic function sqrt32(value: f32) -> f32;
intrinsic function fma64(x: f64, y: f64, z: f64) -> f64;

intrinsic function dirent_name(entry: void*) -> string;
intrinsic function dirent_type(entry: void*) -> i32;

intrinsic function va_arg_i32(args: void*) -> i32;       // ... _u32, _i64, _u64, _f64, _ptr, _string

The memory intrinsics back alloc and core::mem; the atomics back sync::atomic; the float intrinsics back math; and the va_arg_* family backs VaArgs::next. memcpy, memset, sizeof, and alignof are keywords rather than intrinsics and need no declaration. You will rarely call any of these directly — the typed wrappers exist so you don't have to.

Intrinsics#

Intrinsics