Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
The StringUtil utility class is an all-static class with methods for
working with String objects within Flex.
You do not create instances of StringUtil;
instead you call methods such as
the
StringUtil.substitute()
method.
public static function isWhitespace(character:String):Boolean
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns true
if the specified string is
a single space, tab, carriage return, newline, or formfeed character.
Parameters
| character:String — The String that is is being queried.
|
Returns | Boolean — true if the specified string is
a single space, tab, carriage return, newline, or formfeed character.
|
public static function repeat(str:String, n:int):String
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Returns a string consisting of a specified string
concatenated with itself a specified number of times.
Parameters
| str:String — The string to be repeated.
|
|
| n:int — The repeat count.
|
Returns public static function restrict(str:String, restrict:String):String
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Removes "unallowed" characters from a string.
A "restriction string" such as "A-Z0-9"
is used to specify which characters are allowed.
This method uses the same logic as the restrict
property of TextField.
Parameters
| str:String — The input string.
|
|
| restrict:String — The restriction string.
|
Returns public static function substitute(str:String, ... rest):String
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Substitutes "{n}" tokens within the specified string
with the respective arguments passed in.
Parameters
| str:String — The string to make substitutions in.
This string can contain special tokens of the form
{n} , where n is a zero based index,
that will be replaced with the additional parameters
found at that index if specified.
|
|
| ... rest — Additional parameters that can be substituted
in the str parameter at each {n}
location, where n is an integer (zero based)
index value into the array of values specified.
If the first parameter is an array this array will be used as
a parameter list.
This allows reuse of this routine in other methods that want to
use the ... rest signature.
For example
public function myTracer(str:String, ... rest):void
{
label.text += StringUtil.substitute(str, rest) + "\n";
}
|
Returns | String — New string with all of the {n} tokens
replaced with the respective arguments specified.
|
public static function trim(str:String):String
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Removes all whitespace characters from the beginning and end
of the specified string.
Parameters
| str:String — The String whose whitespace should be trimmed.
|
Returns | String — Updated String where whitespace was removed from the
beginning and end.
|
public static function trimArrayElements(value:String, delimiter:String):String
Language Version: | ActionScript 3.0 |
Runtime Versions: | Flash Player 9, AIR 1.1 |
Removes all whitespace characters from the beginning and end
of each element in an Array, where the Array is stored as a String.
Parameters
| value:String — The String whose whitespace should be trimmed.
|
|
| delimiter:String — The String that delimits each Array element in the string.
|
Returns | String — Updated String where whitespace was removed from the
beginning and end of each element.
|