Skip to main content

String

String concatenation

String concatenation is made using the + operator. Examples:

   "ab" + "cd" + "ef";  returns "abcdef"
"ab"+12+"de"; returns "ab12de"
"ab"+1+2; returns "ab12"
1+2+"ab"; is illegal since the first argument of '+' must be a string!

Match string against regular expression

   like(Charstring string, Charstring pattern) -> Boolean

In a pattern string * matches sequence of characters and ? matches a single character.

Examples:

   like("abc","??c") returns TRUE
like("ac","a*c") returns TRUE
like("ac","a?c") fails
like("abc","a[bd][dc]"); returns TRUE
like("abc","a[bd][de]"); fails

Functions

aton(Charstring s)->Number n

Convert string s to number


capitalize(Charstring s)->Charstring

Capitalize string s


charstring(Object x)->Charstring

Cast x to string


concat(Charstring x,Charstring y)->Charstring

Concatenate strings y and y. Same as x+y


dim(Charstring str)->Integer

Number of characters in string str


length(Charstring str)->Integer

Legacy; use dim(str) instead


like(Charstring str,Charstring pat)->Boolean

Match string str against regualar expression pat


like_i(Charstring str,Charstring pat)->Boolean

Match string str against regualar expression pat ignoring case


locate(Charstring substr,Charstring str)->Integer

The position of the first occurrence of substring substr in str


locate_right(Charstring substr,Charstring str)->Integer

The position of the last occurrence of substring substr in str


lower(Charstring s)->Charstring

Lower case string s


ltrim(Charstring chars,Charstring str)->Charstring

Remove characters in chars from beginning of str


not_empty(Charstring s)->Boolean

Is string s empty or all whitespaced? The characters space, tab, or new line are counted as whitespace


ntoa(Number x)->Charstring

Convert number x to string


plus(Charstring x,Object y)->Charstring r

Concatenate strings x and y. Inverses produce prefix or suffix


replace(Charstring str,Vector of Charstring from_str,
Vector of Charstring to_str)->Charstring

The string str with all occurrences of the first matching strings in from_str replaced by the correspondig strings in to_str


rtrim(Charstring chars,Charstring str)->Charstring

Remove characters in chars from end of str


section(Charstring str,Number l,Number u)->Charstring

The substring of str starting at position l and ending at u


skip(Charstring str,Number l)->Charstring

Skip l characters in the beginning of string str


split(Charstring str,Charstring delim)->Vector of Charstring

Create a vector of substrings in str delimited by delim Example: `split('a bc d', ' ') -> ['a', 'bc','d']


split(Charstring str)->Vector of Charstring

Unoack str into a vector of characters Example: `split('abc') -> ['a', 'b', 'c']


stringify(Object o)->Charstring

Convert object o to string. The elements are stringified if o is bag or stream


trim(Charstring chars,Charstring str)->Charstring

Remove characters in chars from beginning and end of str


unstringify(Charstring s)->Object o

Parse string s to object


upper(Charstring str)->Charstring uppr

Upper case string str


vref(Charstring str,Number i)->Charstring

Same as str[i] to access character i in str