User Guide

String.length 801
String.length
Availability
Flash Player 5.
Usage
my_str.length:Number
Description
Property; an integer specifying the number of characters in the specified String object.
Because all string indexes are zero-based, the index of the last character for any string
x is
x.length - 1.
Example
The following example creates a new String object and uses String.length to count the number
of characters:
var my_str:String = "Hello world!";
trace(my_str.length); // output: 12
The following example loops from 0 to my_str.length. The code checks the characters within a
string, and if the string contains the
@ character, true displays in the Output panel. If it does not
contain the
@ character, then false displays in the Output panel.
function checkAtSymbol(my_str:String):Boolean {
for (var i = 0; i<my_str.length; i++) {
if (my_str.charAt(i) == "@") {
return true;
}
}
return false;
}
trace(checkAtSymbol("[e-mail]")); // output: true
trace(checkAtSymbol("Chris")); // output: false
An example is also in the Strings.fla file in the HelpExamples folder. The following list gives
typical paths to this folder:
• Windows: \Program Files\Macromedia\Flash MX 2004\Samples\HelpExamples\
• Macintosh: HD/Applications/Macromedia Flash MX 2004/Samples/HelpExamples/
•