Differences

This shows you the differences between two versions of the page.

--- doc:lua_make-your-own-scripts [2015/11/15 13:49] – [Miscellaneous Commands] admin
+++ doc:lua_make-your-own-scripts [2019/04/08 18:43] (current) – [The IO Commands] admin
@@ Line 136: / Line 136: @@
-==== The Communication  Commands ====
+==== The Communication Commands ====
@@ Line 192: / Line 192: @@
-^  filename  ^  message  ^  Effect  |  |
+^  filename  ^  message  ^  Effect  |
-|/unix-path/.. |any message |Open a file Open dialog with preselected path (and file). At success returns the file path, otherwise null |  |
+|/unix-path/.. |any message |Open a file Open dialog with preselected path (and file). At success returns the file path, otherwise null |
-|/unix-path/.. |'direct' |Open the given file without Dialog, At success returns the file path, otherwise null |  |
+|/unix-path/.. |'direct' |Open the given file without Dialog, At success returns the file path, otherwise null  \\ actual either complete path are supported, relative paths or filenames only. Filenames and relative paths are relative to the actual script directory |
-|URL like ''HTTP:<nowiki>//</nowiki>''.. |'html' |Reads the URL as input.At  success returns the URL, otherwise null ||
+|URL like ''HTTP:<nowiki>//</nowiki>''.. |'html' |Reads the URL as input.At  success returns the URL, otherwise null |
-|URL like ''HTTP:<nowiki>//</nowiki>''.. |a lua table |JSON-RFC call: If the parameter message is a lua table, it's translated into a JSON string and send as POST to the given URL. After evaluation, the server returns a JSON string converted into a lua table and returned by the function |  |
+|URL like ''HTTP:<nowiki>//</nowiki>''.. or ''file:<nowiki>//</nowiki>''..|'json' |JSON-RFC call: The parameter ''file_extension'' can be a lua table or a JSON string, in case of a lua table, it's translated into a JSON string and send as POST to the given URL. In case of a file:<nowiki>//</nowiki>- URL, the local file is read as a JSON file |
+After opening the file with IOInput(), it can be read with ioRead()
 === ioRead("%%*%%line") ===
-Read one line of the input file ending with either %%\%%r%%\%%n or %%\%%n as string without the EOL. In case of input EOF or read errors the function returns nil
+Read one line of the input file ending with either<nowiki> \</nowiki>r<nowiki>\</nowiki>n or<nowiki> \</nowiki>n as string without the EOL. In case of input EOF or read errors the function returns nil. By this the whole file can be read line per line
 === ioRead ("%%*%%all") ===
@@ Line 211: / Line 211: @@
-=== ioRead (count) ===
+=== ioRead ("%%*%%json") ===
+Here it's assumed that the input file consists of a JSON string containing data. This string is translated into a lua table structure and returned
-Read count number of bytes as string
+=== ioRead ("%%*%%sha256") ===
-=== ioOutput(URL[,append[,message]]) ===
+This mainly for testing purposes. It returns the sha256 checksum of that file
-Try to opens ''URL'' as output. A ''SCRIPT:<nowiki>//</nowiki>'' URL is readonly and so not allowed as output. If append is TRUE, the output is appended to an already existing file. If the given file path is empty or just a directory, a file dialog opens. If given, the message is used in the dialog as title
+\\
-=== ioWrite (String) ===
+==== The Buffer Commands ====
-Attaches the string content to the output file
+FIXME this whole Buffer section is not implemented and actual just here as a reference for discussion