Packagemx.utils
Classpublic class StringUtil

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 Methods
 MethodDefined by
  
isWhitespace(character:String):Boolean
[static] Returns true if the specified string is a single space, tab, carriage return, newline, or formfeed character.
StringUtil
  
substitute(str:String, ... rest):String
[static] Substitutes "{n}" tokens within the specified string with the respective arguments passed in.
StringUtil
  
trim(str:String):String
[static] Removes all whitespace characters from the beginning and end of the specified string.
StringUtil
  
trimArrayElements(value:String, delimiter:String):String
[static] Removes all whitespace characters from the beginning and end of each element in an Array, where the Array is stored as a String.
StringUtil
Method detail
isWhitespace()method
public static function isWhitespace(character:String):Boolean

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
Booleantrue if the specified string is a single space, tab, carriage return, newline, or formfeed character.
substitute()method 
public static function substitute(str:String, ... rest):String

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.

Example
var str:String = "here is some info '{0}' and {1}"; trace(StringUtil.substitute(str, 15.4, true)); // this will output the following string: // "here is some info '15.4' and true"

trim()method 
public static function trim(str:String):String

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.
trimArrayElements()method 
public static function trimArrayElements(value:String, delimiter:String):String

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.