rules.
Primitive type representing a string value.
Strings can be lexicographically
compared using the ==, !=, >,
<, >= and <= operators.
Strings can be concatenated using the + operator:
// Concatenate a username and an email domain 'username' + '@domain.com'
Sub-strings can be accessed using the index operator [].
They can also be accessed using the range operator [i:j]. Note
that parameter j, the upper bound in the range operator, is
not inclusive.
// Check if the first character of a string is 'a' mystring[0] == 'a' // Check if the string starts with 'abc' mystring[0:3] == 'abc'
Boolean, integer, float, and null values can be converted into strings
using the string() function:
string(true) == "true" string(1) == "1" string(2.0) == "2.0" string(null) == "null"
Methods
lower
lower() returns rules.String
Returns a lowercase version of the input string.
- Returns
-
non-null rules.Stringthe lowercase string.
Example
'ABC'.lower() == 'abc'
'ABC123'.lower() == 'abc123'matches
matches(re) returns rules.Boolean
Performs a regular expression match on the whole string.
Parameter |
|
|---|---|
|
re |
A regular expression using Google RE2 syntax. Value must not be null. |
- Returns
-
non-null rules.Booleantrue if the whole string matches, false otherwise.
Example
'user@domain.com'.matches('.*@domain[.]com') == true
'banana'.matches('.*@domain[.]com') == falsereplace
replace(re, sub) returns rules.String
Replaces all occurrences of substrings matching a regular expression with a user-supplied string.
Parameter |
|
|---|---|
|
re |
A regular expression using Google RE2 syntax. Value must not be null. |
|
sub |
A string to substitute. Value must not be null. |
- Returns
-
non-null rules.StringA string representing the result of the replacement operation. If no substrings matched the regular expression, the unmodified original string is returned.
Example
'banana'.replace("a", "o") == 'bonono'
'banana'.replace("ana", "ee") == 'beena'
'foo@test.com'.replace(".", "-") == '---------------' // '.' regex match allsize
size() returns rules.Integer
Returns the number of characters in the string.
- Returns
-
non-null rules.Integerthe number of characters.
Example
'a'.size() == 1
'abc'.size() == 3split
split(re) returns rules.List
Splits a string according to a regular expression.
Parameter |
|
|---|---|
|
re |
A regular expression using Google RE2 syntax. Value must not be null. |
- Returns
-
non-null rules.Lista list of strings.
Example
'a/b/c'.split('/') == ['a', 'b', 'c']toUtf8
toUtf8() returns rules.Bytes
Returns the UTF-8 byte encoding of a string.
- Returns
-
non-null rules.Bytesa Bytes sequence containing the UTF-8 encoded representation of the string.
Example
'**'.toUtf8() == b'\x2A\x2A'
'€'.toUtf8() == b'\xE2\x82\xAC'trim
trim() returns rules.String
Returns a version of the string with leading and trailing spaces removed.
- Returns
-
non-null rules.Stringthe trimmed string.
Example
' a '.trim() == 'a'
'b'.trim() == 'b'upper
upper() returns rules.String
Returns an uppercase version of the input string.
- Returns
-
non-null rules.Stringthe uppercase string.
Example
'abc'.upper() == 'ABC'
'abc123'.upper() == 'ABC123'