Function Reference

Revision as of 21:59, 26 November 2011 (view source) Alexpja (Talk | contribs) ← Older edit		Revision as of 22:11, 26 November 2011 (view source) Alexpja (Talk | contribs) Newer edit →
Line 298:		Line 298:
	==== Window Management Functions ====		==== Window Management Functions ====
−		+	* [[Core Function WinActivate|WinActivate( <expression> )]] -- Focus on a window that is already open.
	==== Misc Functions ====		==== Misc Functions ====
	* [[Core Function Return|Return <expressions>]] -- Returns a result from a Function.		* [[Core Function Return|Return <expressions>]] -- Returns a result from a Function.

---

Revision as of 22:11, 26 November 2011

Contents 1 Function Reference 1.1 How to create a Function 1.2 Core Functions 1.2.1 Language Features 1.2.2 Console Functions 1.2.3 Multithreading Functions 1.2.4 Variable Type Conversions 1.2.5 Common Variable Functions 1.2.5.1 Misc 1.2.5.2 Hash/Array 1.2.5.3 Type Checking 1.2.6 Binary Data Management Functions 1.2.7 Math Functions 1.2.8 String Functions 1.2.9 Array Functions 1.2.10 Hash (Dictionary) Functions 1.2.11 Process Functions 1.2.12 Environment Management 1.2.13 File Functions 1.2.13.1 File Create/Read/Write Functions 1.2.14 GUI Functions 1.2.14.1 Dialog Creation Functions 1.2.14.2 Dialog Properties Get/Set Functions 1.2.14.3 Control Creation Functions 1.2.14.4 Event Linking Functions 1.2.14.5 Dialog/Control Properties Get/Set Functions 1.2.14.6 Control Properties Get/Set Functions 1.2.14.7 Other GUI Functions 1.2.15 Keyboard Control Functions 1.2.16 Mouse Control Functions 1.2.17 Window Management Functions 1.2.18 Misc Functions 1.3 User Defined Functions

Function Reference

How to create a Function

To create your own funtions see the Function page.

• User Defined Functions

Core Functions

Language Features

• <Expression> =~ m/pattern/flags -- Match a string to a regular expression pattern and check if it matches and optionally return captured groups
• <Expression> =~ s/pattern/replacement/flags -- Replace parts of a string using a regular expression pattern and optionally executing functions on the matched groups

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

Multithreading Functions

• ThreadCreate( <name>, <function> ) -- Create a new thread and start it off executing a function or some code
• ThreadSleep( <name> ) -- Freeze a thread and make it sleep
• ThreadResume( <name> ) -- Unfreeze a thread and allow it to continue execution
• ThreadState( <name> ) -- Returns state of a thread
• ThreadKill( <name> ) -- Terminate a thread and remove it from the script
• ThreadExists( <name> ) -- Check if a thread exists by this name
• ThreadName( ) -- Returns the name of the current thread that is executing this code
• Threads( ) -- Return an array of all threads

Variable Type Conversions

• Char( <expression> ) -- Returns the single letter representation of an expression
• Byte( <expression> ) -- Returns the unsigned 8-bit integer (whole number) representation of an expression
• SByte( <expression> ) -- Returns the signed 8-bit integer (whole number) representation of an expression
• Short( <expression> ) -- Returns the signed 16-bit integer (whole number) representation of an expression
• Int16( <expression> ) -- Returns the signed 16-bit integer (whole number) representation of an expression
• Int32( <expression> ) -- Returns the signed 32-bit integer (whole number) representation of an expression
• Int( <expression> ) -- Returns the signed 32-bit integer (whole number) representation of an expression
• Int64( <expression> ) -- Returns the signed 64-bit integer (whole number) representation of an expression
• Long( <expression> ) -- Returns the signed 64-bit integer (whole number) representation of an expression
• UShort( <expression> ) -- Returns the unsigned 16-bit integer (whole number) representation of an expression
• UInt16( <expression> ) -- Returns the unsigned 16-bit integer (whole number) representation of an expression
• UInt32( <expression> ) -- Returns the unsigned 32-bit integer (whole number) representation of an expression
• UInt( <expression> ) -- Returns the unsigned 32-bit integer (whole number) representation of an expression
• UInt64( <expression> ) -- Returns the unsigned 64-bit integer (whole number) representation of an expression
• ULong( <expression> ) -- Returns the unsigned 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

Misc

• Unset( $variable ) -- Delete a variable

Hash/Array

• Reset( $variable ) -- Reset the current array pointer to the first element
• Next( $variable ) -- Set the array pointer to the next element
• Prev( $variable ) -- Set the array pointer to the previous element

Type Checking

• isVarChar( $variable ) -- Checks if a variable is a char type
• isVarByte( $variable ) -- Checks if a variable is an unsigned 8-bit integer type
• isVarSByte( $variable ) -- Checks if a variable is a signed 8-bit integer type
• isVarShort( $variable ) -- Checks if a variable is a signed 16-bit integer type
• isVarInt16( $variable ) -- Checks if a variable is a signed 16-bit integer type
• isVarInt( $variable ) -- Checks if a variable is a signed 32-bit integer type
• isVarInt32( $variable ) -- Checks if a variable is a signed 32-bit integer type
• isVarInt64( $variable ) -- Checks if a variable is a signed 64-bit integer type
• isVarLong( $variable ) -- Checks if a variable is a signed 64-bit integer type
• isVarUShort( $variable ) -- Checks if a variable is an unsigned 16-bit integer type
• isVarUInt16( $variable ) -- Checks if a variable is an unsigned 16-bit integer type
• isVarUInt( $variable ) -- Checks if a variable is an unsigned 32-bit integer type
• isVarUInt32( $variable ) -- Checks if a variable is an unsigned 32-bit integer type
• isVarUInt64( $variable ) -- Checks if a variable is an unsigned 64-bit integer type
• isVarULong( $variable ) -- Checks if a variable is an unsigned 64-bit integer type
• isVarFloat( $variable ) -- Checks if a variable is a single precision floating point type
• isVarDouble( $variable ) -- Checks if a variable is a double precision floating point type
• isVarString( $variable ) -- Checks if a variable is a string type
• isVarNumber( $variable ) -- Checks if a variable is any integer or float/double type
• isVarBinary( $variable ) -- Checks if a variable is a binary type
• isVarRef( $variable ) -- Check if a variable is an reference to another variable
• isVarArray( $variable ) -- Check if a variable is an array
• isVarObj( $variable, <type> ) -- Check if a variable is an object type (This includes classes, file handles etc)
• isVarClass( $variable, <type> ) -- Check if a variable's object type is a class
• isVarGUI( $variable ) -- Check if a variable's object type is a GUI
• isVarGUIObject( $variable ) -- Check if a variable's object type is a GUI Object (Buttons etc)

Binary Data Management Functions

• Pack( <expression>, <expressions> ) -- Pack data into a binary array
• Unpack( <expression>, <binary-array> ) -- Unpack data from a binary array
• BinaryCreate( <size>, <fill> ) -- Create a new binary variable and its array size and fill data type
• BinaryClone( <binary-array> ) -- Clone a binary variable 100% and return a new binary variable with exactly same data as the old one
• BinaryWipe( <binary-array> ) -- Wipes a binary variables data 100% and sets the variable to a blank int containing just 0
• BinaryStr( <binary-array>, <separator> ) -- Create a Hex string from a binary array
• BinaryHex( <expression> ) -- Create a binary array from a hex string
• BinaryLen( <binary-array> ) -- Returns the number of bytes in a binary variable
• BinaryGet( <binary-array>, <index> ) -- Get the byte at an index of a binary variable
• BinarySet( <binary-array>, <index>, <value> ) -- Set the byte at an index of a binary variable
• BinaryReverse( <binary-array>, <start>, <length> ) -- Reverse the order bytes a binary variable
• BinaryMid( <binary-array>, <start>, <length> ) -- Create a binary variable by extracting a number of bytes from another binary variable
• BinaryAppend( <binary-array>, <binary-array2>, <flag> ) -- Append a binary variables data onto the end or beginning of another binary variables data
• BinaryInsert( <binary-array>, <binary-array2>, <index> ) -- Insert a binary variables data into another binary variable at a specific location
• BinaryUnshift( <binary-array>, <byte> ) -- Add a byte to the beginning of a binary variable
• BinaryPush( <binary-array>, <byte> ) -- Add a byte to the end of a binary variable
• BinaryShift( <binary-array> ) -- Delete the first byte from a binary variable
• BinaryPop( <binary-array> ) -- Delete the last byte from a binary variable
• BinaryResize( <binary-array>, <size>, <data> ) -- Resize a binary variables data array
• BinaryCompress( <binary-array> ) -- Compress a binary variables data
• BinaryUncompress( <binary-array> ) -- Uncompress a binary variable data
• BinarySave( <binary-array>, <file>, <flag> ) -- Save a binary variable data to file
• BinaryLoad( <file>, <flag> ) -- Create a new binary variable by loading binary data from a file

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> ) -- Calculates the arctangent of a number
• BitAND( <expression> ) --
• BitNOT( <expression> ) --
• BitOR( <expression> ) --
• BitROTATE( <expression> ) --
• BitSHIFT( <value>, <shift> ) -- Performs a bit shifting operation
• BitXOR( <expression> ) --
• Ceiling( <expression> ) --
• Cos( <expression> ) --
• Cosh( <expression> ) --
• Exp( <expression> ) --
• Floor( <expression> ) --
• Log( <expression> ) --
• Math( <expression> ) --
• Max( <expression>, <expression2> ) -- Find the greater number and return it
• Min( <expression> ) --
• Mod( <expression> ) --
• Pow( <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> ) --
• ChrW( <expression> ) --
• Contains( <expression> ) --
• Compare( <expression> ) --
• Dec( <expression> ) -- Returns a integer representation of a hexadecimal string
• FDec( <expression> ) -- Returns a float representation of a hexadecimal string
• DDec( <expression> ) -- Returns a double representation of a hexadecimal string
• DecPad( <expression>, <count> ) -- Pads numeric string to a given number of chars (Filling in the gap with zeros)
• EndsWith( <expression> ) --
• Hex( <expression>, <length> ) -- Returns a string representation of an integer type converted to hexadecimal
• FHex( <expression> ) -- Returns a string representation of an float type converted to hexadecimal
• DHex( <expression> ) -- Returns a string representation of an double type converted to hexadecimal
• InStr( <string>, <substirng>, <casesense>, <occurrence>, <start>, <count> ) -- Checks if a string contains a given substring.
• isAlpha( <expression> ) --
• isAlphaNumeric( <expression> ) --
• isASCII( <expression> ) --
• isEmpty( <expression> ) -- Checks if a string is completely empty.
• isFloat( <expression> ) --
• isLower( <expression> ) --
• isNumeric( <expression> ) --
• isSpace( <expression> ) --
• isSymbol( <expression> ) --
• isUpper( <expression> ) --
• isXDigit( <expression> ) --
• LC( <expression> ) --
• LCFirst( <expression> ) --
• LCWords( <expression> ) --
• Left( <expression> ) --
• Match( <expression> ) --
• MD5( <expression> ) --
• PadLeft( <expression> ) --
• PadRight( <expression> ) --
• RandStr( <expression> ) --
• Repeat( <expression>, <count>, <flag> ) -- Create a new string or new array containing repeats of a string provided
• 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
• UBound( <array/binary-array> ) -- Returns the size of array (How many elements it currently has stored)
• Push( <array>, <expressions> ) -- Add items to the end of an array
• Insert( <array>, <id>, <expressions> ) -- Add items to an array at a given location
• Unshift( <array>, <expressions> ) -- Add items to the beginning of an array
• Pop( <array> ) -- Delete the first item in an array
• Shift( <array> ) -- Delete the last item in an array
• Remove( <array>, <start-id>, <end-id> ) -- Delete items from an array starting at a given location and stopping at a given location
• Delete( <array>, <expresions> ) -- Delete items from an array that match regex patterns, number patterns, or contain specific text etc

Hash (Dictionary) Functions

Process Functions

• DLLCall( <dll>, <function>, <returntype>, <paramtypes>, <params> ) -- Dynamically call a function in a DLL
• Run( <file>, <workdir>, <flag> ) -- Runs an external program
• RunWait( <file>, <workdir>, <flag> ) -- Runs an external program and waits until the program finishes
• ProcessClose( <pid/name> ) -- Terminates a named process
• ProcessExists( <pid/name> ) -- Checks to see if a specified process exists
• ProcessList( <name> ) -- Returns an array listing the currently running processes (names and PIDs)
• ProcessSetPriority( <name>, <priority> ) -- Changes the priority of a process
• ProcessWait( <name>, <timeout> ) -- Pauses the current thread until a given process exists or optional the timeout expires
• ProcessWaitClose( <name>, <timeout> ) -- Pauses the current thread until a given process no longer exists or optional the timeout expires
• Shutdown( <shutdown code> ) -- Shuts down the system

Environment Management

• EnvExpand( <expression> ) -- Convert a string containing %name% env tags and return complete string with names resolved
• EnvGet( <tag> ) -- Get the value of an environment variable
• EnvSet( <tag>, <expression> ) -- Set the value of an environment variable
• EnvUpdate( <tag>, <expression> ) -- Refreshes the OS environment

File Functions

File Create/Read/Write Functions

• FileOpen( <FileName>, <flag> ) -- Opens a file for reading or writing
• FileClose( <file> ) -- Closes a previously opened file
• FileWrite( <file>, <expression> ) -- Write text to previously opened file at the current File Steam pointer location
• FileWriteBinary( <file>, <binary-array> ) -- Write the data from a binary variable to previously opened 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
• FileAppendBinary( <file>, <binary-array> ) -- Append the data from a binary variable to the end of a previously opened 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
• FileReadBinary( <file>, <expression> ) -- Read a number of bytes from a previously opened 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

GUI Functions

Dialog Creation Functions

• GUICreate( <expression> ) --
• DoEvents( <expression> ) --

Dialog Properties Get/Set Functions

• GUIState( <expression> ) --
• GUISetState( <expression> ) --

Control Creation Functions

• GUICreateButton( <gui/container>, <name>, <text>, <left>, <top>, <width>, <height> ) -- Create a button
• GUICreateTextBox( <gui/container>, <name>, <text>, <left>, <top>, <width>, <height> ) -- Create a Textbox
• GUICreateTextBoxEx( <gui/container>, <name>, <text>, <left>, <top>, <width>, <height> ) -- Create a multiline Textbox
• GUICreateTimer( <gui/container>, <name>, <interval> ) -- Create a timer
• GUICreateDataGrid( <gui/container>, <name>, <left>, <top>, <width>, <height> ) -- Create a Data Grid control.

Event Linking Functions

• GUILink( <gui/guiobject>, <linktype> ) --

Dialog/Control Properties Get/Set Functions

• GUIGetData( <expression> ) --
• GUISetData( <expression> ) --

Control Properties Get/Set Functions

• GUITimerStart( <expression> ) --
• GUITimerStop( <expression> ) --

Other GUI Functions

• MsgBox( <expression> ) -- Show a message dialog
• InputBox( <expression> ) --

Keyboard Control Functions

• HotKeySet( <keydef>, <expression> ) -- Create a custom hotkey to run custom code or execute a function.
• SendKeys( <keydef>, <flag> ) -- Sends simulated keystrokes to the active window

Mouse Control Functions

• MouseClick ( <button>, <x>, <y>, <clicks>, <speed> ) -- Perform a mouse click operation
• MouseClickDrag ( <button>, <x1>, <y1>, <x2>, <y21>, <speed> ) -- Perform a mouse click and drag operation
• MouseDown ( <button> ) -- Perform a mouse down event at the current mouse position
• MouseUp ( <button> ) -- Perform a mouse up event at the current mouse position
• MouseMove ( <x>, <y>, <speed> ) -- Moves the mouse pointer
• MouseGetPos ( ) -- Retrieves the current position of the mouse cursor
• MouseGetCursor ( ) -- Returns a cursor ID Number of the current Mouse Cursor
• MouseWheel ( <direction>, <clicks> ) -- Moves the mouse wheel up or down.

Window Management Functions

• WinActivate( <expression> ) -- Focus on a window that is already open.

Misc Functions

• Return <expressions> -- Returns a result from a Function.
• Throw( <expression> ) -- Throw an exception.
• Eval( <expression>, <flag> ) -- Evaluate a string as Sputnik code.
• GC( <flag> ) -- Use the garbage collector.
• Require( <file>, <flag> ) -- Add all functions etc from a file for use.
• Include( <file>, <flag> ) -- Add all functions etc from a file for use and execute all expressions.
• PixelGetColor ( <x>, <y> ) -- Returns a pixel color according to x, y pixel coordinates.
• Opt( <option>, <value> ) -- Changes the operation of various Sputnik functions/parameters

User Defined Functions

These functions are created using Sputnik and are not part of the Sputnik core language.