X-Git-Url: http://git.subgeniuskitty.com/vvhitespace/.git/blobdiff_plain/23d1724712fae7dc9645d862d57d030cf3e2e764..c6e2791fac7c7b29257588f99d350371d2e10627:/stdlib/README.md diff --git a/stdlib/README.md b/stdlib/README.md index 3c92dde..2bd317e 100644 --- a/stdlib/README.md +++ b/stdlib/README.md @@ -19,9 +19,9 @@ following reservations: ## Heap and Pointers ## The first 16 heap addresses (`0-15`) are reserved when using the stdlib. -Within that reservation, heap[0] is used by `random` and heap[15] is used -by `spewreg`. The remaining 14 locations, heap[1]-heap[14] are used as -general-purpose registers. +Within that reservation, heap[0] is used by `random` and the block +heap[2]-heap[15] by the stack rotation subroutines which time-share these +pseudo-registers between the various stdlib subroutines. By convention, functions which return a pointer will use the address `0` to represent a `NULL` pointer. @@ -36,6 +36,8 @@ header comment for each function to learn the call and return stack. 1000 ----- printf (stdio.pvvs) 1001 ----- print number from stack (stdio.pvvs) 1010 ----- stackrotate (stack.pvvs) + 1011 ----- stackrotatereverse (stack.pvvs) + 1100 ----- deepdup (stack.pvvs) 010xxx - math functions 10000 ----- random (math.pvvs) 10001 ----- absolute value (math.pvvs) @@ -50,14 +52,23 @@ header comment for each function to learn the call and return stack. 11111 ----- spew (heap.pvvs) 100xxx - string functions 100000 ----- strlen (string.pvvs) - 101xxx - unassigned + 101xxx - logic functions + 101000 ----- not (logic.pvvs) + 101001 ----- and (logic.pvvs) + 101010 ----- or (logic.pvvs) + 101011 ----- xor (logic.pvvs) + 101100 ----- rshift (logic.pvvs) + 101101 ----- lshift (logic.pvvs) 110xxx - conversion functions 111xxx - debug functions 111000 ----- dump heap (debug.pvvs) 111001 ----- dump stack (debug.pvvs) + 111010 ----- print sign (debug.pvvs) + 111011 ----- print magnitude (debug.pvvs) + 111100 ----- print string (debug.pvvs) 1xxxxxx - reserved for less common entry points - 1000000 ----- slurp registers (heap.pvvs) - 1000001 ----- spew registers (heap.pvvs) + 1000000 ----- lowbitand (logic.pvvs) + 1000001 ----- isnegative (math.pvvs) 1000010 ----- print sign of number (stdio.pvvs) 1000011 ----- print magnitude of number (stdio.pvvs) 1000100 ----- print string from stack (stdio.pvvs)