String

Resizeable Unicode character string

Implements: Compare, Clone, Stringify

• New
• Append
• Capacity
• Clear
• Clone
• Compare
• Compress
• Copy
• Count
• Delete
• EndsWith
• Equals
• EqualsIgnoreCase
• Error
• ErrorLine
• Find
• FindAll
• FindLast
• First
• Get
• Has
• HashID
• Insert
• IsEmpty
• IsFloat
• IsInt
• Justify
• Last
• Lines
• Pad
• Pop
• Print
• PrintLine
• Remove
• RemoveAll
• Replace
• ReplaceAll
• Reverse
• Set
• SetFloatFormat
• SetFloatPrecision
• SetIntFormat
• Size
• Split
• StartsWith
• SubString
• ToBool
• ToByteArray
• ToCharArray
• ToFloat
• ToInt
• ToLower
• ToString
• ToUpper
• Trim

Code example:

# build and print string
cities_str := "\t\tNapa,";
cities_str += "Fremont,";
cities_str += "Alameda,";
cities_str += "Berkeley,";
cities_str += "Fremont,";
cities_str += "San Carlos,";
cities_str += "Milpitas,  ";
cities_str->PrintLine();

# show the string size
cities_str->Size()->PrintLine();

# trim string
cities_str := cities_str->Trim();
cities_str->Size()->PrintLine();

# replace city
cities_str := cities_str->Replace("San Carlos", "Oakland");
cities_str->PrintLine();

# create a substring
start := cities_str->Find("Berkeley");
if(<>start->IsNeg()) {
   end := cities_str->Find(start, ',');
   if(<>end->IsNeg()) {
      city := cities_str->SubString(start, end - start);
      "They city found was {$city}"->PrintLine();
   }
};

# remove ending comma
cities_str->Pop();

# split string and print values
cities := cities_str->Split(',');
cities->Size()->PrintLine();

# iterate over cities
each(city := cities) {
   city->PrintLine();
};

# iterate over cities with an index
each(i : cities) {
   city := cities[i];
   "{$i}: |{$city}|"->PrintLine();
};

New

Default constructor

Copy constructor

Copy constructor

Copy constructor

Copy constructor

Copy constructor

Copy constructor

Append

Appends a boolean value

Appends a integer value

Appends a float value

Appends a string

Appends a character array

Appends a portion of character array

Appends a character array

Appends a portion of byte array

Appends a character

Appends a byte

Capacity

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

Clear

Clears string

Clone

Clones the object instance

Compare

Compares two objects

Compress

Compresses a string removing unused space.

Copy

Creates a new instance of the string

Count

Counts the occurrence of a character

Counts the occurrence of a character

Delete

Deletes the character at the given index

Deletes the characters at the given range

EndsWith

Checks if the string ends with the given character

Checks if the string ends with the given string

Equals

Compares two strings

Compares a string to an array of values

EqualsIgnoreCase

Compares two strings, ignoring the case

Compares a string to an array of values, ignoring case

Error

Print an error string

ErrorLine

Print an error string with a newline

Find

Searches for the first occurrence of a character

Searches for the first occurrence of a character

Searches for the first occurrence of a string

Searches for the first occurrence of a string

FindAll

Searches for all occurrences of a string

FindLast

Searches for the last occurrence of a character

Searches for the last occurrence of a character

First

Returns the first character

Get

Returns character at the given index

Has

Searches for the first occurrence of a character

Searches for the first occurrence of a character

Searches for the first occurrence of a character

Searches for the first occurrence of a character

HashID

Returns a unique hash ID for a given string sequence

Insert

Insert inserts a character

Insert inserts a string

Insert inserts a string

IsEmpty

Returns rather the string is empty

IsFloat

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

IsInt

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

Justify

Justify if word length is then width

Last

Returns the last character

Lines

Splits a string into lines

Pad

Pads a string with a character

Pop

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

Print

Print a string

PrintLine

Prints values

Print a string with a newline

Remove

Removes the first occurrence the search string

Removes all matching characters from a string

RemoveAll

Removes all occurrences the search string

Removes all occurrences the search character

Replace

Replaces the first occurrence the search string

ReplaceAll

Replaces all occurrences the search string

Replaces all occurrences the search string

Reverse

Reverses a string

Set

Sets character at the given index

SetFloatFormat

Set floating point string format.

SetFloatPrecision

Set floating point string precision.

SetIntFormat

Set integer string format.

Size

Return the size of the string

Split

Splits a string based upon delimiter

Splits a string based upon delimiter

StartsWith

Checks if the string starts with the given character

Checks if the string starts with the given string

SubString

Creates a sub-string

Creates a sub-string

ToBool

Parses the string into a boolean

ToByteArray

Returns a byte array representation of the String

ToCharArray

Returns a character array representation of the String

ToFloat

Parses the string into a float

ToInt

Parses the string into an integer

Parses the string into an integer

ToLower

Transforms a to lower case

ToString

Returns string of self

Formats an array of string

ToUpper

Transforms a to upper case

Trim

Removes all leading and ending white space