StringTools

no package

Available on all platforms

This class provides advanced methods on Strings. It is ideally used with using StringTools and then acts as an extension to the String class.

If the first argument to any of the methods is null, the result is unspecified.

Static variables

@:value([" ".code, "(".code, ")".code, "%".code, "!".code, "^".code, "\"".code, "<".code, ">".code, "&".code, "|".code, "\n".code, "\r".code, ",".code, ";".code]) static winMetaCharacters:Array<Int> = [" ".code, "(".code, ")".code, "%".code, "!".code, "^".code, "\"".code, "<".code, ">".code, "&".code, "|".code, "\n".code, "\r".code, ",".code, ";".code]

Character codes of the characters that will be escaped by quoteWinArg(_, true).

Static methods

static endsWith (s:String, end:String):Bool

Tells if the string s ends with the string end.

If end is null, the result is unspecified.

If end is the empty String "", the result is true.

@:has_untyped static inline fastCodeAt (s:String, index:Int):Int

Returns the character code at position index of String s, or an end-of-file indicator at if position equals s.length.

This method is faster than String.charCodeAt() on some platforms, but the result is unspecified if index is negative or greater than s.length.

End of file status can be checked by calling StringTools.isEof() with the returned value as argument.

This operation is not guaranteed to work if s contains the \0 character.

static hex (n:Int, ?digits:Int):String

Encodes n into a hexadecimal representation.

If digits is specified, the resulting String is padded with "0" until its length equals digits.

static htmlEscape (s:String, ?quotes:Bool):String

Escapes HTML special characters of the string s.

The following replacements are made:

• & becomes &amp;
• < becomes &lt;
• > becomes &gt;

If quotes is true, the following characters are also replaced:

• " becomes &quot;
• ' becomes &#039;

static htmlUnescape (s:String):String

Unescapes HTML special characters of the string s.

This is the inverse operation to htmlEscape, i.e. the following always holds: htmlUnescape(htmlEscape(s)) == s

The replacements follow:

• & becomes &
• < becomes <
• > becomes >
• " becomes "
• ' becomes '

@:noUsing static inline isEof (c:Int):Bool

static isSpace (s:String, pos:Int):Bool

Tells if the character in the string s at position pos is a space.

A character is considered to be a space character if its character code is 9,10,11,12,13 or 32.

If s is the empty String "", or if pos is not a valid position within s, the result is false.

static lpad (s:String, c:String, l:Int):String

Concatenates c to s until s.length is at least l.

If c is the empty String "" or if l does not exceed s.length, s is returned unchanged.

If c.length is 1, the resulting String length is exactly l.

Otherwise the length may exceed l.

If c is null, the result is unspecified.

static ltrim (s:String):String

Removes leading space characters of s.

This function internally calls isSpace() to decide which characters to remove.

If s is the empty String "" or consists only of space characters, the result is the empty String "".

static quoteUnixArg (argument:String):String

Returns a String that can be used as a single command line argument on Unix. The input will be quoted, or escaped if necessary.

static quoteWinArg (argument:String, escapeMetaCharacters:Bool):String

Returns a String that can be used as a single command line argument on Windows. The input will be quoted, or escaped if necessary, such that the output will be parsed as a single argument using the rule specified in http://msdn.microsoft.com/en-us/library/ms880421

Examples:

quoteWinArg("abc") == "abc";
quoteWinArg("ab c") == '"ab c"';

static replace (s:String, sub:String, by:String):String

Replace all occurrences of the String sub in the String s by the String by.

If sub is the empty String "", by is inserted after each character of s. If by is also the empty String "", s remains unchanged.

This is a convenience function for s.split(sub).join(by).

If sub or by are null, the result is unspecified.

static rpad (s:String, c:String, l:Int):String

Appends c to s until s.length is at least l.

If c is the empty String "" or if l does not exceed s.length, s is returned unchanged.

If c.length is 1, the resulting String length is exactly l.

Otherwise the length may exceed l.

If c is null, the result is unspecified.

static rtrim (s:String):String

Removes trailing space characters of s.

This function internally calls isSpace() to decide which characters to remove.

If s is the empty String "" or consists only of space characters, the result is the empty String "".

static startsWith (s:String, start:String):Bool

Tells if the string s starts with the string start.

If start is null, the result is unspecified.

If start is the empty String "", the result is true.

static trim (s:String):String

Removes leading and trailing space characters of s.

This is a convenience function for ltrim(rtrim(s)).

@:has_untyped static urlDecode (s:String):String

Decode an URL using the standard format.

@:has_untyped static urlEncode (s:String):String

Encode an URL by using the standard format.