String

Supported platforms: android, ios, mac, pc
Available since: Gideros 2011.6

Description

This library provides generic functions for string manipulation, such as finding and extracting substrings, and pattern matching. When indexing a string in Lua, the first character is at position 1 (not at 0, as in C). Indices are allowed to be negative and are interpreted as indexing backwards, from the end of the string. Thus, the last character is at position -1, and so on.

The string library provides all its functions inside the table string. It also sets a metatable for strings where the __index field points to the string table. Therefore, you can use the string functions in object-oriented style. For instance, string.byte(s, i) can be written as s:byte(i). 

The string library assumes one-byte character encodings.{|-

| style="width: 50%;"|

Methods

string.byte - returns numerical code, nil if index out of range, default i=1
string.char - returns a string built from 0 or more integers
string.dump - returns binary representation of function, used with loadstring
string.find - matches pattern in s, returns start,end indices, else nil
string.format - returns formatted string, printf-style
string.gmatch - returns iterator function that returns next captures from pattern pat on s
string.gsub - returns copy of s with pat replaced by repl, and substitutions made
string.len - returns string length
string.lower - returns string with letters in lower case
string.match - Searches a string for a pattern.
string.rep - returns string with n copies of string s
string.sub - returns substring from index i to j of s, default j=-1(string length-
string.upper - returns string with letters in upper case
| style="width: 50%;"|

Constants

|}