sinilo

+----+-----------+------------------+---------------------------+ | Sc | Name | Stack | Description | +====+===========+==================+===========================+ | 0 | open | addr mode -- h | Open a file. mode: | | | | | 0=read, 1=write, 2=append | | 1 | close | h -- | Close a file | | 2 | getc | h -- c | Read one char; -1 at EOF | | 3 | putc | c h -- | Write one char | | 4 | size | h -- n | File size in cells; | | | | | -1 for pipes | | 5 | tell | h -- pos | Current position in cells | | 6 | seek | pos h -- | Seek to cell pos from start| | 7 | exists? | addr -- f | -1 if file exists, 0 if not| | 8 | delete | addr -- | Delete a file | | 9 | rename | from to -- | Rename a file | | 10 | open-pipe | addr mode -- h | Open a pipe via popen. | | | | | mode: 0=read, 1=write | +----+-----------+------------------+---------------------------+

This device is optional. It provides TCP socket access. Sockets, like files, use handles from the same handle table as the file I/O device. Handles obtained from socket operations can be read and written using the file I/O device's getc and putc sub-commands (2 and 3). Sub-commands: +----+-------------+------------------+---------------------------+ | Sc | Name | Stack | Description | +====+=============+==================+===========================+ | 0 | connect | host port -- h | Connect to host:port | | 1 | close | h -- | Close socket (reuses hfs | | | | | close, sub-command 1) | +----+-------------+------------------+---------------------------+

+----+---------+------------------+--------------------------------+ | Sc | Name | Stack | Description | +====+=========+==================+================================+ | 0 | time | -- n | Unix timestamp in seconds | | 1 | time-ms | -- n | Milliseconds since epoch | +----+---------+------------------+--------------------------------+

+----+---------+-------------------+------------------------------+ | Sc | Name | Stack | Description | +====+=========+===================+==============================+ | 0 | push | n -- ( -- f) | Cell bits → float stack | | 1 | pop | -- n (f -- ) | Float stack → cell bits | | 2 | add | (ab -- c) | Float add | | 3 | sub | (ab -- c) | Float subtract | | 4 | mul | (ab -- c) | Float multiply | | 5 | div | (ab -- c) | Float divide | | 6 | floor | (f -- f) | Round toward negative inf | | 7 | ceil | (f -- f) | Round toward positive inf | | 8 | sqrt | (f -- f) | Square root | | 9 | to-int | n -- m (f -- ) | Convert float to integer | | 10 | from-int| m -- ( -- f) | Convert integer to float | | 11 | sin | (f -- f) | Sine | | 12 | cos | (f -- f) | Cosine | | 13 | tan | (f -- f) | Tangent | | 14 | asin | (f -- f) | Arcsine | | 15 | acos | (f -- f) | Arccosine | | 16 | atan | (f -- f) | Arctangent | | 17 | atan2 | (ab -- c) | Two-argument arctangent | | 18 | log | (f -- f) | Natural logarithm | | 19 | pow | (ab -- c) | a raised to the power b | | 20 | depth | -- n | Depth of float stack | +----+---------+-------------------+------------------------------+

The reference host accepts an optional script file and any number of arguments after it on the command line: r13 [--rom romfile] [--blocks blockfile] [scriptname [args...]] When a script is given, its contents are filtered through the unu literate format (only lines inside ~~~ fenced blocks are kept) and fed into io 1 ahead of standard input. After the script buffer is exhausted, io 1 falls through to stdin as normal. The args device exposes the script name and any trailing arguments to the running image. script_argv[0] is always the script name; script_argv[1..n-1] are the extra arguments. Sub-commands: +----+---------+------------------+--------------------------------+ | Sc | Name | Stack | Description | +====+=========+==================+================================+ | 0 | count | -- n | Total arg count including name | | 1 | fetch | n addr -- | Copy arg n as null-term cells | | | | | to image address addr. | | | | | n=0 is the script name. | +----+---------+------------------+--------------------------------+ If no script was given, count returns 0 and fetch copies an empty string for any index.

+----+---------+------------------+--------------------------------+ | Sc | Name | Stack | Description | +====+=========+==================+================================+ | 0 | next | -- n | Next random 64-bit value | | 1 | seed | n -- | Reseed the generator | +----+---------+------------------+--------------------------------+