O'Reilly logo

Learning WML, and WMLScript by Martin Frost

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

Name

replaceAt — Replace an element in a list that is stored as a string

Usage

String.replaceAt(str, new, index, sep)

str : String

new : String

index : Number

sep : String

Description

(See elementAt( )’s description for an explanation of how a string is processed as a list of “elements.”)

Starting with the list stored as string str, returns a list in which the element at position index is replaced by the element new. (The first element has index zero.) The return value is a new string; str itself remains unmodified.

If index is less than zero, the first element is replaced. Similarly, if index is past the end of the list, the last element is replaced. Note that an empty str is a valid list with only one element: the empty string.

Returns invalid if any of the values can’t be converted to the correct types or if sep is the empty string.

Examples

String.replaceAt("a;b;c;d", "xxx", 1, ";")

returns string "a;xxx;c;d"

String.replaceAt("a;b;c;d", "xxx", -1, ";")

returns string "xxx;b;c;d"

String.replaceAt("a;b;c;d", "xxx", 9.8, ";")

returns string "a;b;c;xxx"

String.replaceAt("", "xxx", 0, ";")

returns string "xxx"

String.replaceAt(invalid, "x", 1, "x")

returns invalid

String.replaceAt("foo", invalid, 1, "x")

returns invalid

String.replaceAt("foo", "x", "one", "x")

returns invalid

String.replaceAt("foo", "x", 1, invalid)

returns invalid

String.replaceAt("foo", "x", 1, "")

returns invalid

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, interactive tutorials, and more.

Start Free Trial

No credit card required