Skip to content

A simple terminal tool to run a befunge93 program (with extended grid size) and output its output

License

Notifications You must be signed in to change notification settings

Mikescher/BefunRun

Repository files navigation

BefunRun Build status

A simple command line program to execute befunge-93 code. The first parameter is expected to be a file with valid befunge-93 code. All output is redirected to stdout. (Errors end up in stderr)

Like all programs in my BefunUtils collection this supports befunge-93 code with extended grid size (bigger than 80x25, see BefunExec)

Download

You can download the binaries from my website www.mikescher.com

Or you can get the latest Github release (In case AppVeyor is down)

Or you can download the latest (nightly) version from the AppVeyor build server

Set Up

This program was developed under Windows with Visual Studio.

You don't need other BefunUtils projects to use this.
Theoretically you can only clone this repository and start using it.
But it could be useful to get the whole BefunUtils solution like described here

Usage

Simply call the exe with BefunRun code.b93 to execute a program and output its result.

There are a few optional commandline options:

  • -limit=X: Abort execution after X steps
  • -info: Show information about the program execution (max number, max stack size, etc)
  • -errorlevel=0: default error level, execute program befunge-compliant and never abort.
  • -errorlevel=1: Abort execution when
    • reading from an empty stack
    • reading/writing to invalid coordinates
    • dividing (or modulo-ing) by zero
  • -errorlevel=2: Abort execution on these conditions: (and on all conditions of lower error levels)
    • Moving the PC over the program edge
  • -errorlevel=2: Abort execution on these conditions: (and on all conditions of lower error levels)
    • executing (= entering with the PC) a previously modified cell

Limitations

BefunRun is not intended for non-terminating programs or programs with user input. You can use BefunExec to run these kind of programs.

Contributions

Yes, please

About

A simple terminal tool to run a befunge93 program (with extended grid size) and output its output

Resources

License

Stars

Watchers

Forks

Packages

No packages published