2023-02-05 06:44:37 -05:00
|
|
|
Creole is a bytecode designed for simple implementations.
|
|
|
|
|
|
|
|
## Bytecode Format
|
|
|
|
|
|
|
|
Each creole line consists of pseudo-UTF-8 characters. The first byte
|
|
|
|
is an unsigned number between 0 and 127 (the high bit is clear). Each
|
|
|
|
suceeding pseudo-UTF-8 character is encoded as follows:
|
|
|
|
|
2023-02-06 23:50:50 -05:00
|
|
|
* `110HHHHx 10xxxxxx`
|
|
|
|
* `1110HHHH 10xxxxxx 10xxxxxx`
|
|
|
|
* `11110HHH 10Hxxxxx 10xxxxxx 10xxxxxx`
|
|
|
|
* `111110HH 10HHxxxx 10xxxxxx 10xxxxxx 10xxxxxx`
|
|
|
|
* `1111110H 10HHHxxx 10xxxxxx 10xxxxxx 10xxxxxx 10xxxxxx`
|
|
|
|
* `11111110 10HHHHxx 10xxxxxx 10xxxxxx 10xxxxxx 10xxxxxx 10xxxxxx`
|
2023-02-05 06:44:37 -05:00
|
|
|
|
|
|
|
The first four bytes determine the type:
|
|
|
|
|
|
|
|
* `0`: Value is a register.
|
|
|
|
* `1`: Value is immediate.
|
|
|
|
|
|
|
|
All other values are reserved. Overlong values are allowed, and for some
|
|
|
|
argument values they are necessary. All lines are terminated by a byte
|
|
|
|
of all zeros.
|
2023-02-07 11:38:04 -05:00
|
|
|
|
|
|
|
## Design Philsophy
|
|
|
|
|
|
|
|
Creole is small but not minimal. It is easy to add instructions, and
|
|
|
|
the amount of labels, registers, and stack space can changed at runtime.
|
|
|
|
System calls can be added dynamically, but static instructions that take
|
|
|
|
at most 3 arguments should be hard-coded.
|