Qu

ltrim

Builtin index · Collections & strings

result = ltrim(s, [chars])

Input: s, chars · Output: result

What it is

Same parameters as trim, restricted to one end only (ltrim the left, rtrim the right).

Overloads

One call shape — this function is not overloaded.

CodeInputOutputDescription
result = ltrim(s, [chars])
s —not documented yet
chars optionalnot documented yet
result Str
Returns a Str.

Examples

From the documentation, and run by the build -- the output and the figure below are what the engine actually produced. Simplest first.

s = "Hello, Qu World!"
print(mid(s, 7, 2))          # "Qu"

print(left(s, 5))            # "Hello"

print(right(s, 6))           # "World!"

print(reverse("abc"))        # "cba"

print(lower("SHOUT"))        # "shout"

print(ucase("shout"))        # "SHOUT"

print(lcase("SHOUT"))        # "shout"

print(toupper("mix"))        # "MIX"

print(tolower("MIX"))        # "mix"

print(capitalize("ada lovelace"))  # "Ada lovelace"

print(ltrim("   padded"))    # "padded"

print(rtrim("padded   ") + "|")   # "padded|"

print(pad_right("ab", 5, "."))    # "ab..."

print(compare("apple", "banana")) # -1

print(asc("A"))              # 65

output
Qu
Hello
World!
cba
shout
SHOUT
shout
MIX
mix
Ada lovelace
padded
padded|
ab...
-1
    ... 1 more lines

from collections-strings

How it works

trim(s) removes whitespace; trim(s, chars) removes any of the characters in chars — a SET, not a substring, which is the meaning every language that has this gives it, and the one that makes trim(field, "\"' ") do what it looks like.

From the note above this builtin in the interpreter, where the reasoning was written down as it was built.

See also

rtrim — documented in the same entry.