Function Reference

Contents 1 Function Reference 1.1 User Functions 1.2 Core Functions 1.2.1 Language Features 1.2.2 Console Functions 1.2.3 Variable Type Conversions 1.2.4 Common Variable Functions 1.2.5 Math Functions 1.2.6 String Functions 1.2.7 Array Functions 1.2.8 File Functions 1.2.8.1 Text File Create/Read/Write Functions 1.2.9 Misc Functions

Function Reference

User Functions

Core Functions

Language Features

• <Expression> =~ m/regex/
• <Expression> =~ s/regex/str/

Console Functions

• Print( <expression> ) -- Prints an expressions string value to the console window.
• Println( <expression> ) -- Prints an expressions string value to the console window and inserts a newline charactor at the end.
• Printf( <expression>, <expressions>... ) -- Print a formatted string to the console window
• Input( <expression> ) -- Capture a string typed to console window.
• InputC( <expression> ) -- Capture a char typed to console window.
• Cls( ) -- Clear all text from the console window.

Variable Type Conversions

• Byte( <expression> ) -- Returns the 8-bit integer (whole number) representation of an expression.
• Int16( <expression> ) -- Returns the 16-bit integer (whole number) representation of an expression.
• Int32( <expression> ) (Alias: Int( $variable )) -- Returns the 32-bit integer (whole number) representation of an expression.
• Int64( <expression> ) -- Returns the 64-bit integer (whole number) representation of an expression.

• Float( <expression> ) -- Returns the 32-bit floating point representation of an expression.
• Double( <expression> ) -- Returns the 64-bit floating point representation of an expression.
• String( <expression> ) -- Returns the String representation of an expression.

Common Variable Functions

• isInt( $variable ) -- Checks if a variable is an integer type
• isFloat( $variable ) -- Checks if a variable is a float-type
• isNumber( $variable ) -- Checks if a variable is a integer or float-type
• isString( $variable ) -- Checks if a variable is a string type
• isArray( $variable ) -- Check if a variable is an array
• isHash( $variable ) -- Check if a variable is an hash
• isObj( $variable ) -- Check if a variable is an object type
• isClass( $variable ) -- Check if a variable's object type is a class
• isStruct( $variable ) -- Check if a variable's object type is a struct

Math Functions

• Abs( <expression> ) -- Calculates the absolute value of a number
• ACos( <expression> ) -- Calculates the arcCosine of a number
• ASin( <expression> ) -- Calculates the arcsine of a number
• ATan( <expression> ) --
• BitAND( <expression> ) --
• BitNOT( <expression> ) --
• BitOR( <expression> ) --
• BitROTATE( <expression> ) --
• BitSHIFT( <expression> ) --
• BitXOR( <expression> ) --
• Ceiling( <expression> ) --
• Cos( <expression> ) --
• Cosh( <expression> ) --
• Exp( <expression> ) --
• Floor( <expression> ) --
• Log( <expression> ) --
• Math( <expression> ) --
• Max( <expression> ) --
• Min( <expression> ) --
• Mod( <expression> ) --
• Random( <expression> ) --
• Round( <expression> ) --
• Sin( <expression> ) --
• Sinh( <expression> ) --
• Sqrt( <expression> ) --
• Tan( <expression> ) --
• Tanh( <expression> ) --
• Turncate( <expression> ) --

String Functions

• Asc( <expression> ) --
• AscW( <expression> ) --
• Chr( <expression> ) --
• Contains( <expression> ) --
• Dec( <expression> ) --
• EndsWith( <expression> ) --
• Hex( <expression> ) --
• InStr( <string>, <substirng>, <casesense>, <occurrence>, <start>, <count> ) -- Checks if a string contains a given substring.
• isAlphaNumeric( <expression> ) --
• isASCII( <expression> ) --
• isFPU( <expression> ) --
• isLower( <expression> ) --
• isNumeric( <expression> ) --
• isSpace( <expression> ) --
• isUpper( <expression> ) --
• LC( <expression> ) --
• LCFirst( <expression> ) --
• LCWords( <expression> ) --
• Left( <expression> ) --
• Match( <expression> ) --
• MD5( <expression> ) --
• PadLeft( <expression> ) --
• PadRight( <expression> ) --
• RandStr( <expression> ) --
• RegExp( <expression>, <pattern>, <flag>, <start> ) -- Check if a string fits a given regular expression pattern
• Replace( <expression> ) --
• Reverse( <expression> ) --
• Right( <expression> ) --
• SHA1( <expression> ) --
• Split( <expression>, <delim/pattern>, <flag> ) -- Splits up a string into substrings depending on the given delimiters.
• SPrintf( <expression>, <expressions>... ) -- Create a formatted string
• StartsWith( <expression> ) --
• StrLen( <expression> ) --
• SubStr( <expression> ) --
• Trim( <expression> ) --
• TrimLeft( <expression> ) --
• TrimRight( <expression> ) --
• UC( <expression> ) --
• UCFirst( <expression> ) --
• UCWords( <expression> ) --

Array Functions

• Join( <array>, <separator> ) -- Join an array into a string with an optional separator

File Functions

Text File Create/Read/Write Functions

• FileOpen( <FileName>, <flag> ) -- Opens a text file for reading or writing
• FileClose( <file> ) -- Closes a previously opened file
• FileWrite( <file>, <expression> ) -- Write text to previously opened text file at the current File Steam pointer location
• FileAppend( <file>, <expression> ) -- Append a line of text to the end of a previously opened text file
• FileSeek( <file>, <offset>, <flag> ) -- Change the POSITION of the File Stream pointer
• FilePos( <file> ) -- Get the current POSITION of the File Stream pointer
• FileRead( <file>, <expression> ) -- Read a number of characters from a previously opened text file starting from current File Steam pointer location
• FileReadLine( <file>, <expression> ) -- Read a line of text from a previously opened text file (Or specify a name of a file)
• FileReadLines( <file> ) -- Read all lines of text from a previously opened text file (Or specify a name of a file)
• FileSave( <file>, <expression> ) -- Save all text to a file
• FileLoad( <file> ) -- Load all text from a file

Misc Functions

• Return( <expression> ) -- Returns a result from a Function.
• Require( <expression> ) -- Includes a file in the current script.
• Throw( <expression> ) -- Throw an exception.