/straw

archive of the deleted https://github.com/tuxcrafting/straw

Primary LanguageRuby

Straw

String manipulation esolang

Usage

straw.rb <file> [-u]

The -u flag is to directly read the file in UTF-8, without CP437 decoding it.

Reference

Straw have 3 stacks:

  • Two main stacks (the first is initialized with an empty string and the second with Hello, World!)
  • One temporary stack

Straw use a modified CP437 encoding (FF is …).

Commands

Command Description
( String literal, ends on ). Parenthesis are nestable, and ` is the escape character.
+ Pop b, pop a and push a and b concatened.
* Pop b, pop a and push length of b times a.
& Pop a string and evaluate it.
: Duplicate the top of the stack.
; Drop the top of the stack.
, Swap the two items on the top of the stack.
~ Toggle the current stack.
- Pop an item from the inactive stack and push it on the active one.
> Pop a string and print it. This don't print a trailing nweline.
< Read a string from STDIN and push it.
? Have a 1/2 chance of skipping the next instruction.
' Pop condition, if and else and execute if if the length of condition is >0, else otheriwse.
= Pop two items, push Y if the two items are equal, an empty string otherwise.
! Pop two items, push Y if the two items are not equal, an empty string otherwise.
{ Pop an item and push its first character.
} Pop an item and push it without the first character.
" Pop a string and reverse it.
/ Pop replacement, regex and string and push string with all matching occurences of regex replaced by replacement.
. Pop a regex and a string and push Y if the regex match the string, an empty string otherwise.
] Pop var and a value, set the variable var to the value.
[ Pop var and a push the variable var.
# Pop a decimal string, convert it to unary and push it.
$ Pop a string and push it length in decimal.
% Pop a string, enclose it in parentheses and push it.
@ See the source code for a description.
⌠ Pop a and b, drop length of a characters on b and push b.
⌡ Pop a and b, take length of a characters on b and push b.
` `
¡ Get the depth of the stack.
≤ Pop a string of length n and push the n-th element of the stack (0 = most deep element).
≥ Pop a string of length n and push the n-th element of the stack (0 = least deep element).
÷ Pop a and b and push b / a (unary arithmetic).
¥ Pop a and b and push b mod a (unary arithmetic).
æ Pop a character and push its CP437 ordinal.
Æ Pop a number and push the CP437 character associated.
ñ Pop an item and push it on the temporary stack.
Ñ Pop an item on the temporary stack and push it on the main stack.
≈ Swap the current stack and the temporary one.
σ Clear the temporary stack.
¢ Pop a list of list and a string, and for each element in the list, replace the first element (regex) by the second in the string.
« Pop a string, sum the CP437 codepoints of each character in the string and push an unary number.
» Pop a string and push it length encoded in CP437 codepoints.
Ω Pop a and b and push b joined with a.
£ Pop a string and evaluate it while peeking the top of the stack is not an empty string.
_ Print the stack.

There is also a special command, Ђ, which should'nt be used directly in the code. (Anyway, it can't be in a source file without the Unicode mode.)

Any character that isn't a command is pushed on the current stack.

Examples

  • hello_world.str: A hello world
  • truth_machine.str: A truth machine
  • quine.str: A quine