Converts a hyphenated string to a camelcased string.

Example :

     import core.strings.camelCase ;
     trace( camelCase("hello-world" ) ) ; // helloWorld
     

Converts the first letter of each word in a string to uppercase.

Example :

     import core.strings.capitalize ;
     trace( capitalize( "hello world" ) ) ; // Hello World
     

Returns the center string representation of the specified string value.

Example :

     import core.strings.center ;
     
     trace( center("hello world", 0) )         ; // hello world
     trace( center("hello world", 20) )        ; //     hello world     
     trace( center("hello world", 20, "_" ) )  ; // ____hello world_____
     

Removes all extraneous whitespace from a string and trims it.

Example :

     import core.strings.clean ;
     trace( clean("   hello world \n\n" ) ) ; // hello world
     

Compares two strings.

The default comparaison algorithm use an ascending alphabetic order with minuscule weighting less than majuscule.

return :

• 0 if the two strings are considered equals
• -1 if the first string is considered smaller (lower) than the second string
• 1 if the first string is considered bigger (higher) than the second string

basic usage

     
     var s0:String = "HELLO";
     var s1:String = "hello";
     var s2:String = "welcome";
     var s3:String = "world";
     
     trace( compare( s1, s2 ) ); //-1
     trace( compare( s2, s1 ) ); //1
     trace( compare( s1, s3 ) ); //1
     trace( compare( s1, s1 ) ); //0
     trace( compare( s1, s0 ) ); //0
     trace( compare( s1, s0, true ) ); //-1
     trace( compare( s0, s1, true ) ); //1
     
     

Determines wether the end of a string matches the specified value.

     
     import core.strings.endsWith ;
     
     trace( endsWith( "hello world", "world" ) ); //true
     trace( endsWith( "hello world", "hello" ) ); //false
     
     trace( endsWith( "hello.txt" , "txt" ) ) ; // true
     
     

Quick and fast format of a string using indexed parameters only.

Usage :

• fastformat( pattern:String, ...args:Array ):String
• fastformat( pattern:String, [arg0:arg1:arg2: ...] ):String

See also

     
     import core.strings.fastformat;
     
     trace( fastformat( "hello {0}", "world" ) );
     //output: "hello world"
     
     trace( fastformat( "hello {0} {1} {2}", [ "the", "big", "world" ] ) );
     //output: "hello the big world"
     
     

Format a string using indexed or named parameters.

Usage :

• format( pattern:String, ...args:Array ):String
• format( pattern:String, [arg0:arg1:arg2: ...] ):String
• format( pattern:String, [arg0:arg1:arg2: ...], ...args:Array ):String
• format( pattern:String, {name0:value0,name1:value1,name2:value2, ...} ):String
• format( pattern:String, {name0:value0,name1:value1,name2:value2, ...}, ...args:Array ):String

See also

     
     import core.strings.format ;
     
     trace( format( "{0},{1},{2}" , "apples" , "oranges", "grapes" ) ) ; // apples,oranges,grapes
     trace( format( "{0},{1},{2}" , ["apples" , "oranges", "grapes"] ) ) ; // apples,oranges,grapes
     trace( format( "{path}{0}{name}{1}" , { name : "format" , path:"core.strings" } , "." , "()" ) ) ; // core.strings.format()
     
     

Converts a camelcased string to a hyphenated string.

     
     import core.strings.hyphenate ;
     trace( hyphenate( "helloWorld" ) ) ; //"hello-world"
     
     

Reports the index of the first occurrence in this instance of any character in a specified array of Unicode characters.

     
     import core.strings.indexOfAny ;
     
     var result:int ;
     
     result = indexOfAny("hello world", [2, "hello", 5]) ;
     trace( result ) ; // 0
     
     result = indexOfAny("Five = 5", [2, "hello", 5]) ;
     trace( result ) ; // 2
     
     result = indexOfAny("actionscript is good", [2, "hello", 5]) ; 
     trace( result ) ; // -1
     
     

Inserts a specified instance of String at a specified index position in this instance.

note :

Example :

     import core.strings.insert ;
     
     var result:String;
     
     result = insert("hello", 0, "a" );  // ahello
     trace(result) ;
     
     result = insert("hello", -1, "a" ); // hellao
     trace(result) ;
     
     result = insert("hello", 10, "a" ); // helloa
     trace(result) ;
     
     result = insert("hello", 1, "a" );  // haello
     trace(result) ;
     

Reports the index position of the last occurrence in this instance of one or more characters specified in a Unicode array.

Example :

 
     import core.strings.lastIndexOfAny ;
     trace( lastIndexOfAny("hello world", ["2", "hello", "5"]) ); // 0
     trace( lastIndexOfAny("Five 5 = 5 and not 2" , ["2", "hello", "5"]) ); // 19
     trace( lastIndexOfAny("Five 5 = 5 and not 2" , ["5", "hello", "2"]) ); // 9
     trace( lastIndexOfAny("Five 5 = 5 and not 2" , ["5", "hello", "2"] , 8) ); // 5
     trace( lastIndexOfAny("Five 5 = 5 and not 2" , ["5", "hello", "2"] , 8 , 3) ); // -1
     

Like white space characters, line terminator characters are used to improve source text readability and to separate tokens (indivisible lexical units) from each other. However, unlike white space characters, line terminators have some influence over the behaviour of the syntactic grammar. In general, line terminators may occur between any two tokens, but there are a few places where they are forbidden by the syntactic grammar. A line terminator cannot occur within any token, not even a string. Line terminators also affect the process of automatic semicolon insertion.

ECMAScript specification.

Right-aligns the characters in this instance, padding on the left with a specified Unicode character for a specified total length.

Example :

     import core.strings.padLeft ;
     
     trace( padLeft("hello", 8) ) ; //  "   hello"
     trace( padLeft("hello", 8, ".") ); //  "...hello" 
     

Left-aligns the characters in this string, padding on the right with a specified Unicode character, for a specified total length.

Example :

     import core.strings.padRight ;
     trace( padRight("hello", 8) ) ; //  "hello   "
     trace( padRight("hello", 8, ".") ); //  "hello..." 
     

Apply character padding to a string.

The padding amount is relative to the string length, if you try to pad the string "hello" (5 chars) with an amount of 10, you will not add 10 spacing chars to the original string, but you will obtain " hello", exactly 10 chars after the padding.

A positive amount value will pad the string on the left (right align), and a negative amount value will pad the string on the right (left align),

     
     import core.strings.pad;
     
     var word:String = "hello";
     
     trace( "[" + pad( word, 8 ) + "]" ); //align to the right
     trace( "[" + pad( word, -8 ) + "]" ); //align to the left
     
     //output
     //[   hello]
     //[hello   ]
     
     

     
     import core.strings.pad;
     
     var seinfeld:Array = [ "jerry", "george", "kramer", "helen" ];
     var len:uint       = seinfeld.length ;
     for( var i:uint ; i<len ; i++ )
     {
         trace( pad( seinfeld[i] , 10 , "." ) ) ;
     }
     
     //output
     //.....jerry
     //....george
     //....kramer
     //.....helen
     
     

Returns a new String value who contains the specified String characters repeated count times.

Example :

     import core.strings.repeat ;
     
     trace( repeat( "hello" , 0 ) ) ; // hello
     trace( repeat( "hello" , 3 ) ) ; // hellohellohello
     

Checks if this string starts with the specified prefix.

Example :

     import core.strings.startsWith ;
     
     var file:String = "hello.txt";
     
     trace( startsWith( file , "hello" ) ) ; // true
     

Removes all occurrences of a set of characters specified in an array from the end of this instance.

Example :

     import core.strings.trimEnd ;
     import core.strings.whiteSpaceChars ;
     trace( trimEnd("---hello world---" , ["-"].concat( whiteSpaceChars) ) ); // ---hello world
     

Removes all occurrences of a set of characters specified in an array from the beginning of this instance.

Example :

     import core.strings.trimStart ;
     import core.strings.whiteSpaceChars ;
     
     trace( trimStart("---hello world---" , ["-"].concat(whiteSpaceChars) ) ); // hello world---
     

Removes all occurrences of a set of specified characters (or strings) from the beginning and end of this instance.

Example :

     import core.strings.trim ;
     trace( trim("\r\t   hello world   \t ") ); // hello world
     

Returns a user-agent string.

based on:

• http://www.mozilla.org/build/user-agent-strings.html
• http://www.mozilla.org/build/revised-user-agent-strings.html
• RFC 1945 - http://www.ietf.org/rfc/rfc1945.txt
• RFC 2068 - http://www.ietf.org/rfc/rfc2068.txt
• https://developer.mozilla.org/en/Gecko_user_agent_string_reference
• http://hacks.mozilla.org/2010/09/final-user-agent-string-for-firefox-4/

here some examples:

     - URLRequestDefaults (only if an AIR app and with compatible option set to true)
       "Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5"
       "Mozilla/5.0 (Windows; U; en) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5"
       "Mozilla/5.0 (X11; U; Linux i686; en-US) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5"
     - userAgent
       "Tamarin/1.0 cyclone (Macintosh; StandAlone; Mac OS 10.6.7; en; DEBUG) AdobeFlashPlayer/10.0.32.18"
       "Tamarin/1.0 cyclone (Macintosh; StandAlone; Mac OS 10.6.7; en; DEBUG) AdobeFlashPlayer/10.0.32.18 MyApp/2.0"
       "Tamarin/1.0 cyclone (Macintosh; StandAlone; Mac OS 10.6.7; en; DEBUG) MyApp/2.0"
       "Tamarin/1.0 cyclone (Macintosh; StandAlone; DEBUG) AdobeFlashPlayer/10.0.32.18"
       "Mozilla/5.0 (Macintosh; StandAlone; Mac OS 10.6.7; en; DEBUG) AdobeFlashPlayer/10.0.32.18"
       "Mozilla/5.0 (Macintosh; StandAlone; DEBUG) AdobeFlashPlayer/10.0.32.18"
     

note:

By default we consider our "product" to be Tamarin, it will work for Flash Player, AIR and RedTamarin.

ex: "Tamarin/1.0 cyclone (Macintosh; ..."

By default if you don't provide an apptoken, it will deduced automatically (eg. "AdobeAIR/1.5" , "AdobeFlashPlayer/9.0.124.0", etc.)

ex: "... Mac OS 10.6.7; en) AdobeFlashPlayer/10.0.32.18"

By default, self application description and application token accumulates

ex: "... Mac OS 10.6.7; en) AdobeFlashPlayer/10.0.32.18 MyApp/2.0"

if you use the `noself` option you can remove the self application description

ex: "... Mac OS 10.6.7; en) MyApp/2.0"

Contains all white space chars.

Note :

• http://developer.mozilla.org/es4/proposals/string.html
• http://www.fileformat.info/info/unicode/category/Zs/list.htm
• http://www.fileformat.info/info/unicode/category/Zl/list.htm
• http://www.fileformat.info/info/unicode/category/Zp/list.htm
• http://www.fileformat.info/info/unicode/char/200b/index.htm
• http://www.fileformat.info/info/unicode/char/feff/index.htm
• http://www.fileformat.info/info/unicode/char/2060/index.htm