ICI Modules: str

---

Modules by name : by type

Overview

The str module provides a number of useful string functions that are not part of ICI itself. Some of these functions are implemented as native code for performance reasons, others are implemented in ICI as they are convenience functions and ICI already provides the requisite facilties, e.g, str.trim() which removes leading and trailing whitespace from strings uses ICI's intrinsic regular expression support whereas str.tolower(), to convert a string to lowercase, is implemented in C for efficiency when dealing with large amounts of data.

Interface

• str.topper - convert lowercase alphabetic characters in a string to upper case

• str.tolower - convert uppercase alphabetic characters in a string to lower case

• str.error - return the error message associated with the given system error code

• str.ptime - parse a date/time string

• str.join - implode an array to form a string with optional separator

• str.capitalize - return the capitalised form of a word

• str.plural - return the plural form of a word

• str.trim - remove leading and trialing whitespace

• str.base64_encode - encode a string as base64

• str.base64_decode - decode a base64 encoded string