new example: exporting an ilo block set

FossilOrigin-Name: 47f47e23e9fdde76777ca40072c6c90f9a95ab7f077c8b89b29e70f564031bdf
This commit is contained in:
crc 2023-11-02 15:22:25 +00:00
parent a42cbb1b6a
commit d3cb959ad0
2 changed files with 74 additions and 0 deletions

View file

@ -30,5 +30,6 @@
- in retro-muri.c, use bsd_strlcpy (rep by fangchar)
- in retro.forth, fix `s:index/char` (rep by fangchar)
- add example/irc-logger.retro
- add example/ilo-export.retro
================================================================

73
example/ilo-export.retro Executable file
View file

@ -0,0 +1,73 @@
#!/usr/bin/env retro
My Konilo system uses block for data storage. It's sometimes
useful to export these to smaller sets for sharing. This is a
small program written in RetroForth that will do this.
I organize the blocks into groups of 16. This tool will export
a group to a file.
Invocation:
retro ilo-export.retro <first-block> to <file-name>
----
Begin by verifying the provided parameters.
~~~
:s:numeric? (s-f) #-1 swap [ c:digit? and ] s:for-each ;
script:arguments #3 eq?
[ 'Too_few_parameters s:put nl bye ] -if
#0 script:get-argument s:numeric?
[ 'First_parameter_must_be_a_number s:put nl bye ] -if
#1 script:get-argument 'to s:eq?
[ 'Second_parameter_must_be_'to' s:put nl bye ] -if
~~~
Next, open the target file and the `ilo.blocks`.
~~~
'FID var
#2 script:get-argument file:open-for-writing !FID
'ilo.blocks block:set-file
~~~
Next define a few words to unpack and write cells to the file.
~~~
:write-byte (n-) @FID file:write ;
:mask (n-) #255 and ;
:write-cell (n-)
dup mask write-byte
#8 shift dup mask write-byte
#8 shift dup mask write-byte
#8 shift mask write-byte ;
~~~
Then create a place to read blocks into and process the blocks.
~~~
#0 script:get-argument s:to-number 'STARTING const
'Buffer d:create #1024 allot
:read STARTING I n:add &Buffer block:read ;
:write &Buffer #1024 [ fetch-next write-cell ] times drop ;
#16 [ read write ] indexed-times
~~~
Clean up.
~~~
@FID file:close
bye
~~~