Flash CS3 Documentation

Flash Lite 2.x ActionScript Language Reference > ActionScript classes > String

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.

Property summary

Modifiers	Property	Description
	length`:`Number	An integer specifying the number of characters in the specified String object.

Properties inherited from class Object

constructor (Object.constructor property), __proto__ (Object.__proto__ property), prototype (Object.prototype property), __resolve (Object.__resolve property)

Constructor summary

Signature	Description
String`(value:`String`)`	Creates a new String object.

Method summary

Modifiers	Signature	Description
	charAt`(index:`Number`) :` String	Returns the character in the position specified by the parameter `index`.
	charCodeAt`(index:`Number`) :` Number	Returns a 16-bit integer from 0 to 65535 that represents the character specified by `index`.
	concat`(value:`Object`) :` String	Combines the value of the String object with the parameters and returns the newly formed string; the original value, `my_str`, is unchanged.
`static`	fromCharCode`() :` String	Returns a string comprising the characters represented by the Unicode values in the parameters.
	indexOf`(value:`String`, [startIndex:`Number`]) :` Number	Searches the string and returns the position of the first occurrence of `value` found at or after `startIndex` within the calling string.
	lastIndexOf`(value:`String`, [startIndex:`Number`]) :` Number	Searches the string from right to left and returns the index of the last occurrence of `value` found before `startIndex` within the calling string.
	slice`(start:`Number`, end:`Number`) :` String	Returns a string that includes the `start` character and all characters up to, but not including, the `end` character.
	split`(delimiter:`String`, [limit:`Number`]) :` Array	Splits a String object into substrings by breaking it wherever the specified `delimiter` parameter occurs and returns the substrings in an array.
	substr`(start:`Number`, length:`Number`) :` String	Returns the characters in a string from the index specified in the `start` parameter through the number of characters specified in the `length` parameter.
	substring`(start:`Number`, end:`Number`) :` String	Returns a string comprising the characters between the points specified by the `start` and `end` parameters.
	toLowerCase`() :` String	Returns a copy of the `String` object, with all uppercase characters converted to lowercase.
	toString`() :` String	Returns an object's properties as strings regardless of whether the properties are strings.
	toUpperCase`() :` String	Returns a copy of the String object, with all lowercase characters converted to uppercase.
	valueOf`() :` String	Returns the string.

Methods inherited from class Object

addProperty (Object.addProperty method), hasOwnProperty (Object.hasOwnProperty method), isPropertyEnumerable (Object.isPropertyEnumerable method), isPrototypeOf (Object.isPrototypeOf method), registerClass (Object.registerClass method), toString (Object.toString method), unwatch (Object.unwatch method), valueOf (Object.valueOf method), watch (Object.watch method)

Flash CS3

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/flash/9.0/main/00005449.html