brainfuck 0.2.0

Brainfuck interpreter and modules.
Documentation
Here are some little programs for testing brainfuck implementations.


>,>+++++++++,>+++++++++++[<++++++<++++++<+>>>-]<<.>.<<-.>.>.<<.
This is for testing i/o; give it a return followed by an EOF. (Try it both
with file input--a file consisting only of one blank line--and with
keyboard input, i.e. hit return and then ctrl-d (Unix) or ctrl-z
(Windows).)
It should give two lines of output; the two lines should be identical, and
should be lined up one over the other. If that doesn't happen, ten is not
coming through as newline on output.
The content of the lines tells how input is being processed; each line
should be two uppercase letters.
Anything with O in it means newline is not coming through as ten on input.
LK means newline input is working fine, and EOF leaves the cell unchanged
(which I recommend).
LB means newline input is working fine, and EOF translates as 0.
LA means newline input is working fine, and EOF translates as -1.
Anything else is fairly unexpected.


++++[>++++++<-]>[>+++++>+++++++<<-]>>++++<[[>[[>>+<<-]<]>>>-]>-[>+>+<<-]>]
+++++[>+++++++<<++>-]>.<<.
Goes to cell 30000 and reports from there with a #. (Verifies that the
array is big enough.)


These next two test the array bounds checking. Bounds checking is not
essential, and in a high-level implementation it is likely to introduce
extra overhead. In a low-level implementation you can get bounds checking
for free by using the OS's own memory protections; this is the best
solution, which may require making the array size a multiple of the page
size.
Anyway. These two programs measure the "real" size of the array, in some
sense, in cells left and right of the initial cell respectively. They
output the result in unary; the easiest thing is to direct them to a file
and measure its size, or (on Unix) pipe the output to wc. If bounds
checking is present and working, the left should measure 0 and the right
should be the array size minus one.
+[<+++++++++++++++++++++++++++++++++.]

+[>+++++++++++++++++++++++++++++++++.]


[]++++++++++[>>+>+>++++++[<<+<+++>>>-]<<<<-]
"A*$";?@![#>>+<<]>[>>]<<<<[>++<[-]]>.>.
Tests for several obscure problems. Should output an H.


+++++[>+++++++>++<<-]>.>.[
Should ideally give error message "unmatched [" or the like, and not give
any output. Not essential.

+++++[>+++++++>++<<-]>.>.][
Should ideally give error message "unmatched ]" or the like, and not give
any output. Not essential.


My pathological program rot13.b is good for testing the response to deep
brackets; the input "~mlk zyx" should produce the output "~zyx mlk".


For an overall stress test, and also to check whether the output is
monospaced as it ideally should be, I would run numwarp.b.


Daniel B Cristofani (cristofdathevanetdotcom)
http://www.hevanet.com/cristofd/brainfuck/