BlitzMax/Language/Strings

Strings are used to store sequences of characters.

Strings are actually objects, so can be used where ever an object is expected. Strings provide the following methods:

Method	Description
Find:Int( subString:String,startIndex=0 )	Finds first occurrence of a sub string. Returns -1 if subString not found.
FindLast:Int( subString:String,startIndex=0 )	Finds last occurrence of a sub string. Returns -1 if subString not found.
Trim:String()	Removes leading and trailing non-printable characters from a string.
Replace:String( subString:String,withString:String )	Replaces all occurrences of subString with withString.
StartsWith:Int( subString:String )	Returns true if string starts with subString.
EndsWith:Int( subString:String )	Returns true if string ends with subString.
Contains:Int( subString:String )	Returns true if string contains subString.
Join:String( bits:String[] )	Joins bits together by inserting this string between each bit.
Split:String[]( separator$[] )	Splits this string into bits delimited by separator.
ToLower:String()	Converts string to lowercase.
ToUpper:String()	Converts string to uppercase.
ToInt:Int()	Converts string to an integer.
ToLong:Long()	Converts string to a long.
ToFloat:Float()	Converts string to a float.
ToDouble:Double()	Converts string to a double.
ToCString:Byte Ptr()	Converts string to a null terminated sequence of 8 bit bytes. The returned memory must eventually be freed with a call to MemFree.
ToWString:Short Ptr()	Converts string to a null terminated sequence of 16 bit shorts. The returned memory must eventually be freed with a call to MemFree.

Strings also provide a read-only length field. Here is an example of using string methods:

Local t:String="***** HELLO *****"

Print t.length   'return length of string: 17
Print t.Find( "HE" )  'returns index of substring "HE": 6
Print t.Replace( "*","!" ) 'replaces all "*" with "!"
Print t.ToLower()  'coverts string to lowercase
Print ":".Join( ["Hello","World"] ) 'returns "Hello:World"

String also provide the following functions to help with the creation of strings:

Function	Description
FromInt:String( value:Int )	Creates a string from an integer.
FromLong:String( value:Long )	Creates a string from a long.
FromFloat:String( value:Float )	Creates a string from a float.
FromDouble:String( value:Double)	Creates a string from a double.
FromCString:String( cString:Byte Ptr )	Creates a string from a null terminated sequence of 8 bit bytes.
FromWString:String( wString:Short Ptr )	Creates a string from a null terminated sequence of 16 bit shorts.
FromBytes:String( bytes:Byte Ptr,length )	Creates a string from a sequence of length 8 bit bytes.
FromShorts:String( shorts:Short Ptr,length )	Creates a string from a sequence of length 16 bit shorts.

To call a string function, use: String.Function - for example:

Print String.FromInt( 10 )