Runtime_Support

moduleSource

Available on macOS, Linux, Windows, Wasm·since 0.31.0

#import "Runtime_Support";

Module parameters#

DEFINE_SYSTEM_ENTRY_POINT: bool: Defines the program's system entry point.
DEFINE_INITIALIZATION: bool: Defines the initialization that runs before main.
ENABLE_BACKTRACE_ON_CRASH: bool: Installs the crash handler that prints a backtrace.

Procedures#

General#

__instrumentation_firstsince 0.31.0Source

()

__instrumentation_secondsince 0.31.0Source

()

__jai_runtime_initsince 0.31.0Source

(argc: s32, argv: **u8) -> *#Context

__jai_runtime_finisince 0.31.0Source

(_context: *void)

__element_duplicatesince 0.31.0Source

(start: *u8, num_elements: s64, size: s64)

c_style_strlensince 0.31.0Source

(str: *u8) -> s64

to_stringsince 0.31.0Source

(c_string: *u8) -> string

write_string_unsynchronizedsince 0.31.0Source

(s: string, to_standard_error := false)

write_stringsince 0.31.0Source

(s: string, to_standard_error := false)

write_stringssince 0.31.0Source

(strings: ..string, to_standard_error := false)

android_flush_write_string_buffersince 0.31.0Source

(force := false)

write_nonnegative_numbersince 0.31.0Source

(n: u64, base := 10, to_standard_error := false)

write_numbersince 0.31.0Source

(n: s64, base := 10, to_standard_error := false)

runtime_support_assertion_failedsince 0.31.0Source

(loc: Source_Code_Location, message: string) -> bool

runtime_support_default_loggersince 0.31.0Source

(message: string, data: *void, info: Log_Info)

debug_breaksince 0.31.0Source

()

compile_time_debug_breaksince 0.31.0Source

()

Faults#

__array_bounds_check_failsince 0.31.0Source

(index: s64, limit: s64, line_number: s64, filename: *u8)

__cast_bounds_check_failsince 0.31.0Source

(pre_value: s64, pre_flags: u32, post_value: s64, post_flags: u32, fatal: u8, line_number: s64, filename: *u8)

__null_pointer_check_failsince 0.31.0Source

(index: s64, line_number: s64, filename: *u8)

__arithmetic_overflowsince 0.31.0Source

(left: s64, right: s64, type_code: u16, line_number: s64, filename: *u8)

one_time_initsince 0.31.0Source

(synch_value: *s32, to_insert: Code)

Default heaps#

runtime_support_default_allocator_procsince 0.31.0Source

(mode: Allocator_Mode, requested_size: s64, old_size: s64, old_memory: *void, allocator_data: *void) -> *void

The allocator procedure. It handles .ALLOCATE, .RESIZE, .FREE, .CREATE_HEAP, .DESTROY_HEAP and .IS_THIS_YOURS; allocator_data is the heap, or null for the default one. Allocation returns null when the size is invalid or memory runs out.

memory := cast(*u8) allocator_proc(.ALLOCATE, 8, 0, null, null);
memset(memory, 7, 8);
grown := cast(*u8) allocator_proc(.RESIZE, 64, 8, memory, null);
assert(grown[7] == 7);
allocator_proc(.FREE, 0, 64, grown, null);

↗

Types#

Context_Basestructsince 0.31.0Source

:: struct

context_info: *Type_Info_Struct
thread_index: u32
allocator: := default_allocator
logger: := runtime_support_default_logger
logger_data: *void
log_source_identifier: u64
log_level: Log_Level
temporary_storage: *Temporary_Storage
stack_trace: *Stack_Trace_Node
assertion_failed: := runtime_support_assertion_failed
handling_assertion_failure: := false

Temporary_Storagestructsince 0.31.0Source

:: struct

data: *u8
size: s64
total_bytes_occupied: s64
high_water_mark: s64
last_set_mark_location: Source_Code_Location
implementation_data: [256] u8

Constants#

OS_IS_UNIXsince 0.31.0Source

:: OS == .MACOS || OS == .LINUX || OS == .PS5 || OS == .IOS || OS == .ANDROID