baffle

Section: User Commands (1)
Index Return to Main Contents
 

NAME

baffle - An extension of brainfuck language  

SYNOPSIS

baffle [-f, --file <file> ] [-i, --input <file> ] [-o, --output <file> ] [-t, --type <type> ] [-d, --debug ] [-h, --help ] [-v, --version ]
 

DESCRIPTION

baffle Is an extension to BF language (https://esolangs.org/wiki/brainfuck), which itself in turn is a extension of Turing machine. baffle extends Bf by adding a stack, support for procedures, adding more arithmetic instructions, and a register. baffle can run original BF programs, and while it's not the fastest implementation of BF, but it's written in such a way that makes it easier to replace the instruction set, and to write similar languages.
Every cell is a single byte, and the tape wraps.


Code size is set to be maximum of 8192 bytes.
Tape size is set to be 16384 bytes.
Stack size is 2048, and procedure stack size is 1024 bytes.

 

INSTRUCTIONS

baffle adds a register (R) with a default value of 1, which makes it run plain BF instructions as long as the register is set to 1. Carry flag is actualy a byte, which can be used to impelement multi-byte multiplication.

Here are the instructions:


BF insturctions:

+ : current_cell = current_cell + R
- : current_cell = current_cell - R
> : current_cell_ptr = current_cell_ptr + 1
< : current_cell_ptr = current_cell_ptr - 1
[ : if current_cell == 0 go down to ]
] : if current_cell != 0 go up to [

, : read current_cell


= : R = current_cell


T : Back up the current_cell_ptr
G : Restore the current_cell_ptr
Z : current_cell_ptr = 0 (Rewind)


* : current_cell *= R
/ : current_cell /= R
% : current_cell %= R
^ : current_cell ^= R
& : current_cell &= R
| : current_cell |= R
~ : One's complement of current_cell
L : current_cell <<= 1
R : current_cell >>= 1


! : R = Carry flag
$ : R = Sign flag
\ : clear flags


X : Swap current_cell and R


? : Skip over the next instruction if current_cell is zero
K : label
) : Jump to the label in lower address
( : go to the label in the higher address


: : push current_cell
; : pop current_cell


#      : comment (ignore the rest of the line)

" : Put following characters into the tape


V : Print current_cell as a signed number
U : Print current_cell as an unsigned number
H : Print current_cell as HEX
I : Read a byte (a number betwen 0 to 255) and put it in current_cell


P : Print null terminating string starting from current_cell_ptr
S : Read string and insert it cells starting at current_cell_ptr


0-9,A-F : Store HEX number into current_cell


{ : Beginning of a procedure
} : Return from the procedure
@ : Call the Nth procedure where N is current_cell


Q : Quit

axbf is a subset of baffle instructions were symbols only contain alpha numeric characters.


A : +
S : -
R : >
L : <
W : [
B : ]
P : .
I : ,


E : =


T : T
G : G
Z : Z


M : *
D : /
Y : %


K : @
F : {
J : }


C : !
N : $


X : X


V : :
U : ;


H : H
Q : Q


0-9 : Store decimal number (0-255) in current_cell

 

OPTIONS

-f, --file <file>
File containing the code, if missing STDIN is used
-i, --input <file>
Input file, if missing STDIN is used
-o, --output <file>
Output file, if missing STDOUT is used
-t, --type <type>
Code type is either 'baffle', or 'axbf' default is 'baffle'
-d, --debug
Debug mode
-h, --help
Displays this
-v, --version
Displays the version number

baffle without any parameters reads and executes the code from STDIN.

 

DEBUGGING

Passing -d puts baffle in interactive debugging mode. While in this mode, these commands can be used:

s              : Step through

n              : same as 's' for now

b<number>      : Sets the breakpoint (only one for now)

c              : clears the breakpoint

g              : Go (runs until reaches breakpoing or program ends)

a<secs>        : Autostep, step through every <secs> (can be a fraction)

q              : quit

 

SEE ALSO

https://esolangs.org/wiki/Brainfuck https://en.wikipedia.org/wiki/Brainfuck https://esolangs.org/wiki/Cbrain

 

AVAILABILITY

baffle is tested on many different variations of Linux, Cygwin, and FreeBSD.

Please feel free to send us your patches to get tgc working on other platforms.  

COPYRIGHT AND LEGAL ISSUES

Copyright (c) 2018, Faraz.V (faraz@fzv.ca)

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
    * Redistributions of source code must retain the above copyright
      notice, this list of conditions and the following disclaimer.
    * Redistributions in binary form must reproduce the above copyright
      notice, this list of conditions and the following disclaimer in 
      the documentation and/or other materials provided with the
      distribution.
    * Neither the name of the author nor the names of its contributors 
      may be used to endorse or promote products derived from THIS 
      SOFTWARE without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

 

AUTHOR

baffle is written by Faraz.V (faraz@fzv.ca)


 

Index

NAME
SYNOPSIS
DESCRIPTION
INSTRUCTIONS
OPTIONS
DEBUGGING
SEE ALSO
AVAILABILITY
COPYRIGHT AND LEGAL ISSUES
AUTHOR

This document was created by man2html, using the manual pages.
Time: 02:57:45 GMT, February 09, 2019