use str

String manipulation functions. Error codes: Ok=1 (success), specific errors start at 2

Constants

Functions

fn char_at

Get character code at index.

Signature: (str:str index:i64 -- char_code:i64)!

Example:

"hello" 0 str::char_at! print  // 104 ('h')

fn compare

Compare two strings lexicographically.

Signature: (str1:str str2:str -- result:i64)

Example:

"abc" "abd" str::compare print  // -1

fn concat

Concatenate two strings.

Signature: (str1:str str2:str -- result:str)

Example:

"hello" " world" str::concat print  // "hello world"

fn contains

Check if string contains substring.

Signature: (str:str needle:str -- result:i64)

Example:

"hello" "ell" str::contains print  // 1

fn count

Count non-overlapping occurrences of substring.

Signature: (haystack:str needle:str -- count:i64)

Example:

"ababa" "a" str::count print  // 3
"aaa" "aa" str::count print   // 1 (non-overlapping)

fn ends_with

Check if string ends with suffix.

Signature: (str:str suffix:str -- result:i64)

Example:

"hello" "lo" str::ends_with print  // 1

fn from_char

Create string from character code.

Signature: (char_code:i64 -- str:str)

Example:

65 str::from_char print  // "A"

fn from_ptr

Convert C string pointer to Quadrate string.

Signature: (ptr:ptr -- str:str)

Example:

entries 0 mem::get_ptr str::from_ptr print

fn index_of_from

Find substring starting from position.

Signature: (haystack:str needle:str start:i64 -- index:i64)

Example:

"hello hello" "hello" 1 str::index_of_from print  // 6

fn index_of

Find first occurrence of substring.

Signature: (haystack:str needle:str -- index:i64)

Example:

"hello" "ll" str::index_of print  // 2

fn join

Join array of strings with delimiter.

Signature: (parts:ptr count:i64 delim:str -- result:str)!

Example:

parts count "/" str::join!  // path

fn len

Get string length in bytes.

Signature: (str:str -- len:i64)

Example:

"hello" str::len print  // 5

fn last_index_of

Find last occurrence of substring.

Signature: (haystack:str needle:str -- index:i64)

Example:

"hello hello" "hello" str::last_index_of print  // 6

fn lower

Convert string to lowercase.

Signature: (str:str -- result:str)

Example:

"HELLO" str::lower print  // "hello"

fn repeat

Repeat string n times.

Signature: (str:str n:i64 -- result:str)

Example:

"ab" 3 str::repeat print  // "ababab"

fn reverse

Reverse a string.

Signature: (str:str -- result:str)

Example:

"hello" str::reverse print  // "olleh"

fn replace

Replace all occurrences of substring.

Signature: (str:str old:str new:str -- result:str)!

Example:

"hello" "l" "L" str::replace! print  // "heLLo"

fn sort

Sort array of strings in ascending alphabetical order.

Signature: (arr:ptr count:i64 -- )

Example:

entries count str::sort

fn sort_desc

Sort array of strings in descending alphabetical order.

Signature: (arr:ptr count:i64 -- )

Example:

entries count str::sort_desc

fn split

Split string by delimiter.

Signature: (str:str delim:str -- parts:ptr count:i64)!

Example:

"a,b,c" "," str::split!  // parts=["a","b","c"], count=3

fn starts_with

Check if string starts with prefix.

Signature: (str:str prefix:str -- result:i64)

Example:

"hello" "hel" str::starts_with print  // 1

fn substring

Extract substring.

Signature: (str:str start:i64 length:i64 -- result:str)!

Example:

"hello" 1 3 str::substring! print  // "ell"

fn trim

Remove leading and trailing whitespace.

Signature: (str:str -- result:str)

Example:

"  hello  " str::trim print  // "hello"

fn trim_left

Remove leading whitespace only.

Signature: (str:str -- result:str)

Example:

"  hello  " str::trim_left print  // "hello  "

fn trim_right

Remove trailing whitespace only.

Signature: (str:str -- result:str)

Example:

"  hello  " str::trim_right print  // "  hello"

fn upper

Convert string to uppercase.

Signature: (str:str -- result:str)

Example:

"hello" str::upper print  // "HELLO"