Skip to main content
Version: v0.18.0

String

a = "test_string";

b = "test" + "_string";

is_true = "test" == "test";
is_false = "test" == "string";

s = "abcdef"
puts(s[2])
puts(s[-2])
puts(s[:2])
puts(s[:-2])
puts(s[2:])
puts(s[-2:])
puts(s[1:-2])

s[2] = "C"
s[-2] = "E"
puts(s)

// should output
"c"
"e"
"ab"
"abcd"
"cdef"
"ef"
"bcd"
"abCdEf"

// you can also use single quotes
'test "string" with doublequotes'

// and you can scape a double quote in a double quote string
"te\"st" == 'te"st'

Literal Specific Methods​

count(STRING|INTEGER)​

Returns INTEGER

Counts how often a given string or integer occurs in the string. Converts given integers to strings automatically.

🚀 > "test".count("t")
=> 2
🚀 > "test".count("f")
=> 0
🚀 > "test1".count("1")
=> 1
🚀 > "test1".count(1)
=> 1

downcase()​

Returns STRING

Returns the string with all uppercase letters replaced with lowercase counterparts.

🚀 > "TeST".downcase()
=> test

downcase!()​

Returns NIL

Replaces all upcase characters with lowercase counterparts.


🚀 > a = "TeST"
=> TeST
🚀 > a.downcase!()
=> nil
🚀 > a
=> test

find(STRING|INTEGER)​

Returns INTEGER

Returns the character index of a given string if found. Otherwise returns -1

🚀 > "test".find("e")
=> 1
🚀 > "test".find("f")
=> -1

lines()​

Returns ARRAY

Splits the string at newline escape sequence and return all chunks in an array. Shorthand for string.split("\n").

🚀 > "test\ntest2".lines()
=> ["test", "test2"]

plz_i(INTEGER)​

Returns INTEGER

Interprets the string as an integer with an optional given base. The default base is 10 and switched to 8 if the string starts with 0x.

🚀 > "1234".plz_i()
=> 1234

🚀 > "1234".plz_i(8)
=> 668

🚀 > "0x1234".plz_i(8)
=> 668

🚀 > "0x1234".plz_i()
=> 668

🚀 > "0x1234".plz_i(10)
=> 0

replace(STRING, STRING)​

Returns STRING

Replaces the first string with the second string in the given string.

🚀 > "test".replace("t", "f")
=> "fesf"

reverse()​

Returns STRING

Returns a copy of the string with all characters reversed.

🚀 > "stressed".reverse()
=> "desserts"

reverse!()​

Returns NIL

Replaces all the characters in a string in reverse order.

🚀 > a = "stressed"
=> "stressed"
🚀 > a.reverse!()
=> nil
🚀 > a
=> "desserts"

size()​

Returns INTEGER

Returns the amount of characters in the string.

🚀 > "test".size()
=> 4

split(STRING)​

Returns ARRAY

Splits the string on a given seperator and returns all the chunks in an array. Default seperator is " "

🚀 > "a,b,c,d".split(",")
=> ["a", "b", "c", "d"]

🚀 > "test and another test".split()
=> ["test", "and", "another", "test"]

strip()​

Returns STRING

Returns a copy of the string with all leading and trailing whitespaces removed.

🚀 > " test ".strip()
=> "test"

strip!()​

Returns NIL

Removes all leading and trailing whitespaces in the string.


🚀 > a = " test "
=> " test "
🚀 > a.strip!()
=> nil
🚀 > a
=> "test"

upcase()​

Returns STRING

Returns the string with all lowercase letters replaced with uppercase counterparts.

🚀 > "test".upcase()
=> TEST

upcase!()​

Returns NIL

Replaces all lowercase characters with upcase counterparts.


🚀 > a = "test"
=> test
🚀 > a.upcase!()
=> nil
🚀 > a
=> TEST

Generic Literal Methods​

methods()​

Returns ARRAY

Returns an array of all supported methods names.

🚀 > "test".methods()
=> [count, downcase, find, reverse!, split, lines, upcase!, strip!, downcase!, size, plz_i, replace, reverse, strip, upcase]

to_json()​

Returns STRING|ERROR

Returns the object as json notation.

🚀 > a = {"test": 1234}
=> {"test": 1234}
🚀 > a.to_json()
=> "{"test":1234}"

type()​

Returns STRING

Returns the type of the object.

🚀 > "test".type()
=> "STRING"

wat()​

Returns STRING

Returns the supported methods with usage information.

🚀 > true.wat()
=> BOOLEAN supports the following methods:
plz_s()