Syntax
list replace( list X, int start, int end [, string s1, ...])
Description
The replace function deletes the elements between the start and end indices of the specified list and inserts the supplied strings in their place. If you do not specify any replacement string values, it replaces those elements with nothing; that is, it returns the list with the specified portion omitted.
Example
trustedusers={"jamie", "cory", "robyn"};
a=replace(trustedusers, 1, 1, "sandy");
print(a); // prints "{jamie, sandy, robyn}"
Syntax
int search( list X, string pattern)
Description
The search function returns the index of the first matching instance of pattern in the specified list. If there is no match, it returns -1.
The first element in the list is index:0.
Example
The following example prints the index number for "cory", which is 1:
a=search({"jamie","cory","robyn"},"c*"); print(a);
Table 39: Search patterns
| j* |
j followed by any number of characters. |
| j*e |
j followed by any number of characters, ending with an e. |
| [jJ]* |
Upper or lower case j followed by any number of characters. |
| [a-z] |
Any lower case character. |
| [^a-z] |
Any character except lower case characters. |
|
j? |
j followed by a single character. |
Syntax
list split ( string X [, string delimiter] string omit_empty_elements )
Description
The split function is the opposite of join. It constructs a list by concatenating the strings into a list. It separates each element in the list with a delimiting character, which can be any character from the delimiter string. The default for delimiter is any white space character.
A sequence of two or more contiguous delimiter characters in the parsed string is considered to be a single delimiter. Delimiter characters at the start or end of the string are ignored.
The omit_empty_elements argument defaults to true. If specified and is false, the empty elements are not omitted from the resulting list.
Example
The following example returns the list: {"jamie", "cory", "robyn"}
a = split( "jamie, cory, robyn", ", ")
Syntax
list splitsubst( string X, string delimiter )
Description
The splitsubst function splits a string X into a list. This function is similar to the split function except that the delimiter contains the entire delimiter string.
Example
The following example returns the list: "john","jane,james"
a = splitsubst( "john,,jane,james", ",," )
