http://www.bundysoft.com/wiki/ 2026-05-03T10:07:13+00:00 http://www.bundysoft.com/wiki/ http://www.bundysoft.com/wiki/lib/images/favicon.ico text/html 2017-08-31T06:18:35+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:absrand&rev=1504160315&do=diff Description Get a floating point random number, in the range of 0...1. Function prototype float absrand <void> Arguments None. Return value A floating-point random number, in the range of 0...1. Example // write random number to event log 10 times int i set i 0 do echo <zs:absrand> incr i while <zs:islt i 10> text/html 2017-08-31T07:25:45+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:acos&rev=1504164345&do=diff Description Calculate the arccosine of a cosine value. Function prototype double acos <double:value> Arguments Name Type Comment value double A cosine value, the arccosine of which is to be calculated. Return value The arccosine of the cosine value, as a double-precision angle, in radians. text/html 2017-08-31T04:41:47+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:add&rev=1504154507&do=diff Description Add two numbers. Function prototype variant add <variant:Var1> <variant:Var2> Arguments Name Type Comment arg1 variant The first number to be added. arg2 variant The second number to be added. arg1arg2add Return value The sum of arg1 and arg2, in the data type of arg1. text/html 2017-08-31T05:43:18+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:and&rev=1504158198&do=diff Description The boolean 'and' function returns true if both of its two boolean arguments are true. Function prototype bool and <bool:arg1> <bool:arg2> Arguments Name Type Comment arg1 bool The first boolean argument to be tested. arg2 bool The second boolean argument to be tested. Return value True if both arg1 and arg2 are true, and false otherwise. text/html 2017-08-31T04:48:05+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:asin&rev=1504154885&do=diff Description Calculate the arcsine of a sine value. Function prototype double asin <double:value> Arguments Name Type Comment value double A sine value, the arcsine of which is to be calculated. Return value The arcsine of the sine value, as a double-precision angle, in radians. text/html 2017-08-31T07:03:48+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:assert&rev=1504163028&do=diff Description Test a boolean value, and if false, display an error message and halt script execution. Function prototype void assert <bool:Condition> <string:Message> Arguments Name Type Comment Condition bool The boolean value to be tested. Message string The string of text to be displayed if Condition is false. Return value None. text/html 2017-08-31T05:18:11+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:atan&rev=1504156691&do=diff Description Calculate the arctangent of a tangent value. Function prototype double atan <double:value> Arguments Name Type Comment value double A tangent value, the arctangent of which is to be calculated. Return value The arctangent of the tangent value, as a double-precision angle, in radians. text/html 2017-08-31T07:33:58+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:cos&rev=1504164838&do=diff Description Calculate the cosine of an angle. Function prototype double cos <double:Angle> Arguments Name Type Comment Angle double An angle, in radians, the cosine of which is to be calculated. Return value The cosine of the angle, as a double. text/html 2017-08-31T04:56:11+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:decr&rev=1504155371&do=diff Description Decrement the value of an integer. Function prototype int64 incr <varref:Var> Arguments Name Type Comment Var varref A reference to the integer variable to be decremented. Return value The value of Var after it was decremented by 1. text/html 2017-08-31T06:32:05+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:degtorad&rev=1504161125&do=diff Description Convert an angle in degrees to radians. Function prototype double DegToRad <double:value> Arguments Name Type Comment value double The angle in degrees to be converted to radians. Return value A double-precision angle, measured in radians. text/html 2017-08-31T07:24:51+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:del&rev=1504164291&do=diff Description Delete a variable. Function prototype void del <varref:var> Arguments Name Type Comment var varref A reference to the variable to be deleted. Return value None (void). Example int i // create a new variable 'i' echo <zs:isdef "i"> // is 'i' defined? (it should be) del i // delete 'i' echo <zs:isdef "i"> // is 'i' still defined? (it should not be) text/html 2017-08-31T05:38:55+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:div&rev=1504157935&do=diff Description Divide one number by another. Function prototype variant div <variant:arg1> <variant:arg2> Arguments Name Type Comment arg1 variant The numerator. arg2 variant The denominator. arg1arg2divadd Return value The value of arg1 divided by arg2, in the data type of arg1. text/html 2017-08-31T04:39:44+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:echo&rev=1504154384&do=diff Description Echo a given string of text to the event log. Function prototype void echo <string:text> Arguments Name Type Comment text string The string of text to be echoed to the event log. Return value None (void). Example Using a literal string echo "hello" text/html 2017-08-31T04:50:20+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:editui&rev=1504155020&do=diff Description Open a user interface to edit the value of a variable. Function prototype bool EditUI <hvar:hVar> <string:Prompt> Arguments Name Type Comment hVar hvar A handle to the variable to be edited. Prompt string A string containing a prompt for the user (usually the window title). Return value The return value is true if the user presses OK in the editor dialog box, and false otherwise. text/html 2017-08-31T04:25:47+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:fclose&rev=1504153547&do=diff Description Close a file handle. Function prototype bool fclose <voidptr:hFile> Arguments Name Type Comment hFile voidptr A handle to a file that was previously opened by fopen or fopen_s. Return value False if: * The file handle is invalid, or; * The file handle cannot be closed. text/html 2017-08-31T05:24:45+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:fgetc&rev=1504157085&do=diff Description Read a single character from a file at the current stream position. Function prototype int fgetc <voidptr:hFile> Arguments Name Type Comment hFile voidptr A handle to a file created by fopen or fopen_s. Return value The value of the character in the file at the current stream position, or EOF (-1) if an error occurred. text/html 2017-08-31T04:53:37+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:fopen&rev=1504155217&do=diff Description Open a file for reading or writing. Function prototype voidptr fopen <string:FileName> <string:Mode> Arguments Name Type Comment FileName string A string containing the name of the file to be opened. Mode string A string containing the file access mode. Please see the fopen C/C++ documentation for more information. Return value NULL if an error occurred, or a non-NULL handle to an opaque file object. text/html 2017-08-31T05:00:52+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:fopen_s&rev=1504155652&do=diff Description Open a file for reading or writing. Function prototype bool fopen_s <voidptr&:hFile> <string:FileName> <string:Mode> Arguments Name Type Comment hFile voidptr& A reference to a pointer to be used as a file handle. FileName string A string containing the name of the file to be opened. Mode string A string containing the file access mode. Please see the fopen C/C++ documentation for more information. Return value False if an error occurred, or true … text/html 2017-08-31T06:59:26+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:fputc&rev=1504162766&do=diff Description Write a single character to a file at the current stream position. Function prototype bool fputc <voidptr:hFile> <int:char> Arguments Name Type Comment hFile voidptr A handle to a file created by fopen or fopen_s. char int The character code to be written to the file. Return value True if successful, and false if an error occurred. text/html 2017-08-31T07:33:03+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:frand&rev=1504164783&do=diff Description Get a floating point random number, in the range of -1...1. Function prototype float frand <void> Arguments None. Return value A floating-point random number, in the range of -1...1. Example // write random number to event log 10 times int i set i 0 do echo <zs:frand> incr i while <zs:islt i 10> text/html 2017-08-31T05:16:08+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:fread&rev=1504156568&do=diff Description Read an object from a file. Function prototype bool fread <voidptr:hFile> <varref:Data> Arguments Name Type Comment hFile voidptr A handle to a file created by fopen or fopen_s. Data varref A reference to an initialised variable, the value of which is to be read from the file. The type of the variable determines the number of bytes to be read. Return value True if success, false otherwise. text/html 2017-08-31T06:43:05+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:fseek&rev=1504161785&do=diff Description Reposition a file file handle within a file stream. Function prototype bool fseek <voidptr:hFile> <int64:Offset> <int:Origin> Arguments Name Type Comment hFile voidptr A handle to an open file. Offset int64 Number of bytes to offset from Origin. Origin int Position from where Offset is added. Supported values are 0 (SEEK_SET), 1 (SEEK_CUR) and 2 (SEEK_END). Please refer to C++ fseek documentation for more information. Return value True if succes… text/html 2017-08-31T06:14:53+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:ftell&rev=1504160093&do=diff Description Get the current position in a file stream. Function prototype int64 ftell <voidptr:hFile> Arguments Name Type Comment hFile voidptr A handle to a file, the current stream position of which is to be determined. Return value Example voidptr fp set fp <zs:fopen "c:\\test.txt" "w"> assert fp "Cannot open file!" string s set s "Hello!" fwrite fp s echo <zs:ftell fp> // write the current file position to the event log fclose fp text/html 2017-08-31T05:44:02+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:fwrite&rev=1504158242&do=diff Description Write an object to a file. Function prototype bool fwrite <voidptr:hFile> <varref:Data> Arguments Name Type Comment hFile voidptr A handle to a file created by fopen or fopen_s. Data varref A reference to an initialised variable, the value of which is to be written to the file. The type of the variable determines the number of bytes to be written. Return value True if success, false otherwise. text/html 2017-08-31T05:04:51+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:getlineno&rev=1504155891&do=diff Description Get the line number in the script of the the current statement. Function prototype int GetLineNo Arguments None. Return value An integer containing the current line number. Example echo <zs:GetLineNo> echo <zs:GetLineNo> echo <zs:GetLineNo> text/html 2017-08-31T07:27:31+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:getscriptfilename&rev=1504164451&do=diff Description Get the full path to the current script file. Function prototype string GetScriptFilename Arguments None. Return value A string containing the full path to the current script file. n empty string is returned if the current script is not being executed from a script file, such as the case when a plugin executes a script via the zscript_Execute function. text/html 2017-08-31T04:58:38+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:getworkingdir&rev=1504155518&do=diff Description Get the current working directory of the script. Function prototype string GetWorkingDir Arguments None. Return value The string congaing the full path to the current working directory of the script. Example echo <GetWorkingDir> text/html 2017-08-31T05:22:36+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:goto&rev=1504156956&do=diff Description Transfer script execution to the specified script line. Note line numbers start at 0. Function prototype void goto <int:line> Arguments Name Type Comment line int The zero-based line number to which execution should be transferred. Return value None (void). text/html 2017-08-31T05:30:08+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:if&rev=1504157408&do=diff Description Test the value of a condition, and if true, execute a statement block. Statement prototype if <bool:condition> ... statement block ... endif Arguments Name Type Comment condition bool The condition that determines whether the statement block is to be executed. If true, the blcok is executed, and if false, execution skips to the matching endif/elseif/else statement that terminates the statement block. Example int i set i 5 if <islt i 0> echo "negative num… text/html 2017-08-31T06:08:40+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:incr&rev=1504159720&do=diff Description Increment the value of an integer. Function prototype int64 incr <varref:Var> Arguments Name Type Comment Var varref A reference to the integer variable to be incremented. Return value The value of Var after it was incremented by 1. text/html 2017-08-31T07:10:05+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:isdef&rev=1504163405&do=diff Description Test whether a named variable exists. Function prototype bool isdef <string:VarName> Arguments Name Type Comment VarName string The name of a variable, the existence of which is to be tested. Return value True if the variable named by VarName exists, and false otherwise. text/html 2017-08-31T05:08:50+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:iseq&rev=1504156130&do=diff Description Test the equality of two variables. Function prototype bool iseq <variant:arg1> <variant:arg2> Arguments Name Type Comment arg1 variant The first variable to be compared. arg2 variant The second variable to be compared. arg1arg2iseq text/html 2017-08-31T05:08:10+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:isgt&rev=1504156090&do=diff Description Determine whether a variable is numerically greater than another variable. Function prototype bool isgt <variant:arg1> <variant:arg2> Arguments Name Type Comment arg1 variant The first variable to be compared. arg2 variant The second variable to be compared. isgtarg1arg2iseq text/html 2017-08-31T06:29:49+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:islt&rev=1504160989&do=diff Description Determine whether a variable is numerically less than another variable. Function prototype bool islt <variant:arg1> <variant:arg2> Arguments Name Type Comment arg1 variant The first variable to be compared. arg2 variant The second variable to be compared. isltarg1arg2iseq text/html 2017-08-31T07:07:10+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:isneq&rev=1504163230&do=diff Description Thest the inequality of two variables. Function prototype bool isneq <bool:arg1> <bool:arg2> Arguments Name Type Comment arg1 variant The first variable to be compared. arg2 variant The second variable to be compared. arg1arg2isneqiseq text/html 2017-08-31T06:56:57+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:log&rev=1504162617&do=diff Description Calculate the natural logarithm (base e) of a number. Function prototype double log <double:value> Arguments Name Type Comment value double A number, the natural logarithm of which is to be calculated. Return value The natural logarithm of the value provided, in double-precision. text/html 2017-08-31T07:21:44+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:log10&rev=1504164104&do=diff Description Calculate the basic logarithm (base 10) of a number. Function prototype double log10 <double:value> Arguments Name Type Comment value double A number, the basic logarithm of which is to be calculated. Return value The basic logarithm of the value provided, in double-precision. text/html 2017-08-31T05:08:13+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:max&rev=1504156093&do=diff Description Return the greater of two numbers. Function prototype variant max <variant:arg1> <variant:arg2> Arguments Name Type Comment arg1 variant The first number to be evaluated. arg2 variant The second number to be evaluated. Return value The greater of arg1 and arg2. text/html 2017-08-31T06:23:32+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:messagebox&rev=1504160612&do=diff Description Display a modal pop-up message box. Function prototype uint MessageBox <string:Message> <uint:Style> Arguments Name Type Comment Message string The text to be displayed in the message box. Style uint A conbination of bit flags that specify the buttons, icons and behaviour of the message box (see codes below). The supported values of Style are identical to those of the Microsoft Foundation Classes Message box styles, which are: text/html 2017-08-31T06:11:28+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:min&rev=1504159888&do=diff Description Return the lesser of two numbers. Function prototype variant min <variant:arg1> <variant:arg2> Arguments Name Type Comment arg1 variant The first number to be evaluated. arg2 variant The second number to be evaluated. Return value The lesser of arg1 and arg2. text/html 2017-08-31T06:22:09+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:mod&rev=1504160529&do=diff Description Calculate the modulo of two integers (i.e. the remainder of arg1 divided by arg2). Function prototype variant mod <variant:arg1> <variant:arg2> Arguments Name Type Comment arg1 variant The dividend of the modulo operation. arg2 variant The divisor of the modulo operation. Return value The value of arg1 modulo arg2, in the data type of arg1. text/html 2017-08-31T07:02:27+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:mul&rev=1504162947&do=diff Description Multiply one number by another. Function prototype variant mul <variant:arg1> <variant:arg2> Arguments Name Type Comment arg1 variant The first number to be multiplied. arg2 variant The second number to be multiplied. arg1arg2muladd text/html 2017-08-31T04:46:44+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:new&rev=1504154804&do=diff Description Create a new variable of the type provided and with the name provided. Function prototype hVar new <int:VarID> <string:VarName> Arguments Name Type Comment VarID int The variable type ID of the variable to be created. VarName string The name of the new variable to be created. Return value A NULL variable handle if error, and a non-null variable handle otherwise. text/html 2017-08-31T05:23:37+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:not&rev=1504157017&do=diff Description Negate a boolean value. Function prototype bool not <bool:arg> Arguments Name Type Comment arg bool The boolean value to be negated. Return value False if arg was true, and true if arg was false. Example // create two new boolean variables... bool b1 bool b2 // ...and set one to true and one to false set b1 true set b2 false // call 'not b1', and pipe result to event log via echo echo <zs:not b1> // call 'not b2', and pipe result to event log via echo ec… text/html 2017-08-31T05:47:29+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:or&rev=1504158449&do=diff Description The boolean 'or' function returns true if either of its two boolean arguments are true. Function prototype bool or <bool:arg1> <bool:arg2> Arguments Name Type Comment arg1 bool The first boolean argument to be tested. arg2 bool The second boolean argument to be tested. Return value True if either arg1 or arg2 are true, and false if neither are true. text/html 2017-08-31T04:59:37+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:pow&rev=1504155577&do=diff Description Calculate the value of a base raised to the power of an exponent. Function prototype double pow <double:base> <double:expon> Arguments Name Type Comment base double The base value to be raised to the power of expon. expon double The exponent. Return value A double-precision value corresponding to base raised to the power of expon. text/html 2017-08-31T04:54:16+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:radtodeg&rev=1504155256&do=diff Description Convert an angle in radians to degrees. Function prototype double RadToDeg <double:value> Arguments Name Type Comment value double The angle in radians to be converted to degrees. Return value A double-precision angle, measured in degrees. text/html 2017-08-31T06:48:02+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:rand&rev=1504162082&do=diff Description Get a random integer. Function prototype int rand <void> Arguments None. Return value An integer random number, in the range of 0...0x7FFFF. Example // write random number to event log 10 times int i set i 0 do echo <zs:rand> incr i while <zs:islt i 10> text/html 2017-08-31T05:44:28+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:return&rev=1504158268&do=diff Description Terminate execution of a script and return a value to the caller. Function prototype void return <variant:rval> Arguments Name Type Comment rval variant The value to be returned to the caller. Return value None. Example return false text/html 2017-08-31T05:26:50+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:rewind&rev=1504157210&do=diff Description Rewind a file handle to the start of the file stream. Function prototype void rewind <voidptr:hFile> Arguments Name Type Comment hFile voidptr A file handle, as created by fopen or fopen_s. Return value None. Example // open a file, fseek forward, then rewind // open file voidptr fp assert <zs:fopen_s fp "C:\\test.txt" "r"> "Could not open file!" // fseek to 10 assert <zs:fseek fp 10 0> "Fseek failed!" echo <zs:ftell fp> // should be at 10 now // rewind… text/html 2017-08-31T04:39:17+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:set&rev=1504154357&do=diff Description Set the value of a variable. This is equivalent to the '=' assignment operator in C/C++. Function prototype varref set <varref:var> <variant:VarValue> Arguments Name Type Comment var varref A reference to a variable, the value of which is to be set. VarValue variant The desired value of the variable addressed by hVar, as a variant. Return value NULL if an error occurred, and a valid variable reference otherwise (same as var argument). text/html 2017-08-31T07:23:59+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:setworkingdir&rev=1504164239&do=diff Description Set the current working directory of a script. Function prototype bool SetWorkingDir <string:PathName> Arguments Name Type Comment PathName string The full path to the desired working directory of the script. Return value Example SetWorkingDir "C:\\this is a test" echo <GetWorkingDir> text/html 2017-08-31T06:37:22+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:sin&rev=1504161442&do=diff Description Calculate the sine of an angle. Function prototype double sin <double:Angle> Arguments Name Type Comment Angle double An angle, in radians, the sine of which is to be calculated. Return value The sine of the angle, as a double. text/html 2017-08-31T05:51:41+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:sqrt&rev=1504158701&do=diff Description Calculate the square root of a number. Function prototype double sqrt <double:value> Arguments Name Type Comment value double A number, the square root of which is to be calculated. Return value The square root of the value provided, in double-precision. text/html 2017-08-31T07:28:28+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:srand&rev=1504164508&do=diff Description Seed the pseudorandom number generator. Function prototype void srand <uint:seed> Arguments Name Type Comment seed uint The seed value. Return value None. Example srand 373278423 Comments None. See also * rand * frand * absrand text/html 2017-08-31T04:47:22+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:strcat&rev=1504154842&do=diff Description Concatenate two strings. Function prototype string strcat <string:str1> <string:str2> Arguments Name Type Comment str1 string The first part of the concatenated string. str2 string The second part of the concatenated string. Return value A string containing the contents of str1 followed by the contents of str2. text/html 2017-08-31T05:28:01+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:strcmp&rev=1504157281&do=diff Description Compare two strings, as with the strcmp function in C. Function prototype int strcmp <string:str1> <string:str2> Arguments Name Type Comment str1 string The first of the strings to be compared. str2 string The second of the strings to be compared. Return value * 0 if the strings are identical, * <0 if str1 is lexicographically less than str2, or; * >0 if str1 is lexicographically greater than str2. text/html 2017-08-31T05:47:32+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:stresc&rev=1504158452&do=diff Description Process escape sequences in a string. Function prototype string stresc <string:Text> Arguments Name Type Comment Text string The text string to be escaped. Return value A string containing the escaped text. Example string s set s "The newlines has been escaped\\r\\n...and so have the \\\"quotation marks\\\"" // echo the escaped text echo "Escaped:" echo <stresc s> // echo the unescaped text echo "Unescaped:" echo s text/html 2017-08-31T04:15:15+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:strfind&rev=1504152915&do=diff Description Find the position of a substring within a text string. Function prototype int strfind <string:Text> <string:TextToFind> <int:StartAt> Arguments Name Type Comment Text string A text string. TextToFind string A substring, the position of which in Text is to be found. StartAt int The zero-based starting position in Text to begin looking for TextToFind. Default is 0. Return value An integer containing the position of the start of TextToFind in Text… text/html 2017-08-31T06:05:43+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:strleft&rev=1504159543&do=diff Description Extract a substring of text from the start of a string (the 'left'). Function prototype string strleft <string:Text> <int:nChars> Arguments Name Type Comment Text string A text string. nChars int The number of characters to extract from the Text argument. Return value A string containing the desired range of the Text string. text/html 2017-08-31T05:43:40+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:strlen&rev=1504158220&do=diff Description Get the length of a string in characters. Function prototype int strlen <string:str> Arguments Name Type Comment str string A string, the length of which is to be determined. Return value An integer containing the length of str, in characters. text/html 2017-08-31T07:21:11+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:strlower&rev=1504164071&do=diff Description Convert a text string to lower case. Function prototype string strlower <string:Text> Arguments Name Type Comment Text string The text string to be converted to lower case. Return value A string containing the input text converted to lower case. text/html 2017-08-31T05:12:54+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:strreplace&rev=1504156374&do=diff Description Replace a substring of text within a string with another substring. Function prototype string strreplace <string:Text> <string:Old> <string:New> Arguments Name Type Comment Text string A string, a substring of which is to be replaced. Old string A substring of Text that is to be replaced. New string A string that is to replace Old within Text. Return value A string containing Text with all instances of Old replaced by New. text/html 2017-08-31T07:30:45+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:strright&rev=1504164645&do=diff Description Extract a substring of text from the end of a string (the 'right'). Function prototype string strright <string:Text> <int:nChars> Arguments Name Type Comment Text string A text string. nChars int The number of characters to extract from the Text argument. Return value A string containing the desired range of the Text string. text/html 2017-08-31T07:00:28+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:strsub&rev=1504162828&do=diff Description Extract a substring of text from a string. Function prototype string strsub <string:Text> <int:StartAt> <int:nChars> Arguments Name Type Comment Text string A text string. StartAt int The position in the string (zero-based) from which to begin extracting the substring. nChars int The number of characters to extract from the Text argument. Return value A string containing the desired range of the Text string. text/html 2017-08-31T06:22:09+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:strupper&rev=1504160529&do=diff Description Convert a text string to upper case. Function prototype string strupper <string:Text> Arguments Name Type Comment Text string The text string to be converted to UPPER CASE. Return value A string containing the input text converted to upper case. text/html 2017-08-31T04:29:26+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:sub&rev=1504153766&do=diff Description Subtract one number from another. Function prototype variant sub <variant:arg1> <variant:arg2> Arguments Name Type Comment arg1 variant A number. arg2 variant The number to be subtracted from arg1. arg1arg2subadd text/html 2017-08-31T04:29:50+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:tan&rev=1504153790&do=diff Description Calculate the tangent of an angle. Function prototype double tan <double:Angle> Arguments Name Type Comment Angle double An angle, in radians, the tangent of which is to be calculated. Return value The tangent of the angle, as a double. text/html 2017-08-31T05:23:38+00:00 http://www.bundysoft.com/wiki/doku.php?id=plugins:general:zeoscript:reference:functions:xor&rev=1504157018&do=diff Description The boolean 'xor' function returns true if one, and only one, of its two boolean arguments are true. Function prototype bool xor <bool:arg1> <bool:arg2> Arguments Name Type Comment arg1 bool The first boolean value. arg2 bool The second boolean value. Return value True if: