These are the built-in list functions available to use within the pmpolicy file.
Table 38: List functions
| append |
Append to a list. |
| insert |
Insert a string or list into a list. |
| join |
Concatenate a list into a string. |
| length |
Return the length of a string, list, or array. |
| lsubst |
Substitute part of a string with another string throughout all or part of a list. |
| range |
Select a range of entries in a list. |
| replace |
Replace one or more strings in a list. |
| search |
Search a list for a string. |
| split |
Convert a string into a list. |
|
splitSubst |
Convert a string into a list. |
Syntax
list append( list dest, list|string src1 [, list|string src2, ...])
Description
append creates a list constructed by appending the specified strings or lists src1, src2, etc. to the end of the list dest and returns a new list.
Example
trustedusers = {"jamie", "cory", "robyn"};
a = append(trustedusers, "adrian");
sets a to the following list:
{"jamie", "cory", "robyn", "adrian"}
Syntax
list insert( list dest, int index, string src1, [, string src2, ...] )
Description
insert constructs a list by inserting strings into a list at the specified position. Note that the first element in the list is index: 0. If the index is greater than the length of the specified list (for example, 999), then the strings append to the end of the list.
Returns the newly constructed list.
Example
trustedusers={"jamie", "cory", "robyn"};
a=insert(trustedusers, 1, "leslie");
sets a to the list:
{"jamie", "leslie", "cory", "robyn"}
Syntax
string join( list X [, string delimiter] )
Description
join returns a string constructed by concatenating each element of list X. Each element of the string is separated by delimiter. The default delimiter is a space character.
Example
trustedusers={"jamie", "cory", "robyn"};
print(join(trustedusers, "\n"));
Prints the following string:
jamie
cory
robyn
