octoleo
/
telegram-bot-bash
mirror of https://github.com/octoleo/telegram-bot-bash.git
1
1
Fork 0
Code Issues Projects Releases Wiki Activity

update docs

This commit is contained in:
Kay Marquardt (Gnadelwartz) 2020-06-01 12:00:37 +02:00
parent 31b3203483
commit dddd1ce2de
1 changed files with 12 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
doc/6_reference.md
View File

@ -480,7 +480,7 @@ and only the last one is written back to the file.
fast functions: fast functions:
``` ```
jssh_insertDB , jssh_addKeyDB , jssh_countKeyDB jssh_insertKeyDB , jssh_addKeyDB , jssh_countKeyDB
``` ```
slow functions: slow functions:
@ -519,9 +519,11 @@ Creats new empty jsshDB file if not exist.
*usage:* jssh_newDB "filename" *usage:* jssh_newDB "filename"
##### jssh_checkDB ##### jssh_checkDB
Check if DB name respects the rules mentioned above and returns the real/final path to DB file. Check if DB name respects the rules mentioned above and print to STDOUT the real/final path to DB file.
Used internally by all jssh DB functions, but can also used to get the real filename for a jssh DB. Used internally by all jssh DB functions, but can also used to get the real filename for a jssh DB.
An error is returned and nothing is printed if the given filename is not valid
*usage:* jssh_checkDB "filename" *usage:* jssh_checkDB "filename"
```bash ```bash
@ -689,18 +691,20 @@ jssh_printDB READVALUES
["whynot","subindex1"] "whynot A" ["whynot","subindex1"] "whynot A"
``` ```
##### jssh_insertDB ##### jssh_insertKeyDB
Insert, update, append a key=value pair to a jsshDB file, key name is only allowed to contain '-a-zA-Z0-9,._' Insert, update, append a key=value pair to a jsshDB file, key name is only allowed to contain '-a-zA-Z0-9,._'
*usage:* jssh_insertDB "key" "value" "filename" *usage:* jssh_insertKeyDB "key" "value" "filename"
*usage:* jssh_insertDB_asnyc "key" "value" "filename" *usage:* jssh_insertKeyDB_asnyc "key" "value" "filename"
Note: insertDB uses also excusiv write locking, but with a maximum timeout of 2s. insertDB is a "fast" operation, simply adding the value to the end of the file. *deprecated:* jssh_insertDB *was renamed in verion 0.96 to* jssh_insertKeyDB
Note: inserKeytDB uses also excusive write locking, but with a maximum timeout of 2s. insertKeyDB is a "fast" operation, simply adding the value to the end of the file.
*example:* *example:*
```bash ```bash
jssh_insertDB "newkey" "an other value" "${DATADIR:-.}/myvalues" jssh_insertKeyDB "newkey" "an other value" "${DATADIR:-.}/myvalues"
``` ```
##### jssh_deleteKeyDB ##### jssh_deleteKeyDB
@ -1019,5 +1023,5 @@ The name of your bot is availible as bash variable "$ME", there is no need to ca
#### [Prev Best Practice](5_practice.md) #### [Prev Best Practice](5_practice.md)
#### [Next Notes for Developers](7_develop.md) #### [Next Notes for Developers](7_develop.md)
#### $$VERSION$$ 0.96-dev2-4-g2a3dcaa #### $$VERSION$$ 0.96-dev2-12-g31b3203