17.6.3. Inserting an Element at a Certain Position in a String: insertAt() Function

The insertAt() function helps us insert an element at a certain position in a string. Its syntax is:

String.insertAt(string, string_to_be_inserted, element_index, delimiter);

If the function call succeeds, insertAt() returns a string that is the result of inserting string_to_be_inserted to string at the position element_index. A delimiting character will also be inserted if necessary (See the examples below). The insertAt() function does not modify the value of string.

If element_index is out of range, insertAt() will use the nearest valid index instead. For example, if element_index is -2, insertAt() will insert the new element at index 0.

If delimiter is an empty string or an error occurs, an invalid value is returned.

Below are some WMLScript examples that can help you understand the usage of insertAt() better:

var new_str = String.insertAt("WML Tutorial, WMLScript Tutorial", "WAP", 0, ",");

After executing the above script, the new_str variable has the string value "WAP,WML Tutorial, WMLScript Tutorial". Notice that a comma (the delimiter) is inserted between "WAP" and "WML".

var new_str = String.insertAt("WML Tutorial, WMLScript Tutorial", "WAP", -10, ",");

After executing the above script, the new_str variable has the string value "WAP,WML Tutorial, WMLScript Tutorial".

var new_str = String.insertAt("WML Tutorial, WMLScript Tutorial", "WAP", 2, ",");

After executing the above script, the new_str variable has the string value "WML Tutorial, WMLScript Tutorial,WAP".

var new_str = String.insertAt("WML Tutorial, WMLScript Tutorial", "WAP", 1, ",");

After executing the above script, the new_str variable has the string value "WML Tutorial,WAP, WMLScript Tutorial".

Previous Page

Page 48 of 71

Next Page