https://github.com/vyo/kairos

A Java-based interpreter for Whitespace and WhitespaceAssembler.
https://github.com/vyo/kairos

Last synced: about 1 month ago
JSON representation

A Java-based interpreter for Whitespace and WhitespaceAssembler.

• Host: GitHub
• URL: https://github.com/vyo/kairos
• Owner: vyo
• License: mit
• Created: 2014-05-10T13:51:25.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2016-02-24T23:19:06.000Z (over 8 years ago)
• Last Synced: 2023-10-24T21:40:40.466Z (about 1 year ago)
• Language: Java
• Homepage:
• Size: 117 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Kairos

======

A Java-based interpreter for Whitespace and WhitespaceAssembler

Part 1: WhitespaceAssembler command overview

------

**Stack** operations

Operation|Breakdown|Aliases

---------|---------|---------

'push X'|push value X onto stack|#X

'dupl'|duplicate value on top of stack|duplicate, dupe, cc

'copy X'|copy X-th value onto stack|cp X

'swap'|swap top two items of stack|sw

'pop'|discard top item from stack|p

'slide X'|discard X items after top item from stack|sl X

**Arithmetic** operations (*Note*: Removes top two values from stack, places result of operation on top.)

Operation|Breakdown|Aliases

---------|---------|---------

'add'|add top two items|+

'sub'|subtract top item from second to top item|subtract, -

'mul'|multiply top two items|multiply, *

'div'|divide second to top item by top item|divide, /

'mod'|modulo compute remainder of the division operation of top two items|modulo, %

**Heap** operations (*Note*: Requires address on top of stack, and a value on top of that in case of 'store'. Consumes both, if applicable; places retrieved value on top of stack in case of 'get'.)

Operation|Breakdown|Aliases

---------|---------|---------

'store X'|store value X in heap|@X

'get'|get value from heap|?

**Flow control** operations

Operation|Breakdown|Aliases

---------|---------|---------

'label X'|create label X at this point|:X

'call X'|call subroutine X|X()

'jump X'|jump to label X|go to X, goto X, => X

'jzero X'|jump to label X if top item on stack is zero|0=> X

'jneg X'|jump to label X if top item on stack is negative|-=> X

'ret'|return from subroutine|return

'exit'|exit program

**Input/Output** operations

Operation|Breakdown|Aliases

---------|---------|---------

'printc'|print character|pc

'printn'|print number|pn

'readc'|read character|rc

'readn'|read number|rn

**Meta** operations (*Note*: These are not part of the Whitespace specification; they currently can only be resolved by the Kairos interpreter and will be lost in translation to Whitespace proper.)

Operation|Breakdown|Aliases

---------|---------|---------

'import X'|import WhitespaceAssembler function X into current code; duplicate imports have no effect|require