Recent changes to System functions

System functions modified by Kalle

Kalle — Sat, 04 May 2024 15:43:49 -0000

--- v75
+++ v76
@@ -32,7 +32,7 @@
 **putreg**    (string *regKey*, string *valueKeySubKey* \[, mixed *value*, number *datatype*=0\])    | bool  |  Create a new Windows registry entry into the tree of *regKey*. If *value*  is given then the second parameter is a value key, otherweise a sub key will be created. For values also a *datatype* can be given (0=String, 1=32 Bit Word, 2=64 Bit QuadWord, 3=Binary). On success true is returned. 
 **delreg**    (string *regKey*, string *valueKeySubKey*, number *mode*=0)    | bool  |  Delete a Windows registry entry from the tree of *regKey*.  Parameter *mode* can have following values: 0 =  Delete value key. 1 = Delete all values of sub key and sub key itself if it has no other sub keys. 2 = Delete complete sub key tree recursive. On success true is returned. 
 **error_reporting**    (number *id*)    |  true | Set the reporting of errors and warnings. *id* can have following values: 0 = no errors and warnings are shown, 1 = errors and warnings are shown.
-**security_mode**    (number *mode*)    |  true | Set the security mode. *mode* can have the following values: 0 = no security mode (default), 1 = temporary memory of files, sockets and processes will be blanked with zero bytes after the operation. This is useful to prevent reading sensitive data via memory dumps. Allthough you should take care to blank sensitive string variables manually with blankStr() function defined in lib/utils.inc.v1.
+**security_mode**    (number *mode*)    |  true | Set the security mode. *mode* can have the following values: 0 = no security mode (default), 1 = temporary memory of files, sockets and processes will be blanked with zero bytes after the operation. This is useful to prevent reading sensitive data via memory dumps. Allthough you should take care to blank sensitive string variables manually with blank() function, see [String functions](String%20functions/) .
 **version** (*type*=0)     |  mixed |      Return the version of V1 interpreter or operating system. If *type* is 0 then V1 version number will be returned as float value, for example 0.95. *type* can have the following further values: 1 = OS type will be returned as string, for example Windows or Linux. 2 = OS version will be retuned as float value, on Windows  Major.Minor, on Linux the kernel release. 3 = Return 1 if operating system is 64 Bit. 4 = Return detailed array with system information depending on OS type. Use print_r() function to get details.

 [back to Home](Welcome%20to%20V1%20Script/)

System functions modified by Kalle

Kalle — Sun, 27 Aug 2023 14:11:49 -0000

--- v74
+++ v75
@@ -17,7 +17,7 @@
 **eval**    (string *code*)    | mixed  | Evaluate V1 *code* without  tags and return the content of last operation. For example eval('10\*2;') will return 20.
 **call_user_func**    (string *name* \[, mixed *arg1*...\])    | mixed  | Call a user defined function by its *name*. Arguments and return value depend on the user defined implementation. If the function is not declared, the program will be aborted with error.
 **function_exists**    (string *function*)    | bool  | Return true if *function* exists. User functions and buildin functions will be checked.
-**exec**    (string *filename* \[, string&   *result*, number&  *exitCode*, mixed *stdInput*, number *stdInputLen*\])    | bool  | Execute a program *filename* . If parameters *result* and *exitCode* are given as references to  variables, then the output of the program and the exit code will be stored in these variables. If *stdInput*  is given, then the standard input of the program will be the content of this parameter. *stdInput* can be also a File or Socket handle.  Optional parameter *stdInputLen* set the length of input in bytes. On success true is returned.
+**exec**    (string *filename* \[, string&   *result*, number&  *exitCode*, mixed *stdInput*, number *stdInputLen*, string *envVars*\])    | bool  | Execute a program *filename* . If parameters *result* and *exitCode* are given as references to  variables, then the output of the program and the exit code will be stored in these variables. If *stdInput*  is given, then the standard input of the program will be the content of this parameter. *stdInput* can be also a File or Socket handle.  Optional parameter *stdInputLen* set the length of input in bytes. Optional *envVars* contain a list with environment variables in following format "KEY1=VALUE1\0KEY2=VALUE2\0\0". On success true is returned.
 **shellexec**    (string *filename*, string *operation*='open', bool *isHidden* = false)    | bool  | Execute a Windows shell programm. *filename* can be a executable or editable file, shortcut or URL. Optional parameter *operation* can have following values: open, edit, explore, print. If *isHidden* = true no window will be show. On success true is returned.  
 **system**    (string *filename*)    | string  | Execute a program *filename* and return the output of the program. On error false is returned.
 **dl**    (string *filename* \[,bool *fNative*=false\])    | number  | Load a module *filename*. File extension .dll on Windows and .so on Linux is not necessary. If *fNative* is true then a module number is returned which can be used in call() function. To load special V1 modules *fNative* must be false and no module number is returned. On error false is returned. 
@@ -32,6 +32,7 @@
 **putreg**    (string *regKey*, string *valueKeySubKey* \[, mixed *value*, number *datatype*=0\])    | bool  |  Create a new Windows registry entry into the tree of *regKey*. If *value*  is given then the second parameter is a value key, otherweise a sub key will be created. For values also a *datatype* can be given (0=String, 1=32 Bit Word, 2=64 Bit QuadWord, 3=Binary). On success true is returned. 
 **delreg**    (string *regKey*, string *valueKeySubKey*, number *mode*=0)    | bool  |  Delete a Windows registry entry from the tree of *regKey*.  Parameter *mode* can have following values: 0 =  Delete value key. 1 = Delete all values of sub key and sub key itself if it has no other sub keys. 2 = Delete complete sub key tree recursive. On success true is returned. 
 **error_reporting**    (number *id*)    |  true | Set the reporting of errors and warnings. *id* can have following values: 0 = no errors and warnings are shown, 1 = errors and warnings are shown.
+**security_mode**    (number *mode*)    |  true | Set the security mode. *mode* can have the following values: 0 = no security mode (default), 1 = temporary memory of files, sockets and processes will be blanked with zero bytes after the operation. This is useful to prevent reading sensitive data via memory dumps. Allthough you should take care to blank sensitive string variables manually with blankStr() function defined in lib/utils.inc.v1.
 **version** (*type*=0)     |  mixed |      Return the version of V1 interpreter or operating system. If *type* is 0 then V1 version number will be returned as float value, for example 0.95. *type* can have the following further values: 1 = OS type will be returned as string, for example Windows or Linux. 2 = OS version will be retuned as float value, on Windows  Major.Minor, on Linux the kernel release. 3 = Return 1 if operating system is 64 Bit. 4 = Return detailed array with system information depending on OS type. Use print_r() function to get details.

 [back to Home](Welcome%20to%20V1%20Script/)

System functions modified by Kalle

Kalle — Thu, 30 Jan 2020 18:44:53 -0000

--- v73
+++ v74
@@ -21,6 +21,7 @@
 **shellexec**    (string *filename*, string *operation*='open', bool *isHidden* = false)    | bool  | Execute a Windows shell programm. *filename* can be a executable or editable file, shortcut or URL. Optional parameter *operation* can have following values: open, edit, explore, print. If *isHidden* = true no window will be show. On success true is returned.  
 **system**    (string *filename*)    | string  | Execute a program *filename* and return the output of the program. On error false is returned.
 **dl**    (string *filename* \[,bool *fNative*=false\])    | number  | Load a module *filename*. File extension .dll on Windows and .so on Linux is not necessary. If *fNative* is true then a module number is returned which can be used in call() function. To load special V1 modules *fNative* must be false and no module number is returned. On error false is returned. 
+**dlsym**    (number *module*, string *symbol*)    | number  | Get pointer address of *symbol* in *module* loaded with dl() function. On success pointer address is returned. If symbol is not found false is returned. See also [Native function calling](Native%20function%20calling/).
 **call**    (number *module*, string *function*, array *paramDef* \[, mixed *arg1* ... \])    | mixed  | Call a native *function* of a *module* loaded with dl() function. The array *paramDef* defines the parameters and return code of native funtion:
 \[\[ 'type of param1' ... 'type of param N' ], 'type of return' ] For detailed description read manual [Native function calling](Native%20function%20calling/).
 **memat**    (number *position* \[,number *length*=0\])    | string  | Read memory data from *position*. If no *length* is given it stops on zero byte (0 terminated string) otherwise the length of bytes is read. Memory data is returned as string. Usually this function will be used to read memory data from pointers returned by native functions. For detailed description read manual [Native function calling](Native%20function%20calling/).
 **memref**    (string &*string*)    | number  | Return a reference pointer to memory of *string*. Usually this function will be used to make pointers for native functions. For detailed description read manual  [Native function calling](Native%20function%20calling/).

System functions modified by Kalle

Kalle — Tue, 19 Mar 2019 21:22:59 -0000

--- v72
+++ v73
@@ -16,6 +16,7 @@
 **require_once**    (string *filename*)    | bool  | Include a file if it was not included before and interprete it. If the *filename* does not exists, the program will be  aborted with error. Compatible with PHP require_once () function.
 **eval**    (string *code*)    | mixed  | Evaluate V1 *code* without  tags and return the content of last operation. For example eval('10\*2;') will return 20.
 **call_user_func**    (string *name* \[, mixed *arg1*...\])    | mixed  | Call a user defined function by its *name*. Arguments and return value depend on the user defined implementation. If the function is not declared, the program will be aborted with error.
+**function_exists**    (string *function*)    | bool  | Return true if *function* exists. User functions and buildin functions will be checked.
 **exec**    (string *filename* \[, string&   *result*, number&  *exitCode*, mixed *stdInput*, number *stdInputLen*\])    | bool  | Execute a program *filename* . If parameters *result* and *exitCode* are given as references to  variables, then the output of the program and the exit code will be stored in these variables. If *stdInput*  is given, then the standard input of the program will be the content of this parameter. *stdInput* can be also a File or Socket handle.  Optional parameter *stdInputLen* set the length of input in bytes. On success true is returned.
 **shellexec**    (string *filename*, string *operation*='open', bool *isHidden* = false)    | bool  | Execute a Windows shell programm. *filename* can be a executable or editable file, shortcut or URL. Optional parameter *operation* can have following values: open, edit, explore, print. If *isHidden* = true no window will be show. On success true is returned.  
 **system**    (string *filename*)    | string  | Execute a program *filename* and return the output of the program. On error false is returned.

System functions modified by Kalle

Kalle — Sat, 16 Mar 2019 21:39:23 -0000

--- v71
+++ v72
@@ -28,7 +28,7 @@
 **putenv**    (string *var*, string *value*)    | bool  | Set  the *value* of environment variable *var*. On success true is returned.
 **getreg**    (string *regKey* \[, string *valueKey*\])    | string / array  | Lookup a Windows registry key named with *regKey*. If *valueKey* is given then the value of the specified value key is returned, otherwise all  sub keys and all values are returned as array. Use print_r () to dump the array. Registry keys only work with backslashes, for example:  HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Run - If key was not found false is returned.
 **putreg**    (string *regKey*, string *valueKeySubKey* \[, mixed *value*, number *datatype*=0\])    | bool  |  Create a new Windows registry entry into the tree of *regKey*. If *value*  is given then the second parameter is a value key, otherweise a sub key will be created. For values also a *datatype* can be given (0=String, 1=32 Bit Word, 2=64 Bit QuadWord, 3=Binary). On success true is returned. 
-**delreg**    (string *regKey*, string *valueKeySubKey*, number *mode*=0)    | bool  |  Delete a Windows registry entry from the tree of *regKey*.  Parameter *mode* can be binary OR combined: 0x000:  Delete value key. 0x010: Delete all values of sub key and sub key itself if it has no other sub keys. 0x100: Delete complete sub key tree recursive. On success true is returned. 
+**delreg**    (string *regKey*, string *valueKeySubKey*, number *mode*=0)    | bool  |  Delete a Windows registry entry from the tree of *regKey*.  Parameter *mode* can have following values: 0 =  Delete value key. 1 = Delete all values of sub key and sub key itself if it has no other sub keys. 2 = Delete complete sub key tree recursive. On success true is returned. 
 **error_reporting**    (number *id*)    |  true | Set the reporting of errors and warnings. *id* can have following values: 0 = no errors and warnings are shown, 1 = errors and warnings are shown.
 **version** (*type*=0)     |  mixed |      Return the version of V1 interpreter or operating system. If *type* is 0 then V1 version number will be returned as float value, for example 0.95. *type* can have the following further values: 1 = OS type will be returned as string, for example Windows or Linux. 2 = OS version will be retuned as float value, on Windows  Major.Minor, on Linux the kernel release. 3 = Return 1 if operating system is 64 Bit. 4 = Return detailed array with system information depending on OS type. Use print_r() function to get details.

System functions modified by Kalle

Kalle — Fri, 15 Mar 2019 16:32:57 -0000

--- v70
+++ v71
@@ -22,6 +22,8 @@
 **dl**    (string *filename* \[,bool *fNative*=false\])    | number  | Load a module *filename*. File extension .dll on Windows and .so on Linux is not necessary. If *fNative* is true then a module number is returned which can be used in call() function. To load special V1 modules *fNative* must be false and no module number is returned. On error false is returned. 
 **call**    (number *module*, string *function*, array *paramDef* \[, mixed *arg1* ... \])    | mixed  | Call a native *function* of a *module* loaded with dl() function. The array *paramDef* defines the parameters and return code of native funtion:
 \[\[ 'type of param1' ... 'type of param N' ], 'type of return' ] For detailed description read manual [Native function calling](Native%20function%20calling/).
 **memat**    (number *position* \[,number *length*=0\])    | string  | Read memory data from *position*. If no *length* is given it stops on zero byte (0 terminated string) otherwise the length of bytes is read. Memory data is returned as string. Usually this function will be used to read memory data from pointers returned by native functions. For detailed description read manual [Native function calling](Native%20function%20calling/).
+**memref**    (string &*string*)    | number  | Return a reference pointer to memory of *string*. Usually this function will be used to make pointers for native functions. For detailed description read manual  [Native function calling](Native%20function%20calling/).
+**memset**    (number *position*, string *data*, \[,number *offset*=0\])    | number  | Set memory *data* at *position*. Optional *offset* is added to position. Size of *data* is returned. Usually this function will be used to write data on pointers returned by native functions. For detailed description read manual [Native function calling](Native%20function%20calling/).
 **getenv**    (string *var*)    | string  | Return the environment variable *var*. If variable does not exists false is returned.
 **putenv**    (string *var*, string *value*)    | bool  | Set  the *value* of environment variable *var*. On success true is returned.
 **getreg**    (string *regKey* \[, string *valueKey*\])    | string / array  | Lookup a Windows registry key named with *regKey*. If *valueKey* is given then the value of the specified value key is returned, otherwise all  sub keys and all values are returned as array. Use print_r () to dump the array. Registry keys only work with backslashes, for example:  HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Run - If key was not found false is returned.

System functions modified by Kalle

Kalle — Thu, 14 Mar 2019 11:01:31 -0000

--- v69
+++ v70
@@ -21,7 +21,7 @@
 **system**    (string *filename*)    | string  | Execute a program *filename* and return the output of the program. On error false is returned.
 **dl**    (string *filename* \[,bool *fNative*=false\])    | number  | Load a module *filename*. File extension .dll on Windows and .so on Linux is not necessary. If *fNative* is true then a module number is returned which can be used in call() function. To load special V1 modules *fNative* must be false and no module number is returned. On error false is returned. 
 **call**    (number *module*, string *function*, array *paramDef* \[, mixed *arg1* ... \])    | mixed  | Call a native *function* of a *module* loaded with dl() function. The array *paramDef* defines the parameters and return code of native funtion:
 \[\[ 'type of param1' ... 'type of param N' ], 'type of return' ] For detailed description read manual [Native function calling](Native%20function%20calling/).
-**memat**    (number *position* \[,number *length*=0\])    | string  | Read memory data from *position*. If no *length* is given it stops on zero byte (0 terminated string) otherwise the length of bytes is read. Memory data is returned as string. Usually this function will be used to read memory data from pointers returned by native functions. For detailed description read manual[Native function calling](Native%20function%20calling/).
+**memat**    (number *position* \[,number *length*=0\])    | string  | Read memory data from *position*. If no *length* is given it stops on zero byte (0 terminated string) otherwise the length of bytes is read. Memory data is returned as string. Usually this function will be used to read memory data from pointers returned by native functions. For detailed description read manual [Native function calling](Native%20function%20calling/).
 **getenv**    (string *var*)    | string  | Return the environment variable *var*. If variable does not exists false is returned.
 **putenv**    (string *var*, string *value*)    | bool  | Set  the *value* of environment variable *var*. On success true is returned.
 **getreg**    (string *regKey* \[, string *valueKey*\])    | string / array  | Lookup a Windows registry key named with *regKey*. If *valueKey* is given then the value of the specified value key is returned, otherwise all  sub keys and all values are returned as array. Use print_r () to dump the array. Registry keys only work with backslashes, for example:  HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Run - If key was not found false is returned.

System functions modified by Kalle

Kalle — Thu, 14 Mar 2019 11:00:51 -0000

--- v68
+++ v69
@@ -19,7 +19,9 @@
 **exec**    (string *filename* \[, string&   *result*, number&  *exitCode*, mixed *stdInput*, number *stdInputLen*\])    | bool  | Execute a program *filename* . If parameters *result* and *exitCode* are given as references to  variables, then the output of the program and the exit code will be stored in these variables. If *stdInput*  is given, then the standard input of the program will be the content of this parameter. *stdInput* can be also a File or Socket handle.  Optional parameter *stdInputLen* set the length of input in bytes. On success true is returned.
 **shellexec**    (string *filename*, string *operation*='open', bool *isHidden* = false)    | bool  | Execute a Windows shell programm. *filename* can be a executable or editable file, shortcut or URL. Optional parameter *operation* can have following values: open, edit, explore, print. If *isHidden* = true no window will be show. On success true is returned.  
 **system**    (string *filename*)    | string  | Execute a program *filename* and return the output of the program. On error false is returned.
-**dl**    (string *filename*)    | bool  | Load a V1 module DLL *filename*. On error false is returned.
+**dl**    (string *filename* \[,bool *fNative*=false\])    | number  | Load a module *filename*. File extension .dll on Windows and .so on Linux is not necessary. If *fNative* is true then a module number is returned which can be used in call() function. To load special V1 modules *fNative* must be false and no module number is returned. On error false is returned. 
+**call**    (number *module*, string *function*, array *paramDef* \[, mixed *arg1* ... \])    | mixed  | Call a native *function* of a *module* loaded with dl() function. The array *paramDef* defines the parameters and return code of native funtion:
 \[\[ 'type of param1' ... 'type of param N' ], 'type of return' ] For detailed description read manual [Native function calling](Native%20function%20calling/).
+**memat**    (number *position* \[,number *length*=0\])    | string  | Read memory data from *position*. If no *length* is given it stops on zero byte (0 terminated string) otherwise the length of bytes is read. Memory data is returned as string. Usually this function will be used to read memory data from pointers returned by native functions. For detailed description read manual[Native function calling](Native%20function%20calling/).
 **getenv**    (string *var*)    | string  | Return the environment variable *var*. If variable does not exists false is returned.
 **putenv**    (string *var*, string *value*)    | bool  | Set  the *value* of environment variable *var*. On success true is returned.
 **getreg**    (string *regKey* \[, string *valueKey*\])    | string / array  | Lookup a Windows registry key named with *regKey*. If *valueKey* is given then the value of the specified value key is returned, otherwise all  sub keys and all values are returned as array. Use print_r () to dump the array. Registry keys only work with backslashes, for example:  HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Run - If key was not found false is returned.

System functions modified by Kalle

Kalle — Sun, 16 Dec 2018 19:06:45 -0000

--- v67
+++ v68
@@ -26,6 +26,6 @@
 **putreg**    (string *regKey*, string *valueKeySubKey* \[, mixed *value*, number *datatype*=0\])    | bool  |  Create a new Windows registry entry into the tree of *regKey*. If *value*  is given then the second parameter is a value key, otherweise a sub key will be created. For values also a *datatype* can be given (0=String, 1=32 Bit Word, 2=64 Bit QuadWord, 3=Binary). On success true is returned. 
 **delreg**    (string *regKey*, string *valueKeySubKey*, number *mode*=0)    | bool  |  Delete a Windows registry entry from the tree of *regKey*.  Parameter *mode* can be binary OR combined: 0x000:  Delete value key. 0x010: Delete all values of sub key and sub key itself if it has no other sub keys. 0x100: Delete complete sub key tree recursive. On success true is returned. 
 **error_reporting**    (number *id*)    |  true | Set the reporting of errors and warnings. *id* can have following values: 0 = no errors and warnings are shown, 1 = errors and warnings are shown.
-**version** ()     |  number |      Return the Version number of V1 as floating point number. For example: 0.9 
+**version** (*type*=0)     |  mixed |      Return the version of V1 interpreter or operating system. If *type* is 0 then V1 version number will be returned as float value, for example 0.95. *type* can have the following further values: 1 = OS type will be returned as string, for example Windows or Linux. 2 = OS version will be retuned as float value, on Windows  Major.Minor, on Linux the kernel release. 3 = Return 1 if operating system is 64 Bit. 4 = Return detailed array with system information depending on OS type. Use print_r() function to get details.

 [back to Home](Welcome%20to%20V1%20Script/)

System functions modified by Kalle

Kalle — Wed, 05 Dec 2018 15:00:11 -0000

--- v66
+++ v67
@@ -3,8 +3,8 @@
 Function/Arguments   |  Return | Description
 --------------------- |---------------- | ---------- 
 **print**    (mixed *arg1*...)    |  1 | Print  one or more arguments  to screen respective the standard output.
-**printf**    (string *format*, mixed *arg1*...)    |  string  | Print  one or more arguments formatted to screen and return as string. Modifiers j, n, p are ignored. Formats are compatible with  [C++ printf](http://www.cplusplus.com/reference/cstdio/printf/)
-**sprintf**    (string *format*, mixed *arg1*...)    |  string | Format one or more arguments and return as string. Formats are compatible with  [C++ printf](http://www.cplusplus.com/reference/cstdio/printf/)
+**printf**    (string *format*, mixed *arg1*...)    |  string  | Print  one or more arguments formatted to screen and return as string. Modifiers j, n, p are ignored. Modifiers are compatible with  [C++ printf](http://www.cplusplus.com/reference/cstdio/printf/)
+**sprintf**    (string *format*, mixed *arg1*...)    |  string | Format one or more arguments and return as string. Modifiers j, n, p are ignored. Modifiers are compatible with  [C++ printf](http://www.cplusplus.com/reference/cstdio/printf/)
 **print_r**   (mixed arg, bool asString=false)    |  string / bool | Print the content of a variable to screen. The difference to print () is that  also Arrays are displayed in a user friendly format. If *asString* = true then the content is returned as string and not printed to screen. Otherwise true is returned.
 **sscanf**    (string *string*, string *format* \[, mixed& *arg1* ...])    |  mixed | Parses input from a *string* according to a *format*. Modifiers j, n, p, \* are ignored. Function is compatible with [PHP sscanf](http://php.net/manual/en/function.sscanf.php)
 **console_echo**    (bool *echo*)    |  true | Enable or disable the *echo* of  keyboard within input() function. Usefull for passwords.