Reference · Strings

trim

trim(str) -> str

What it does

The text without the whitespace at its start and end: spaces, tabs, newlines and carriage returns, and the rest of Unicode's White_Space as well (U+0085 too, but not U+FEFF, a byte-order mark), the same in the browser. Whitespace inside the text stays.

Examples

print(trim("  hi  "))print(trim("\t\nhi\r\n") == "hi")print(trim(" a b "))

hitruea b

Edge cases

• The empty string, and a string of only whitespace, give the empty string.
• Inner runs of spaces are kept: trim is not a squeeze.
• A no-break space and an em space are whitespace too, and trimmed.
• Only whitespace: a dash or a quote at the edge stays, and so does a byte-order mark (len(trim("\uFEFFa")) is 2).

print(trim(""), trim("   "), len(trim("   ")))print(trim("  inner  spaces  "))print(trim(" hi ") | len, trim("  x  "))print(trim("- x -"))

  0inner  spaces2 x- x -

Errors

An argument that is not a string, null included, is a runtime error, not an error value. A field that may be null gets ?? "" first.

print(trim(null))

line 1: `trim` expects a str as argument 1, got null

let note = nullprint(trim(note ?? "") == "")

true

Chaining

print("  Hi  " | trim | lower)print(" a , b " | split(",") | map(trim))print(("   " | trim | len) == 0)

hi["a", "b"]true

See also

split, lower, upper, replace, len

Edit this page on GitHub · every example's output was made by running it (tools/refcheck.mjs) · questions on Discord or r/quillo