All Bundles

String

Resizeable Unicode string class that supports typical string operations.

Implements: Compare, Clone, Stringify

Operations

New

Default constructor

New()

Copy constructor

New(string:String)
Parameters
NameTypeDescription
stringStringstring to be copied

Copy constructor

New(array:Char[])
Parameters
NameTypeDescription
arrayChar[]array to be copied

Copy constructor

New(array:Char[], copy:Bool)
Parameters
NameTypeDescription
arrayChar[]array to be copied
copyBoolif false, use array for value for string otherwise copy values

Copy constructor

New(array:Char[], offset:Int, length:Int)
Parameters
NameTypeDescription
arrayChar[]array to be copied
offsetIntoffset array index offset
lengthIntnumber of characters to copy

Copy constructor

New(bytes:Byte[])
Parameters
NameTypeDescription
bytesByte[]array to be copied

Copy constructor

New(bytes:Byte[], offset:Int, length:Int)
Parameters
NameTypeDescription
bytesByte[]array to be copied
offsetIntoffset array index offset
lengthIntnumber of characters to copy

Append

Appends a boolean value

method : public : Append(flag:Bool) ~ Nil
Parameters
NameTypeDescription
flagBoolboolean value

Appends a integer value

method : public : Append(i:Int) ~ Nil
Parameters
NameTypeDescription
iIntinteger value

Appends a float value

method : public : Append(f:Float) ~ Nil
Parameters
NameTypeDescription
fFloatfloat value

Appends a string

method : public : Append(str:String) ~ Nil
Parameters
NameTypeDescription
strStringstring object

Appends a character array

method : public : Append(array:Char[]) ~ Nil
Parameters
NameTypeDescription
arrayChar[]character array

Appends a portion of character array

method : public : native : Append(array:Char[], offset:Int, length:Int) ~ Nil
Parameters
NameTypeDescription
arrayChar[]array to be copied
offsetIntoffset array index offset
lengthIntnumber of characters to copy

Appends a character array

method : public : native : Append(array:Byte[]) ~ Nil
Parameters
NameTypeDescription
arrayByte[]array to be copied

Appends a portion of byte array

method : public : native : Append(array:Byte[], offset:Int, length:Int) ~ Nil
Parameters
NameTypeDescription
arrayByte[]array to be copied
offsetIntoffset array index offset
lengthIntnumber of bytes to copy

Appends a character

method : public : Append(c:Char) ~ Nil
Parameters
NameTypeDescription
cCharcharacter to append

Appends a byte

method : public : Append(c:Byte) ~ Nil
Parameters
NameTypeDescription
cBytebyte to append

Capacity

Gets the current string's storage capacity. That is the number of characters the string will hold before it is resized for growth.

method : public : Capacity() ~ Int
Return
TypeDescription
Intstring capacity

Clear

Clears string

method : public : Clear() ~ Nil

Clone

Clones the object instance

method : public : Clone() ~ System.Compare
Return
TypeDescription
Comparecloned the object instance

Compare

Compares two objects

method : public : Compare(rhs:System.Compare) ~ Int
Parameters
NameTypeDescription
rhsComparecompare object

Return
TypeDescription
Int0 if equal, -1 if right-hand side i greater, 1 if left-hand side is greater

Compress

Compresses a string removing unused space.

method : public : Compress() ~ Nil

Copy

Creates a new instance of the string

method : public : Copy() ~ String
Return
TypeDescription
Stringnew string instance

Count

Counts the occurrence of a character

method : public : Count(char:Char) ~ Int
Parameters
NameTypeDescription
charCharcharacter to search for

Return
TypeDescription
Intcount of occurrences or -1 if not found

Counts the occurrence of a character

method : public : native : Count(offset:Int, char:Char) ~ Int
Parameters
NameTypeDescription
offsetIntsearch offset
charCharcharacter to search for

Return
TypeDescription
Intcount of occurrences or -1 if not found

Delete

Deletes the character at the given index

method : public : Delete(offset:Int) ~ Bool
Parameters
NameTypeDescription
offsetIntoffset index

Return
TypeDescription
Booltrue if deleted, false otherwise

Deletes the characters at the given range

method : public : Delete(offset:Int, length:Int) ~ Bool
Parameters
NameTypeDescription
offsetIntoffset index
lengthIntlength

Return
TypeDescription
Booltrue if deleted, false otherwise

EndsWith

Checks if the string ends with the given character

method : public : EndsWith(char:Char) ~ Bool
Parameters
NameTypeDescription
charCharcharacter to compare

Return
TypeDescription
Booltrue if ends with character, false otherwise

Checks if the string ends with the given character

method : public : native : EndsWith(string:String) ~ Bool
Parameters
NameTypeDescription
stringStringstring to check for

Return
TypeDescription
Booltrue if ends with character, false otherwise

Equals

Compares two strings

method : public : Equals(rhs:String) ~ Bool
Parameters
NameTypeDescription
rhsStringstring to compare

Return
TypeDescription
Bool0 if equal, -1 if right-hand side i greater, 1 if left-hand side is greater

Error

Print an error string

method : public : Error() ~ Nil

ErrorLine

Print an error string with a newline

method : public : ErrorLine() ~ Nil

Find

Searches for the first occurrence of a character

method : public : Find(char:Char) ~ Int
Parameters
NameTypeDescription
charCharcharacter to search for

Return
TypeDescription
Intindex of first occurrence, -1 otherwise

Searches for the first occurrence of a character

method : public : native : Find(offset:Int, char:Char) ~ Int
Parameters
NameTypeDescription
offsetIntsearch offset
charCharcharacter to search for

Return
TypeDescription
Intindex of first occurrence, -1 otherwise

Searches for the first occurrence of a string

method : public : Find(find:String) ~ Int
Parameters
NameTypeDescription
findStringstring to search for

Return
TypeDescription
Intindex of first occurrence, -1 otherwise

Searches for the first occurrence of a string

method : public : native : Find(offset:Int, find:String) ~ Int
Parameters
NameTypeDescription
offsetIntsearch index offset
findStringstring to search for

Return
TypeDescription
Intindex of first occurrence, -1 otherwise

FindAll

Searches for all occurrences of a string

method : public : FindAll(find:String) ~ Int[]
Parameters
NameTypeDescription
findStringstring to search for

Return
TypeDescription
Int[]an array of indexes

FindLast

Searches for the last occurrence of a character

method : public : FindLast(char:Char) ~ Int
Parameters
NameTypeDescription
charCharcharacter to search for

Return
TypeDescription
Intindex of last occurrence, -1 otherwise

Searches for the last occurrence of a character

method : public : native : FindLast(offset:Int, char:Char) ~ Int
Parameters
NameTypeDescription
offsetIntsearch offset
charCharcharacter to search for

Return
TypeDescription
Intindex of last occurrence, -1 otherwise

First

Returns the first character

method : public : First() ~ Char
Return
TypeDescription
Charfirst character

Get

Returns character at the given index

method : public : native : Get(index:Int) ~ Char
Parameters
NameTypeDescription
indexIntindex offset

Return
TypeDescription
Charcharacter at index

Has

Searches for the first occurrence of a character

method : public : Has(char:Char) ~ Bool
Parameters
NameTypeDescription
charCharcharacter to search for

Return
TypeDescription
Booltrue of found, false otherwise

Searches for the first occurrence of a character

method : public : Has(offset:Int, char:Char) ~ Bool
Parameters
NameTypeDescription
offsetIntsearch offset
charCharcharacter to search for

Return
TypeDescription
Booltrue of found, false otherwise

Searches for the first occurrence of a character

method : public : Has(str:String) ~ Bool
Parameters
NameTypeDescription
strStringstring to search for

Return
TypeDescription
Booltrue of found, false otherwise

Searches for the first occurrence of a character

method : public : Has(offset:Int, str:String) ~ Bool
Parameters
NameTypeDescription
offsetIntsearch offset
strStringstring to search for

Return
TypeDescription
Booltrue of found, false otherwise

HashID

Returns a unique hash ID for a given string sequence

method : public : native : HashID() ~ Int
Return
TypeDescription
Inthash ID

Insert

Insert inserts a character

method : public : Insert(index:Int, char:Char) ~ Bool
Parameters
NameTypeDescription
indexIntinsert offset
charCharcharacter to insert

Return
TypeDescription
Booltrue if inserted, false otherwise

Insert inserts a string

method : public : Insert(index:Int, string:String) ~ Bool
Parameters
NameTypeDescription
indexIntinsert offset
stringStringstring to insert

Return
TypeDescription
Booltrue if inserted, false otherwise

IsEmpty

Returns rather the string is empty

method : public : IsEmpty() ~ Bool
Return
TypeDescription
Booltrue if empty, false otherwise

IsFloat

Checks to see if the string can be represented as an float

method : public : IsFloat() ~ Bool
Return
TypeDescription
Booltrue if the string can be represented as an float, false otherwise

IsInt

Checks to see if the string can be represented as an interger

method : public : native : IsInt() ~ Bool
Return
TypeDescription
Booltrue if the string can be represented as an interger, false otherwise

Last

Returns the last character

method : public : native : Last() ~ Char
Return
TypeDescription
Charlast character

Lines

Splits a string into lines

method : public : native : Lines() ~ String[]
Return
TypeDescription
String[]array of lines

Pop

Pops the last character from the string reducing the size by 1

method : public : native : Pop() ~ Char
Return
TypeDescription
Charlast character of the string

Print

Print a string

method : public : Print() ~ Nil

PrintLine

Print a string with a newline

method : public : PrintLine() ~ Nil

Remove

Removes the first occurrence the search string

method : public : Remove(find:String) ~ String
Parameters
NameTypeDescription
findStringstring to search for

Return
TypeDescription
Stringnew string instance

Removes all matching characters from a string

method : public : Remove(char:Char) ~ String
Parameters
NameTypeDescription
charCharcharacter to remove

Return
TypeDescription
Stringstring with matching characters removed

RemoveAll

Removes all occurrences the search string

method : public : RemoveAll(find:String) ~ String
Parameters
NameTypeDescription
findStringstring to search for

Return
TypeDescription
Stringnew string instance

Removes all occurrences the search character

method : public : RemoveAll(find:Char) ~ String
Parameters
NameTypeDescription
findCharcharacter to search for

Return
TypeDescription
Stringnew string instance

Replace

Replaces the first occurrence the search string

method : public : Replace(find:String, replace:String) ~ String
Parameters
NameTypeDescription
findStringstring to search for
replaceStringstring to replace with

Return
TypeDescription
Stringnew string instance

ReplaceAll

Replaces all occurrences the search string

method : public : ReplaceAll(find:String, replace:String) ~ String
Parameters
NameTypeDescription
findStringstring to search for
replaceStringstring to replace with

Return
TypeDescription
Stringnew string instance

Replaces all occurrences the search string

method : public : native : ReplaceAll(find:Char, replace:Char) ~ String
Parameters
NameTypeDescription
findCharcharacter to search for
replaceCharcharacter to replace with

Return
TypeDescription
Stringnew string instance

Reverse

Reverses a string

method : public : native : Reverse() ~ String
Return
TypeDescription
Stringreversed string

Set

Sets character at the given index

method : public : Set(char:Char, index:Int) ~ Bool
Parameters
NameTypeDescription
charCharcharter to set
indexIntindex offset

Return
TypeDescription
Booltrue if successful, false otherwise

SetFloatFormat

Set floating point string format.

function : SetFloatFormat(format:Number->Format) ~ Nil
Parameters
NameTypeDescription
formatNumber->Formatfloat format

SetFloatPrecision

Set floating point string precision.

function : SetFloatPrecision(precision:Int) ~ Nil
Parameters
NameTypeDescription
precisionIntdecimal precision

SetIntFormat

Set integer string format.

function : SetIntFormat(format:Number->Format) ~ Nil
Parameters
NameTypeDescription
formatNumber->Formatinteger format

Size

Return the size of the string

method : public : Size() ~ Int
Return
TypeDescription
Intsize of the string

Split

Splits a string based upon delimiter

method : public : native : Split(delim:String) ~ String[]
Parameters
NameTypeDescription
delimStringsplitting delimiter

Return
TypeDescription
String[]array of split sub strings

Splits a string based upon delimiter

method : public : native : Split(delim:Char) ~ String[]
Parameters
NameTypeDescription
delimCharsplitting delimiter

Return
TypeDescription
String[]array of split sub strings

StartsWith

Checks if the string starts with the given character

method : public : StartsWith(char:Char) ~ Bool
Parameters
NameTypeDescription
charCharcharacter to compare

Return
TypeDescription
Booltrue if starts with character, false otherwise

Checks if the string starts with the given string

method : public : StartsWith(string:String) ~ Bool
Parameters
NameTypeDescription
stringStringstring to check for

Return
TypeDescription
Booltrue if starts with string, false otherwise

SubString

Creates a sub-string

method : public : SubString(length:Int) ~ String
Parameters
NameTypeDescription
lengthIntmax length of sub-string

Return
TypeDescription
Stringsub-string

Creates a sub-string

method : public : SubString(offset:Int, length:Int) ~ String
Parameters
NameTypeDescription
offsetIntindex offset
lengthIntmax length of sub-string

Return
TypeDescription
Stringsub-string

ToBool

Parses the string into a boolean

method : public : ToBool() ~ Bool
Return
TypeDescription
Boolboolean value

ToByteArray

Returns a byte array representation of the String

method : public : native : ToByteArray() ~ Byte[]
Return
TypeDescription
Byte[]byte array

ToCharArray

Returns a character array representation of the String

method : public : ToCharArray() ~ Char[]
Return
TypeDescription
Char[]character array

ToFloat

Parses the string into a float

method : public : ToFloat() ~ Float
Return
TypeDescription
Floatfloat value

ToInt

Parses the string into an integer

method : public : ToInt() ~ Int
Return
TypeDescription
Intinteger value

Parses the string into an integer

method : public : ToInt(base:Int) ~ Int
Parameters
NameTypeDescription
baseIntbase radix

Return
TypeDescription
Intinteger value

ToLower

Transforms a to lower case

method : public : native : ToLower() ~ String
Return
TypeDescription
Stringlower case string

ToString

Returns string of self

method : public : ToString() ~ String
Return
TypeDescription
Stringstring of self

ToUpper

Transforms a to upper case

method : public : native : ToUpper() ~ String
Return
TypeDescription
Stringupper case string

Trim

Removes all leading and ending white space

method : public : native : Trim() ~ String
Return
TypeDescription
Stringtrimmed string