String

String

Stores mutable (garbage collected), UTF-16 strings. String maps to JavaScript String object. Strings can be delimited by a single quote ('abc') or double quote ("ABC").

Explicit Unicode characters can be specified by using # followed by an integer codepoint (decimal or hexadecimal). Characters specified this way are always understood as Unicode codepoint.

Following statement would output 'Hello' followed by CR+LF (ASCII code 13 and 10), followed by

'World'.

writeln('Hello'#13#$0D'World');

In a single-quoted string, a single quote can be expressed by doubling it ('can''quote this!'). In a double-quoted string, a double-quote can be expressed by doubling it ("A""QUOTE"). Double-quoted strings can span multiple lines.

This is an equivalent of the example few lines above.

   writeln("Hello
            World");

Strings can also be defined with #" or #'. In this case the compiler will then ignore common indentation, and will additionally ignore an empty first line. Following example is equivalent to both examples above.

   writeln(#"
   Hello
   World");

The String type has built-in Low/High/Length pseudo-methods, similar to those of the array types. You can use str.Low, str.High and str.Length as an alternative to Low(str), High(str) & Length(str).

[1.1.2]        In operator can be used to check for substrings (if  'java'  in  'javascript'  then).

[1.1.2]        Helpers can operate directly on string constants ("Smart".Reverse).

Methods

Informations

Length () : Integer

Low () : Integer

High () : Integer

Testing

Contains (subStr : String) : Boolean

StartsWith (beginStr : String) : Boolean

EndsWith (endStr : String) : Boolean

EqualsText (str2 : String) : Boolean

Case conversions

UpperCase () : String        // ASCII upper case

LowerCase () : String        // ASCII lower case

ToLower () : String        // locale lower case

ToUpper () : String        // locale upper case                

Conversions

ToBoolean () : Boolean

ToFloat () : Float

ToFloatDef (def : Float) : Float

ToInteger () : Integer

ToIntegerDef (def : Integer) : Integer

Manipulations

After (delimiter : String) : String                            // returns characters after a delimiter

Before (delimiter : String) : String                // returns characters before a delimiter

CompareText (str2 : String) : Integer

CompareTo (str2 : String) : Integer

DeleteLeft (count : Integer) : String                // delete N characters to the left

DeleteRight (count : Integer) : String                // delete N characters to the right

Dupe (count : Integer) : String                        // duplicate the string N times

Format (args : array of const ) : String

HexToInteger () :Integer

Left (count : Integer) : String                        // return N characters to the left

LeftStr(str:string; count:Integer)                           // takes a certain portion of the left side of a string.

Matches (mask : String) : Boolean

MidStr(str:string; start:Integer; count:Integer)    // takes a specified number of characters from a string.

QuotedString (quoteChar : String = '') : String

Replace (sub : String; newSub : String) : String

Reverse () : String                                // returns a version of the string with the character reversed

Right (count : Integer) : String                        // return N characters to the right

RigthStr(str:string; count:Integer)                // takes a certain portion of the right side of a string.

Split (delimiter : String) : array of string        // split a string on a separator and returns an array of strings

Trim (str : String) : String                        // trim control characters left & right

Trim (nbLeft : Integer; nbRight : Integer) : String        // trim control characters left & right

TrimLeft () : String                                // trim left control characters

TrimRight () : String                                // trim right control characters

Internal String functions        

This section hasn't been formatted yet and is a copy-paste from the dwsStringFunctions.pas source.

Go to String object JS reference.