FUNCTION: String.elementAt
String.elementAt(string,
index, separator)
The String.elementAt function finds and returns the string element
at the given index position in the given string.
This function treats a string as an array composed of elements delimited
by a separator that is composed of one or more specified characters (including
white space). The first index position is numbered zero and the last index
position is the total number of the elements minus one. The total number
of elements in the string can be found by using the String.elements
function.
If the string is empty, the empty string "" is returned.
The mandatory string parameter can be any string containing zero
or more of any combination of characters and white spaces.
The mandatory index parameter is the position of the element in
the string array. A negative index number will return the first element
and not generate an error. An index number larger than the actual number
of element will return the last element and not generate an error.
The mandatory separator parameter can be any character, white space,
or the empty string that you wish to use to divide the string into substrings
called elements.
Code for ElementAtExample.wml
<?xml version="1.0"?>
<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 1.1//EN"
"http://www.WAPforum.org/DTD/wml_1.1.xml">
<wml>
<card id="card1">
<p>
elementAt example
</p>
<do type="accept">
<go href="ElementAtExample.wmls#findelementat()"
/>
</do>
</card>
<card id="card2">
<p>
string = $(strng)
<br />
index = $(index)
<br />
separator = $(separator)
<br />
element = $(element)
</p>
</card>
</wml>
Code for ElementAtExample.wmls
extern function findelementat()
{
var str = Dialogs.prompt("Enter a string", "Hello wireless
world!");
var ind = Dialogs.prompt("Enter an index", "1");
var sep = Dialogs.prompt("Enter a separator", " ");
var elem = String.elementAt(str,
ind, sep);
WMLBrowser.setVar("strng", str);
WMLBrowser.setVar("index", ind);
WMLBrowser.setVar("separator", sep);
WMLBrowser.setVar("element", elem);
WMLBrowser.go("ElementAtExample.wml#card2");
};
Copyright 1999-2001 by Infinite Software Solutions, Inc. All rights reserved.
Trademark Information
|