String Javascript library

The String class provides means to manipulate arrays of chars (Strings)

1.4.1

New methods: join(), replace(), split().

int charAt (String s, int i):
Returns the ASCII/UTF-8 code of the character at index i inside string s.
Example:

String.charAt ("ABCD", 2); // 67

String decodeBase64 (String s):
Return a string decoded in Base 64 from s.

Warning:
This method might not be available (requires MM.base64).

String decodeUrl (String s):
Returns an URL decoded version of the string s.
Example:

String.makeAscii ("http%3A//myserver.org/myscript%3Fparam1%3Darg1%26param2%3Darg2");
// "http://myserver.org/myscript?param1=arg1&param2=arg2"

String encodeBase64 (String s):
Return a string encoded in Base 64 from s.

Warning:
This method might not be available (requires MM.base64).

String encodeUrl (String s):
Returns an URL encoded version of the string s.
Example:

String.makeAscii ("http://myserver.org/myscript?param1=arg1&param2=arg2");
// "http%3A//myserver.org/myscript%3Fparam1%3Darg1%26param2%3Darg2"

bool endsWith (String s, String t):
Returns true if s ends with t.
Example:

String.endsWith ("ABCDEF", "DEF"); // true

int height (Node fontStyle):
Returns the height (in pixels) of the string rendered using the specified fontstyle node.

Warning:
The fontsyle node must not be switched !

int indexOf (String s, String char, int index):
Returns the first position of char in s, starting at index.
Example:

String.indexOf ('ABCDEFABCDEF', 'A', 2); // 6

String join (MFString orig, char sep, int max):
Returns joined strings from orig using the optional sep char. Joining can be limited to the first max strings for orig.
Returns empty string on error.
Since 1.4.1

int lastIndexOf (String s, int char, int index):
Returns the last position of char in s, starting at index.
Example:

String.lastIndexOf ('ABCDEFABCDEF', 'F', 10); // 5

int length (String s):
Returns the number of chars in s.
Example:

String.length ("ABCD"); // 4

String makeAscii (int i):
Returns a string with a single char made that has the parameter i as ascii code.
Example:

String.makeAscii (65); // "A"

String replace (String s, String token, String replace):
Returns a string where all sub-strings matching token in s are replaced by the replace string.
Since 1.4.1

int split (string orig, MFString dest, [char separator]):
Split orig in tokens to fill the dest array.
If separator is not defined, comma ',' will be used as the default separator.
If no sep is found in orig, the first slot of dest will contain orig.
Returns the number of tokens or 0 on error.
Since 1.4.1

bool startsWith (String s, string t):
Returns true if s starts with t.
Example:

String.startsWith ("ABCDEF", "AB"); // true

int strIndexOf (String s, String t, int index):
Returns the first position of t in s, starting at index.
Example:

String.strIndexOf ("ABCDEFABCDE", "CD", 5); // 8

String substring (String s, int start, int end):
Returns the substring of s, starting at start and ending at end.
If end < 0, return up to the end of the string.
Example:

String.substring ("ABCDEF", 2, 4); // "CDE"

float toFloat (String s):
Returns the float that can be converted from s.
Example:

String.toFloat ("12.345"); // 12.345

int toInt (String s):
Returns the integer that can be converted from s.
Example:

String.toInt ("12345"); // 12345

String toLower (String s):
Returns the lower case version of s.
Example:

String.toLower ("AbCD"); // abcd

String toUpper (String s):
Returns the upper case version of s.
Example:

String.toUpper ("aBcd"); // ABCD

String trim (String s):
Returns the trimmed version of s (space removed at both ends).
Example:

String.trim ("   hello   "); // "hello"

int width (String s, Node fontStyle):
Returns the width (in pixels) of the string rendered using the specified fontstyle node.

Warning:
The fontsyle node must not be switched !

Warning:
The fontsyle node must be defined, otherwise the string itself is returned !