User Guide

626 ActionScript classes
String
Object
|
+-String
public class String
extends Object
The String class is a wrapper for the string primitive data type, and provides methods and
properties that let you manipulate primitive string value types. You can convert the value of
any object into a string using the
String() function.
All the methods of the String class, except for
concat(), fromCharCode(), slice(), and
substr(), are generic, which means the methods call toString() before performing their
operations, and you can use these methods with other non-String objects.
Because all string indexes are zero-based, the index of the last character for any string
x is
x.length - 1.
You can call any of the methods of the String class using the constructor method
new String
or using a string literal value. If you specify a string literal, the ActionScript interpreter
automatically converts it to a temporary String object, calls the method, and then discards the
temporary String object. You can also use the
String.length property with a string literal.
Do not confuse a string literal with a String object. In the following example, the first line of
code creates the string literal
first_string, and the second line of code creates the String
object
second_string:
var first_string:String = "foo"
var second_string:String = new String("foo")
Use string literals unless you specifically need to use a String object.
Availability: ActionScript 1.0; Flash Lite 2.0 - (became a native object in Flash Player 6,
which improved performance significantly).
Property summary
Properties inherited from class Object
Modifiers Property Description
length:Number An integer specifying the number of
characters in the specified String object.
constructor (Object.constructor property), __proto__ (Object.__proto__
property), prototype (Object.prototype property), __resolve
(Object.__resolve property)