Difference between revisions of "Python built-in Lianja/VFP functions"
From Lianjapedia
Yvonne.milne (Talk | contribs) (→Functions) |
Yvonne.milne (Talk | contribs) (→Functions) |
||
Line 53: | Line 53: | ||
|valign="top"|kvs_getrange()||valign="top"|kvsid as numeric,<br>offset as numeric,<br>count as numeric||valign="top"|Fetch a range of key/value pairs (offset starts at 1). Returns an array of two elements, key and value. | |valign="top"|kvs_getrange()||valign="top"|kvsid as numeric,<br>offset as numeric,<br>count as numeric||valign="top"|Fetch a range of key/value pairs (offset starts at 1). Returns an array of two elements, key and value. | ||
|- | |- | ||
− | |valign="top"|kvs_getRange()||valign="top"| ||valign="top"|Fetch a range of key/value pairs (offset starts at 1). Returns an array of two elements, key and value. | + | |valign="top"|kvs_getRange()||valign="top"|kvsid as numeric,<br>offset as numeric,<br>count as numeric||valign="top"|Fetch a range of key/value pairs (offset starts at 1). Returns an array of two elements, key and value. |
|- | |- | ||
− | |valign="top"|kvs_info()||valign="top"| ||valign="top"|Displays information about the specified KVS file. | + | |valign="top"|kvs_info()||valign="top"|kvsid as numeric||valign="top"|Displays information about the specified KVS file. |
|- | |- | ||
− | |valign="top"|kvs_isvalid()||valign="top"| ||valign="top"|Check validity of the given ksvid. | + | |valign="top"|kvs_isvalid()||valign="top"|kvsid as numeric||valign="top"|Check validity of the given ksvid. |
|- | |- | ||
− | |valign="top"|kvs_keys()||valign="top"| ||valign="top"|Fetch all keys for the specified key. keyPattern may end in * to match wildcard keys. | + | |valign="top"|kvs_keys()||valign="top"|kvsid as numeric<br>[, key as string | keyPattern as string]||valign="top"|Fetch all keys for the specified key. keyPattern may end in * to match wildcard keys. |
|- | |- | ||
− | |valign="top"|kvs_list()||valign="top"| ||valign="top"|List the key/values in the store to the console (useful during development for debugging). | + | |valign="top"|kvs_list()||valign="top"|kvsid as numeric||valign="top"|List the key/values in the store to the console (useful during development for debugging). |
|- | |- | ||
− | |valign="top"|kvs_listlog()||valign="top"| ||valign="top"|List binary transaction log associated with the store to the console (useful during development for debugging). | + | |valign="top"|kvs_listlog()||valign="top"|kvsid as numeric||valign="top"|List binary transaction log associated with the store to the console (useful during development for debugging). |
|- | |- | ||
− | |valign="top"|kvs_listLog()||valign="top"| ||valign="top"|List binary transaction log associated with the store to the console (useful during development for debugging). | + | |valign="top"|kvs_listLog()||valign="top"|kvsid as numeric||valign="top"|List binary transaction log associated with the store to the console (useful during development for debugging). |
|- | |- | ||
− | |valign="top"|kvs_loadfromfile()||valign="top"| ||valign="top"|Load key/value pairs from the specified file. | + | |valign="top"|kvs_loadfromfile()||valign="top"|kvsid as numeric,<br>filename as string||valign="top"|Load key/value pairs from the specified file. |
|- | |- | ||
− | |valign="top"|kvs_loadFromFile()||valign="top"| ||valign="top"|Load key/value pairs from the specified file. | + | |valign="top"|kvs_loadFromFile()||valign="top"|kvsid as numeric,<br>filename as string||valign="top"|Load key/value pairs from the specified file. |
|- | |- | ||
− | |valign="top"|kvs_max()||valign="top"| ||valign="top"|Returns max key. | + | |valign="top"|kvs_max()||valign="top"|kvsid as numeric||valign="top"|Returns max key. |
|- | |- | ||
− | |valign="top"|kvs_min()||valign="top"| ||valign="top"|Returns min key. | + | |valign="top"|kvs_min()||valign="top"|kvsid as numeric||valign="top"|Returns min key. |
|- | |- | ||
− | |valign="top"|kvs_next()||valign="top"| ||valign="top"|Position on next key/value pair returns an array of two elements: key and value. | + | |valign="top"|kvs_next()||valign="top"|kvsid as numeric||valign="top"|Position on next key/value pair returns an array of two elements: key and value. |
|- | |- | ||
− | |valign="top"|kvs_open()||valign="top"| ||valign="top"|Open an existing KVS. shared allows the KVS to be opened shared/exclusive. | + | |valign="top"|kvs_open()||valign="top"|kvsfilename as string<br>[, shared as logical]||valign="top"|Open an existing KVS. shared allows the KVS to be opened shared/exclusive. |
|- | |- | ||
|valign="top"|kvs_rebuild()||valign="top"| ||valign="top"|Rebuild the KVS file from the binary transaction log. | |valign="top"|kvs_rebuild()||valign="top"| ||valign="top"|Rebuild the KVS file from the binary transaction log. |
Revision as of 11:03, 5 March 2024
Under construction
Overview
See Also
Functions
The following LianjaScript functions are built into Lianja Python.
The function names are case-sensitive - in some cases more than one format is supported.
Function | Arguments | Description |
---|---|---|
createObject() | ||
die() | ||
echo() | ||
filetostr() | ||
getparameter() | ||
getParameter() | ||
kvs_add() | kvsid as numeric, key as string | key as numeric, value as objectname | value as arrayname | value as expression |
Add key/value for the specified key. If the value is an object or array it is automatically JSON encoded. To load the contents of a text file, you can use the filetostr() function which is built-in in Lianja/Python. kvs_add(k, key, filetostr("filename.txt") ) |
kvs_clear() | kvsid as numeric | Remove all key/value pairs from the store. |
kvs_close() | kvsid as numeric | Close the KVS. |
kvs_contains() | kvsid as numeric, key as string | key as numeric |
Returns true if key contained in the store. |
kvs_count() | kvsid as numeric | Returns count of number of key/value pairs in the store. |
kvs_create() | kvsfilename as string, keylen as numeric [, enablelogging as logical] |
Create a new KVS with keys of keylen length. Returns a numeric kvsid. |
kvs_generate() | kvsid as numeric, count as numeric |
Generate count new key/value pairs. |
kvs_get() | kvsid as numeric, key as string | key as numeric [, default as string [, membername as string]] |
Fetch value for the specified key. If the value is an object then membername specifies a member (property) to return. |
kvs_getall() | kvsid as numeric [, key as string | keyPattern as string] |
Fetch all keys/values for the specified key. keyPattern may end in * to match wildcard keys. Returns a dynarray of arrays. |
kvs_getAll() | kvsid as numeric [, key as string | keyPattern as string] |
Fetch all keys/values for the specified key. keyPattern may end in * to match wildcard keys. Returns a dynarray of arrays. |
kvs_getrange() | kvsid as numeric, offset as numeric, count as numeric |
Fetch a range of key/value pairs (offset starts at 1). Returns an array of two elements, key and value. |
kvs_getRange() | kvsid as numeric, offset as numeric, count as numeric |
Fetch a range of key/value pairs (offset starts at 1). Returns an array of two elements, key and value. |
kvs_info() | kvsid as numeric | Displays information about the specified KVS file. |
kvs_isvalid() | kvsid as numeric | Check validity of the given ksvid. |
kvs_keys() | kvsid as numeric [, key as string | keyPattern as string] |
Fetch all keys for the specified key. keyPattern may end in * to match wildcard keys. |
kvs_list() | kvsid as numeric | List the key/values in the store to the console (useful during development for debugging). |
kvs_listlog() | kvsid as numeric | List binary transaction log associated with the store to the console (useful during development for debugging). |
kvs_listLog() | kvsid as numeric | List binary transaction log associated with the store to the console (useful during development for debugging). |
kvs_loadfromfile() | kvsid as numeric, filename as string |
Load key/value pairs from the specified file. |
kvs_loadFromFile() | kvsid as numeric, filename as string |
Load key/value pairs from the specified file. |
kvs_max() | kvsid as numeric | Returns max key. |
kvs_min() | kvsid as numeric | Returns min key. |
kvs_next() | kvsid as numeric | Position on next key/value pair returns an array of two elements: key and value. |
kvs_open() | kvsfilename as string [, shared as logical] |
Open an existing KVS. shared allows the KVS to be opened shared/exclusive. |
kvs_rebuild() | Rebuild the KVS file from the binary transaction log. | |
kvs_remove() | Remove the specified key. | |
kvs_removefirst() | Use for queue. Returns an array of two elements: key and value. | |
kvs_removeFirst() | Use for queue. Returns an array of two elements: key and value. | |
kvs_removelast() | Use for stack. Returns an array of two elements: key and value. | |
kvs_removeLast() | Use for stack. Returns an array of two elements: key and value. | |
kvs_removerange() | Fetch a range of key/value pairs (offset starts at 1). | |
kvs_removeRange() | Fetch a range of key/value pairs (offset starts at 1). | |
kvs_rewind() | Position on first key/value pair. Returns an array of two elements: key and value. | |
kvs_savetofile() | Save key/value pairs to the specified file. | |
kvs_saveToFile() | Save key/value pairs to the specified file. | |
kvs_set() | Add/update key/value for the specified key. If the value is an object or array, it is automatically JSON encoded. | |
kvs_update() | Update value for the specified key. If the value is an object or array, it is automatically JSON encoded. | |
kvs_values() | Fetch all values for the specified key. keyPattern may end in * to match wildcard keys. | |
move_uploaded_file() | ||
odata_Create() | ||
odata_Delete() | ||
odata_Read() | ||
odata_Update() | ||
openDatabase() | ||
strtofile() | ||
unlink() |
Desktop Only Functions
The following LianjaScript functions are built into Lianja Python for desktop Apps only.
Function | Arguments | Description |
---|---|---|
bindEvent() | tbc | tbc. |
clear_events() | none | Stops event processing started with read_events(). |
debug() | text as string | Writes the specified text to the debug file (set debug on). |
debugout() | text as string | Writes the specified text to the Troubleshooter Debugout Tab. |
inputBox() | [prompt as string] | Display a box prompting for input. The prompt can optionally be specified; the default prompt is 'Enter value:' |
messageBox() | message as string [, options as numeric [, title as string]] |
Display a message in a box with an optional title. See MESSAGEBOX() for the numeric options to customize the buttons and icon and for the return values. |
read_events() | none | Suspends execution until a clear_events() is executed. |