stringUtils Overview
Availability
Flash Player 5.
Usage
#include"stringUtils.as"
Description
Simple library that adds useful methods to the String object.
Include the stringUtils.as file in the first frame of the movie
Author
Mike Chambers
Thanks to
Branden Hall, Ben Glazer, Christian Cantrell, Nik Schramm
XML Documentation
R.Arul Kumaran [r_arul_kumaran@hotmail.com]
#include stringUtils.as
Availability
Flash Player 5.
Usage
#include"stringUtils.as"
Description
This simple library that adds useful methods to the String object.
Include the stringUtils.as file in the first frame of the movie
String.stringUtilsDefined
Availability
Flash Player 5.
Usage
String.stringUtilsDefined
Returns
Boolean true/false
Description
This allows user to check from other include files whether or not the stringUtils library has been included.
Example
if(!String.stringUtilsDefined) {
trace("stringUtils.as not found");
}
See Also
String.stringUtilsVersion
Availability
Flash Player 5.
Usage
String.stringUtilsVersion
Returns
a number
Description
This allows user to check from other include files whether or not the stringUtils library version 1.5 has been included.
Example
if(String.stringUtilsVersion < 1.5){
trace("stringUtils.as version 1.5 or higher needed");
}
See Also
String.ltrim
Availability
Flash Player 5.
Usage
myString.ltrim()
Returns
a string
Description
This method returns a string with the whitespace removed from the beginning of the string.
Example
var s = " foo"
trace("-->" + s + "<--");
s = s.ltrim();
trace("-->" + s + "<--");
See Also
String.rtrim
Availability
Flash Player 5.
Usage
myString.rtrim()
Returns
a string
Description
This method returns a string with the whitespace removed from the end of the string.
Example
var s = "foo "
trace("-->" + s + "<--");
s = s.rtrim();
trace("-->" + s + "<--");
See Also
String.trim
Availability
Flash Player 5.
Usage
myString.trim()
Returns
a string
Description
This method returns a string with the whitespace removed from the beginning and end of the string.
Example
var s = " foo "
trace("-->" + s + "<--");
s = s.trim();
trace("-->" + s + "<--");
See Also
String.beginsWith
Availability
Flash Player 5.
Usage
myString.beginsWith(string)
Parameters
string string to check for
Returns
boolean true/false
Description
This method returns boolean true if the string that the method is called on begins with the string passed to the method, and false if it does not.
The comparison is case sensitive
Example
var s = "rushmore";
trace(s.beginsWith("rush")); //traces true
trace(s.beginsWith("Rush")); //traces false
See Also
String.endsWith
Availability
Flash Player 5.
Usage
myString.endsWith(string)
Parameters
string string to check for
Returns
boolean true/false
Description
This method returns boolean true if the string that the method is called on ends with the string passed to the method, and false if it does not.
The comparison is case sensitive
Example
var s = "rushmore";
trace(s.endsWith("more")); //traces true
trace(s.endsWith("More")); //traces false
See Also
String.remove
Availability
Flash Player 5.
Usage
myString.remove(string)
Parameters
string string to be removed
Returns
string
Description
This method searches through the string that the method is called on and returns a copy of the string with all of the occurrences of the string passed into the method removed.
This removal is case sensitive.
Example
var s = "mXaXcXrXoXmXeXdXiXa";
trace(s.remove("X")); //traces macromedia
trace(s.remove("x")); //traces mXaXcXrXoXmXeXdXiXa
See Also
String.remove
Availability
Flash Player 5.
Usage
myString.remove(replaceString, withString
Parameters
replaceString string to be searched for
withString string to be replaced
Returns
string
Description
This method replaces all occurrences of the first string parameter with the the second string parameter, and then returns a copy of the new string.
This replace is case sensitive.
Example
var s = "mXaXcXrXoXmXeXdXiXa";
trace(s.replace("X", "-")); //traces m-a-c-r-o-m-e-d-i-a
trace(s.replace("x", "-")); //traces mXaXcXrXoXmXeXdXiXa
See Also