Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fabianishere/brainfuck
Brainfuck interpreter written in C
https://github.com/fabianishere/brainfuck
brainfuck c interpreter optimizing
Last synced: 14 days ago
JSON representation
Brainfuck interpreter written in C
- Host: GitHub
- URL: https://github.com/fabianishere/brainfuck
- Owner: fabianishere
- License: apache-2.0
- Created: 2011-11-02T19:44:53.000Z (about 13 years ago)
- Default Branch: master
- Last Pushed: 2022-02-05T23:23:21.000Z (almost 3 years ago)
- Last Synced: 2024-04-14T05:08:05.049Z (7 months ago)
- Topics: brainfuck, c, interpreter, optimizing
- Language: C
- Homepage:
- Size: 841 KB
- Stars: 511
- Watchers: 16
- Forks: 72
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- AwesomeInterpreter - brainfuck
README
brainfuck
[](https://github.com/fabianishere/brainfuck/actions?query=workflow%3ABuild)
===========
Brainfuck interpreter written in C.
## Usage
brainfuck [-veh] file...
-e --eval run code directly
-v --version show version information
-h --help show a help message.
The interactive console can be accessed by passing no arguments.
We also provide a C api:
``` c
#include
#include
#include
int main() {
BrainfuckState *state = brainfuck_state();
BrainfuckExecutionContext *context = brainfuck_context(BRAINFUCK_TAPE_SIZE);
BrainfuckInstruction *instruction = brainfuck_parse_string(",+++++.");
brainfuck_add(state, instruction);
brainfuck_execute(state->root, context);
brainfuck_destroy_context(context);
brainfuck_destroy_state(state);
return EXIT_SUCCESS;
}
```
## Examples
The [examples/](/examples) directory contains a large amount of
brainfuck example programs. We have tried to attribute the original
authors of these programs where possible.
## Getting the source
Download the source code by running the following code in your command prompt:
```sh
$ git clone https://github.com/fabianishere/brainfuck.git
```
or simply [grab](https://github.com/fabianishere/brainfuck/archive/master.zip) a copy of the source code as a Zip file.
## Building
Create the build directory.
```sh
$ mkdir build
$ cd build
```
Brainfuck requires CMake and a C compiler (e.g. Clang or GCC) in order to run. It also depends on [libedit](http://thrysoee.dk/editline/), which is available in the main repositories of most Linux distributions (e.g. as [libedit-dev](https://packages.debian.org/stretch/libedit-dev) on Debian/Ubuntu) and comes with the macOS XCode command line tools.
Then, simply create the Makefiles:
```sh
$ cmake ..
```
and finally, build it using the building system you chose (e.g. Make):
```sh
$ make
```
After the build has been finished, you may install the binaries to your local system (see [CMAKE\_INSTALL\_PREFIX](https://cmake.org/cmake/help/v3.0/variable/CMAKE_INSTALL_PREFIX.html) for information about the install prefix):
```sh
$ make install
```
Alternatively, you may run the interpreter directly without installation, for instance:
```sh
$ ./brainfuck ../examples/hello.bf
```
## License
The code is released under the Apache License version 2.0. See [LICENSE.txt](/LICENSE.txt).
## Contributors
Fabian Mastenbroek https://github.com/fabianishere
aliclubb https://github.com/aliclubb
diekmann https://github.com/diekmann
SevenBits https://github.com/SevenBits
Alex Burka https://github.com/durka
outis https://github.com/outis
rien333 https://github.com/rien333
boweiliu https://github.com/boweiliu
Rotartsi https://github.com/ROTARTSI82
Saket Upadhyay https://github.com/Saket-Upadhyay
outis https://github.com/outis
Jalmari91 https://github.com/Jalmari91
Alok Singh https://github.com/alok
Lasse Damsgaard Skaalum https://github.com/humleflue