deralex/phprainfuck

Brainfuck interpreter and virtual machine

phprainfuck - Brainfuck interpreter and virtual machine in PHP

What the heck is this?

It's a Brainfuck interpreter and (somewhat) virtual machine which makes it possible to both evaluate brainfuck code as "pure" brainfuck code and to evaluate brainfuck code as PHP code., _(*1)

Installation

Just add it to your composer.json:, _(*2)

"require": {
    ...
    "AlexClooze/phprainfuck": "dev-master"
}

and run composer update., _(*3)

Usage

There are two ways of using phprainfuck., _(*4)

It all starts with creating a new instance of phprainfuck:, _(*5)

use AlexClooze\Phprainfuck\Phprainfuck;

$phprain = new Phprainfuck();

After this you've got two options., _(*6)

Interpreting brainfuck code "as is"

Here's an example on using the evaluate method to just interprete pure brainfuck code:, _(*7)

$code = <<<EOT
+++++ +++[- >++++ ++++< ]>+++ +++++ .<+++ ++[-> +++++ <]>++ ++.++ +++++
..+++ .<+++ +++++ [->-- ----- -<]>- ----- ----- ----. <++++ +++[- >++++
+++<] >++++ ++.<+ +++[- >++++ <]>++ +++++ +.+++ .---- --.-- ----- -.<++
+++++ +[->- ----- --<]> ---.< 
EOT;

print $phprain->evaluate($code);

This will print "Hello World!"., _(*8)

Evaluating brainfuck code as PHP code

Here's an example on creating a new virtual machine and executing brainfuck code as PHP code in it., _(*9)

Hint: All code executed via the virtual machine is executed in a seperate new PHP process., _(*10)

$code = <<<EOT
+++++ +++++ [->++ +++++ +++<] >++++ +++++ +++++ ++++. <++++ [->-- --<]>
----- .<+++ +[->+ +++<] >+.<+ +++[- >---- <]>-- -.+++ ++.<+ +++[- >++++
<]>+. ----- ---.+ ++.<+ +++++ ++[-> ----- ---<] >---- ----. ----- -.<++
++++[ ->+++ +++<] >++.< +++++ [->++ +++<] >++++ .++++ +++.. +++.< +++++
+++[- >---- ----< ]>--- ----- ----- --.<+ +++++ +[->+ +++++ +<]>+ +++++
.<+++ +[->+ +++<] >++++ ++++. +++.- ----- .---- ----. <++++ ++++[ ->---
----- <]>-- -.+.+ +++++ +.<++ ++[-> ++++< ]>++. <
EOT;

$vm = $phprain->createVirtualMachine(255);
$vm->run($code);

The argument given by createVirtualMachine is the actual heap size. The above code will evaluate to var_dump("Hello World!"); and will print string(12) "Hello World!"., _(*11)

Running tests

phprainfuck is developed with the help of phpspec. Run phpspec run to run the tests., _(*12)