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"

fn is_empty

Check if string is empty.

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

Example:

"" str::is_empty print     // 1
"hello" str::is_empty print // 0

fn is_blank

Check if string is empty or contains only whitespace.

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

Example:

"   " str::is_blank print  // 1
"hi" str::is_blank print   // 0

fn equals_ignore_case

Case-insensitive string comparison.

Signature: (a:str b:str -- result:i64)

Example:

"Hello" "HELLO" str::equals_ignore_case print  // 1

fn pad_left

Left-pad string to target length.

Signature: (s:str len:i64 ch:str -- result:str)

Example:

"42" 5 "0" str::pad_left print  // "00042"

fn pad_right

Right-pad string to target length.

Signature: (s:str len:i64 ch:str -- result:str)

Example:

"hi" 5 "." str::pad_right print  // "hi..."

fn center

Center string with padding on both sides.

Signature: (s:str len:i64 ch:str -- result:str)

Example:

"hi" 6 "-" str::center print  // "--hi--"

fn capitalize

Capitalize first character, lowercase the rest.

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

Example:

"hELLO" str::capitalize print  // "Hello"

fn title

Title case - capitalize first letter of each word.

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

Example:

"hello world" str::title print  // "Hello World"

fn trim_prefix

Remove prefix if present.

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

Example:

"hello" "hel" str::trim_prefix print  // "lo"

fn trim_suffix

Remove suffix if present.

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

Example:

"hello" "lo" str::trim_suffix print  // "hel"

fn replace_first

Replace first occurrence only.

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

Example:

"abab" "ab" "X" str::replace_first print  // "Xab"

fn insert

Insert string at position.

Signature: (s:str pos:i64 ins:str -- result:str)

Example:

"hello" 2 "XX" str::insert print  // "heXXllo"

fn remove_range

Remove range from string.

Signature: (s:str start:i64 len:i64 -- result:str)

Example:

"hello" 1 3 str::remove_range print  // "ho"

fn truncate

Truncate to max length with optional suffix.

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

Example:

"hello world" 8 "..." str::truncate print  // "hello..."

fn lines

Split string by newlines.

Signature: (s:str -- arr:ptr count:i64)!

Example:

"a\nb\nc" str::lines! -> count -> arr
// arr contains ["a", "b", "c"], count = 3

fn words

Split string by whitespace.

Signature: (s:str -- arr:ptr count:i64)!

Example:

"hello  world" str::words! -> count -> arr
// arr contains ["hello", "world"], count = 2

fn split_n

Split into at most n parts.

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

Example:

"a:b:c:d" ":" 2 str::split_n! -> count -> arr
// arr contains ["a", "b:c:d"], count = 2

fn is_numeric

Check if string contains only digits.

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

Example:

"12345" str::is_numeric print  // 1
"12.34" str::is_numeric print  // 0

fn is_alpha

Check if string contains only letters.

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

Example:

"Hello" str::is_alpha print    // 1
"Hello123" str::is_alpha print // 0

fn is_alphanumeric

Check if string contains only letters and digits.

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

Example:

"Hello123" str::is_alphanumeric print  // 1
"Hello!" str::is_alphanumeric print    // 0

fn is_ascii

Check if all characters are ASCII (0-127).

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

Example:

"hello" str::is_ascii print  // 1

fn is_lowercase

Check if all letters are lowercase.

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

Example:

"hello" str::is_lowercase print  // 1
"Hello" str::is_lowercase print  // 0

fn is_uppercase

Check if all letters are uppercase.

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

Example:

"HELLO" str::is_uppercase print  // 1
"Hello" str::is_uppercase print  // 0

fn char_count

Count UTF-8 codepoints (characters, not bytes).

Signature: (s:str -- count:i64)

Example:

"hello" str::char_count print  // 5
"héllo" str::char_count print  // 5 (é is 2 bytes but 1 char)

fn slice

Substring with negative index support (Python-style).

Signature: (s:str start:i64 end:i64 -- result:str)

Example:

"hello" 1 4 str::slice print   // "ell"
"hello" -3 -1 str::slice print // "ll"
"hello" 1 -1 str::slice print  // "ell"

fn column

Format strings into columns.

Signature: (arr:ptr count:i64 widths:ptr num_cols:i64 -- result:str)

Example:

// Format names into 2 columns of width 10
names count widths 2 str::column print