diff --git a/base/builtin/index.html b/base/builtin/index.html index 720c705cf1..269ed5ffbd 100644 --- a/base/builtin/index.html +++ b/base/builtin/index.html @@ -235,15 +235,28 @@
raw_soa_footer_slice :: proc(array: ^$T/#soa[]$T) -> (footer: ^Raw_SOA_Footer_Slice) {…}+
raw_soa_footer_dynamic_array :: proc(array: ^$T/#soa[dynamic]$T) -> (footer: ^Raw_SOA_Footer_Dynamic_Array) {…}+
make_soa_aligned :: proc($T: typeid/#soa[]T, length: int, alignment: int, allocator := context.allocator, loc := #caller_location) -> (array: T, err: Allocator_Error) #optional_ok {…}+
make_soa_slice :: proc($T: typeid/#soa[]T, length: int, allocator := context.allocator, loc := #caller_location) -> (array: T, err: Allocator_Error) #optional_ok {…}+
copy_slice :: proc "contextless" (dst, src: $T/[]$T) -> int {…}@@ -1481,6 +1505,36 @@
make_soa_dynamic_array :: proc($T: typeid/#soa[dynamic]T, allocator := context.allocator, loc := #caller_location) -> (array: T, err: Allocator_Error) #optional_ok {…}+
make_soa_dynamic_array_len :: proc($T: typeid/#soa[dynamic]T, #any_int length: int, allocator := context.allocator, loc := #caller_location) -> (array: T, err: Allocator_Error) #optional_ok {…}+
make_soa_dynamic_array_len_cap :: proc($T: typeid/#soa[dynamic]T, #any_int length, #any_int capacity: int, allocator := context.allocator, loc := #caller_location) -> (array: T, err: Allocator_Error) #optional_ok {…}+
resize_soa :: proc(array: ^$T/#soa[dynamic]$T, length: int, loc := #caller_location) -> Allocator_Error {…}+
reserve_soa :: proc(array: ^$T/#soa[dynamic]$T, capacity: int, loc := #caller_location) -> Allocator_Error {…}+
copy_from_string :: proc "contextless" (dst: $T/[]$E/u8, src: $S/string) -> int {…}@@ -1494,6 +1548,18 @@
append_soa_elem :: proc(array: ^$T/#soa[dynamic]$T, arg: $T, loc := #caller_location) -> (n: int, err: Allocator_Error) #optional_ok {…}+
append_soa_elems :: proc(array: ^$T/#soa[dynamic]$T, .. args: ..$T, loc := #caller_location) -> (n: int, err: Allocator_Error) #optional_ok {…}+
unordered_remove :: proc(array: ^$T/[dynamic]$T, index: int, loc := #caller_location) {…}@@ -1566,6 +1632,20 @@
unordered_remove_soa :: proc(array: ^$T/#soa[dynamic]$T, index: int, loc := #caller_location) {…}+
unordered_remove_soa
removed the element at the specified index
. It does so by replacing the current end value
+with the old value, and reducing the length of the dynamic array by 1.
Note: This is an O(1) operation.
+Note: If you the elements to remain in their order, use ordered_remove_soa
.
+Note: If the index is out of bounds, this procedure will panic.
pop_front_safe :: proc "contextless" (array: ^$T/[dynamic]$T) -> (res: $T, ok: bool) {…}@@ -1577,6 +1657,19 @@
ordered_remove_soa :: proc(array: ^$T/#soa[dynamic]$T, index: int, loc := #caller_location) {…}+
ordered_remove_soa
removed the element at the specified index
whilst keeping the order of the other elements.
Note: This is an O(N) operation.
+Note: If you the elements do not have to remain in their order, prefer unordered_remove_soa
.
+Note: If the index is out of bounds, this procedure will panic.
delete_string :: proc(str: string, allocator := context.allocator, loc := #caller_location) -> Allocator_Error {…}@@ -1865,12 +1958,6 @@
raw_soa_footer_slice :: proc(array: ^$T/#soa[]$T) -> (footer: ^Raw_SOA_Footer_Slice) {…}-
reserve_dynamic_array :: proc(array: ^$T/[dynamic]$T, capacity: int, loc := #caller_location) -> Allocator_Error {…}@@ -1889,36 +1976,18 @@
raw_soa_footer_dynamic_array :: proc(array: ^$T/#soa[dynamic]$T) -> (footer: ^Raw_SOA_Footer_Dynamic_Array) {…}-
non_zero_resize_dynamic_array :: proc(array: ^$T/[dynamic]$T, length: int, loc := #caller_location) -> Allocator_Error {…}
make_soa_aligned :: proc($T: typeid/#soa[]T, length: int, alignment: int, allocator := context.allocator, loc := #caller_location) -> (array: T, err: Allocator_Error) #optional_ok {…}-
map_insert :: proc(m: ^$T/map[$T]$T, key: $T, value: $T, loc := #caller_location) -> (ptr: ^$T) {…}
make_soa_slice :: proc($T: typeid/#soa[]T, length: int, allocator := context.allocator, loc := #caller_location) -> (array: T, err: Allocator_Error) #optional_ok {…}-
map_upsert :: proc(m: ^$T/map[$T]$T, key: $T, value: $T, loc := #caller_location) -> (prev_key: $T, value_ptr: ^$T, found_previous: bool) {…}@@ -1932,24 +2001,12 @@
make_soa_dynamic_array :: proc($T: typeid/#soa[dynamic]T, allocator := context.allocator, loc := #caller_location) -> (array: T, err: Allocator_Error) #optional_ok {…}-
make_soa_dynamic_array_len :: proc($T: typeid/#soa[dynamic]T, #any_int length: int, allocator := context.allocator, loc := #caller_location) -> (array: T, err: Allocator_Error) #optional_ok {…}-
assert :: proc(condition: bool, message: string = "", loc := #caller_location) {…}@@ -1967,79 +2024,67 @@
unimplemented :: proc(message: string, loc := #caller_location) -> ! {…}
make_soa_dynamic_array_len_cap :: proc($T: typeid/#soa[dynamic]T, #any_int length, #any_int capacity: int, allocator := context.allocator, loc := #caller_location) -> (array: T, err: Allocator_Error) #optional_ok {…}-
resize_soa :: proc(array: ^$T/#soa[dynamic]$T, length: int, loc := #caller_location) -> Allocator_Error {…}-
reserve_soa :: proc(array: ^$T/#soa[dynamic]$T, capacity: int, loc := #caller_location) -> Allocator_Error {…}-
append_soa_elem :: proc(array: ^$T/#soa[dynamic]$T, arg: $T, loc := #caller_location) -> (n: int, err: Allocator_Error) #optional_ok {…}+
make_soa :: proc{ + make_soa_slice, + make_soa_dynamic_array, + make_soa_dynamic_array_len, + make_soa_dynamic_array_len_cap, +} +
append_soa_elems :: proc(array: ^$T/#soa[dynamic]$T, .. args: ..$T, loc := #caller_location) -> (n: int, err: Allocator_Error) #optional_ok {…}+
copy :: proc{ + copy_slice, + copy_from_string, +} +
copy
is a built-in procedure that copies elements from a source slice src
to a destination slice/string dst
.
+The source and destination may overlap. Copy returns the number of elements copied, which will be the minimum
+of len(src) and len(dst).
unordered_remove_soa :: proc(array: ^$T/#soa[dynamic]$T, index: int, loc := #caller_location) {…}+
append_soa :: proc{ + append_soa_elem, + append_soa_elems, +} +
unordered_remove_soa
removed the element at the specified index
. It does so by replacing the current end value
-with the old value, and reducing the length of the dynamic array by 1.
Note: This is an O(1) operation.
-Note: If you the elements to remain in their order, use ordered_remove_soa
.
-Note: If the index is out of bounds, this procedure will panic.
The append_soa built-in procedure appends elements to the end of an #soa dynamic array
ordered_remove_soa :: proc(array: ^$T/#soa[dynamic]$T, index: int, loc := #caller_location) {…}+
delete_soa :: proc{ + delete_soa_slice, + delete_soa_dynamic_array, +} +
ordered_remove_soa
removed the element at the specified index
whilst keeping the order of the other elements.
Note: This is an O(N) operation.
-Note: If you the elements do not have to remain in their order, prefer unordered_remove_soa
.
-Note: If the index is out of bounds, this procedure will panic.
copy :: proc{ - copy_slice, - copy_from_string, +clear_soa :: proc{ + clear_soa_dynamic_array, }
copy
is a built-in procedure that copies elements from a source slice src
to a destination slice/string dst
.
-The source and destination may overlap. Copy returns the number of elements copied, which will be the minimum
-of len(src) and len(dst).
make_soa :: proc{ - make_soa_slice, - make_soa_dynamic_array, - make_soa_dynamic_array_len, - make_soa_dynamic_array_len_cap, -} --
append_soa :: proc{ - append_soa_elem, - append_soa_elems, -} --
The append_soa built-in procedure appends elements to the end of an #soa dynamic array
-delete_soa :: proc{ - delete_soa_slice, - delete_soa_dynamic_array, -} --
clear_soa :: proc{ - clear_soa_dynamic_array, -} --