fabianishere · dimangopie · Jul 9, 2025 · Jul 9, 2025 · Jul 9, 2025 · Jul 9, 2025
diff --git a/.gitignore b/.gitignore
@@ -1,3 +1,4 @@
+.idea
 # .gitignore for brainfuck.
 
 # ignore the .cproject and .project file generated by Eclipse.

diff --git a/CMakeLists.txt b/CMakeLists.txt
@@ -9,12 +9,12 @@ set(CMAKE_MODULE_PATH "${PROJECT_SOURCE_DIR}/cmake" ${CMAKE_MODULE_PATH})
 
 ## Compile-time options ##
 option(ENABLE_CLI "Enable the command line interface" ON)
-option(ENABLE_EDITLINE "Enable GNU readline functionality provided by the editline library" ON)
 option(ENABLE_EXTENSION_DEBUG "Enable the debug extension for brainfuck")
 option(INSTALL_EXAMPLES "Install the examples")
 
 ## Target ##
-set(BRAINFUCK_H include/brainfuck.h)
+set(BRAINFUCK_H include/brainfuck.h
+        src/brainfuck.c)
 set(BRAINFUCK_C_FLAGS
         $<$<OR:$<C_COMPILER_ID:Clang>,$<C_COMPILER_ID:AppleClang>,$<C_COMPILER_ID:GNU>>:
             -Wall -Wextra>
@@ -49,9 +49,7 @@ if(ENABLE_CLI)
     target_compile_options(brainfuck-cli PRIVATE "${BRAINFUCK_C_FLAGS}")
 
     if(ENABLE_EDITLINE)
-        find_package(editline REQUIRED)
         target_compile_definitions(brainfuck-cli PRIVATE BRAINFUCK_EDITLINE_LIB)
-        target_link_libraries(brainfuck-cli PRIVATE editline)
     endif()
 endif()
 

diff --git a/LICENSE.txt b/LICENSE.txt
diff --git a/README.md b/README.md
@@ -1,8 +1,31 @@
 brainfuck
 [![Build Status](https://github.com/fabianishere/brainfuck/workflows/Build/badge.svg)](https://github.com/fabianishere/brainfuck/actions?query=workflow%3ABuild)
-===========
 Brainfuck interpreter written in C.
-
+## Update
+1. Added a double slash '//' comment function.
+2. Added a shebang '#!' line function.
+3. Added a function that allows letters to replace symbols 
+   - default replacing mothed
+   - 
+   | origin | optional  |
+   |--------|-----------|
+   | '+'    | 'o' , 'O' |
+   | '-'    | 'i' , 'I' |
+   | '<'    | 'a' , 'A' |
+   | '>'    | 'e' , 'E' |
+   | '.'    | '.' , '.' |
+   | ','    | ',' , ',' |
+   | '['    | 'u' , 'U' |
+   | ']'    | 'y' , 'Y' |
+   | '#'    | '?' , '!' |
+
+   - you can change them in `src/brainfuck.c:other_char_table`.\
+   - I love these vowels, reading them is like listening to a baby trying to speak but only babbling.
+4. Added two tools transLetter.py and transLetters.sh to help users automatically convert letters to others.
+5. Add a tools folder to store transLetter.py and transLetters.sh.\ 
+You can compare the instruction parameters in transLetters.sh to customize the conversion file.
+6. Removed the `editline` library dependency,\
+because it was interfering with the NVIDIA 4060 GPU driver on my Ubuntu PC.
 ## Usage
     brainfuck [-veh] file...
 	-e --eval	run code directly
@@ -43,29 +66,42 @@ $ 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. 
+1. Create the build directory.
+   ```sh
+   $ mkdir build
+   $ cd build
+   ```
+2. 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
-```
+   ```sh
+   $ cmake ..
+   ```
+3. 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
-```
+4. 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
+   ```
+5. Alternatively, you may run the interpreter directly without installation, for instance:
+   ```sh
+   $ ./brainfuck ../examples/hello.bf
+   ```
+6. Because some new features are added, you can add `#!brainfuck` and change you symbols 
+like the `hello.bf`:
+   ```brainfuck
+   #!/usr/bin/env brainfuck
+   // hello <O-O>
+   ooooooooueooooueooeoooeoooeoaaaaiyeoeoeieeouayaiyee.eiii.ooooooo..ooo.ee.ai.a.oo
+   o.iiiiii.iiiiiiii.eeo.eoo.
+   ```
+   Then run the file directly in the terminal\
+   ```sh
+   sudo chmod 755 hello.bf 
+   hello.bf
+   ```
 
 ## License
 The code is released under the Apache License version 2.0. See [LICENSE.txt](/LICENSE.txt).

diff --git a/cmake/Findeditline.cmake b/cmake/Findeditline.cmake
diff --git a/examples/196-commented.bf b/examples/196-commented.bf
@@ -1,3 +1,4 @@
+#!/home/mango/CLionProjects/brainfuck/build/brainfuck
 [
  The 196-algorithm implemented in brainfuck by Mats Linander.
 

diff --git a/examples/196.bf b/examples/196.bf
diff --git a/examples/2d_table.bf b/examples/2d_table.bf
@@ -1,4 +1,4 @@
-
+#!/home/mango/CLionProjects/brainfuck/build/brainfuck
 2D Table reading routine for BrainFuck
         Made By: NYYRIKKI 2001
 

diff --git a/examples/666.bf b/examples/666.bf
@@ -1,3 +1,4 @@
+
 >+++++++++[<++++++>-]<...
 >++++++++++.
 
diff --git a/examples/asciiart/asciiart.bf b/examples/asciiart/asciiart.bf
@@ -1,3 +1,4 @@
+#!/usr/local/bin/brainfuck
 >>+++[<+++++[<+++++++>-]>-]<<.>>>+++++[<+++++++++++[<++>-]>-]<<.>++++>
 >++++[<++++[<+++++++>-]>-]<<.>++>+++++[<++++++>-]<.>+>>++++[<+++++++++
 [<+++>-]>-]<<.>+>>++++[<++++[<++++++>-]>-]<<.<<<<<.>.>>>>>+>++++++++++

diff --git a/examples/asciiart/chess.bf b/examples/asciiart/chess.bf
@@ -1,5 +1,4 @@
-
-
+#!brainfuck
 +++++++++++++++[>++>+++>+++>++++++>++>+++++++>++++>+<<<<<<<<-]>>--.>....
 ...<.>.......<.>.......<.>.......<.>.......<.>.......<.>.......<.>......
 .<.>>>>>>-----.<<+++++++++++++++++++.<++.<+.++++.>>.<<.--.>.>.>--..<<<++

diff --git a/examples/asciiart/text.bf b/examples/asciiart/text.bf
diff --git a/examples/asciiart/triangle.bf b/examples/asciiart/triangle.bf
@@ -1,3 +1,4 @@
+#!/home/mango/CLionProjects/brainfuck/build/brainfuck
 [ This program prints Sierpinski triangle on 80-column display. ]
                                 >    
                                + +    
@@ -14,7 +15,7 @@
                     >       >       +       <    
                    < <     < <     < <     < <    
                   <   [   -   [   -   >   +   <    
-                 ] > [ - < + > > > . < < ] > > >    
+                 ] > [ - < + > > > . < < ] > > >    // dt crraa
                 [                               [    
                - >                             + +    
               +   +                           +   +    
@@ -30,4 +31,4 @@
     [       -       <       -       >       ]       <       <    
    < ]     < <     < <     ] +     + +     + +     + +     + +    
   +   .   +   +   +   .   [   -   ]   <   ]   +   +   +   +   +    
- * * * * * M a d e * B y : * N Y Y R I K K I * 2 0 0 2 * * * * *    
+ * * * * * * * * * * * * * * * * * * * * * * * 2 0 0 2 * * * * *
diff --git a/examples/asciiart/xmastree.bf b/examples/asciiart/xmastree.bf
@@ -1,3 +1,4 @@
+#!/home/mango/CLionProjects/brainfuck/build/brainfuck
 [xmastree.b -- print Christmas tree
 (c) 2016 Daniel B. Cristofani
 http://brainfuck.org/]

diff --git a/examples/atoi.bf b/examples/atoi.bf
diff --git a/examples/bench/bench-1.bf b/examples/bench/bench-1.bf
@@ -1,2 +1,3 @@
+#!/usr/local/bin/brainfuck
 ++++++++[->-[->-[->-[-]<]<]<]
 >++++++++[<++++++++++>-]<[>+>+<<-]>-.>-----.>
diff --git a/examples/bench/bench-2.bf b/examples/bench/bench-2.bf
diff --git a/examples/bench/easy-opt.bf b/examples/bench/easy-opt.bf
diff --git a/examples/bench/endtest.bf b/examples/bench/endtest.bf
diff --git a/examples/bench/long.bf b/examples/bench/long.bf
diff --git a/examples/bench/prttab.bf b/examples/bench/prttab.bf
diff --git a/examples/bench/skiploop.bf b/examples/bench/skiploop.bf
@@ -1,3 +1,4 @@
+#!/home/mango/CLionProjects/brainfuck/build/brainfuck
 [ This program tests how well the interpreter reacts to large
   runs of '>' and '<'.
   This is the source RLE-encoded.

diff --git a/examples/bench/tests.bf b/examples/bench/tests.bf
diff --git a/examples/bottles-1.bf b/examples/bottles-1.bf
diff --git a/examples/bottles-2.bf b/examples/bottles-2.bf
diff --git a/examples/bottles-3.bf b/examples/bottles-3.bf
diff --git a/examples/busy-beaver-overflow.bf b/examples/busy-beaver-overflow.bf
diff --git a/examples/busy-beaver.bf b/examples/busy-beaver.bf
diff --git a/examples/cat-1.bf b/examples/cat-1.bf
diff --git a/examples/cat-2.bf b/examples/cat-2.bf
diff --git a/examples/cat-3.bf b/examples/cat-3.bf
diff --git a/examples/cell-size-1.bf b/examples/cell-size-1.bf
@@ -1,4 +1,4 @@
-
+#!/home/mango/CLionProjects/brainfuck/build/brainfuck
 
 // Calculate (16*16*16*16)^128 AKA 2^2048
 ++[>++++++++<-]>[>++++++++<-]>[<<

diff --git a/examples/cell-size-2.bf b/examples/cell-size-2.bf
diff --git a/examples/cell-size-3.bf b/examples/cell-size-3.bf
diff --git a/examples/cell-size-4.bf b/examples/cell-size-4.bf
diff --git a/examples/cell-size-5.bf b/examples/cell-size-5.bf
diff --git a/examples/char.bf b/examples/char.bf
diff --git a/examples/counter.bf b/examples/counter.bf
diff --git a/examples/css.bf b/examples/css.bf
diff --git a/examples/decss.bf b/examples/decss.bf
diff --git a/examples/dvorak.bf b/examples/dvorak.bf
diff --git a/examples/echo.bf b/examples/echo.bf
diff --git a/examples/gameoflife.bf b/examples/gameoflife.bf
diff --git a/examples/hanoi-opt.bf b/examples/hanoi-opt.bf
diff --git a/examples/hanoi.bf b/examples/hanoi.bf
diff --git a/examples/head.bf b/examples/head.bf
diff --git a/examples/hello-short.bf b/examples/hello-short.bf
diff --git a/examples/hello.bf b/examples/hello.bf
@@ -1,2 +1,3 @@
+#!/usr/bin/env brainfuck
 ++++++++[>++++[>++>+++>+++>+<<<<-]>+>+>->>+[<]<-]>>.>---.+++++++..+++.>>.<-.<.++
 +.------.--------.>>+.>++.
diff --git a/examples/htmlconv.bf b/examples/htmlconv.bf
diff --git a/examples/jabh.bf b/examples/jabh.bf
diff --git a/examples/ks.bf b/examples/ks.bf
diff --git a/examples/lost-kingdom.bf b/examples/lost-kingdom.bf
diff --git a/examples/mac2unix.bf b/examples/mac2unix.bf
diff --git a/examples/numwarp.bf b/examples/numwarp.bf
diff --git a/examples/oobrain.bf b/examples/oobrain.bf
diff --git a/examples/order.bf b/examples/order.bf
diff --git a/examples/packbits.bf b/examples/packbits.bf
diff --git a/examples/password-vault.bf b/examples/password-vault.bf
diff --git a/examples/reverse.bf b/examples/reverse.bf
diff --git a/examples/rot13.bf b/examples/rot13.bf
diff --git a/examples/rpn.bf b/examples/rpn.bf
diff --git a/examples/short.bf b/examples/short.bf
diff --git a/examples/si.bf b/examples/si.bf
diff --git a/examples/sisihi.bf b/examples/sisihi.bf
diff --git a/examples/utm.bf b/examples/utm.bf
diff --git a/examples/wc.bf b/examples/wc.bf
diff --git a/include/brainfuck.h b/include/brainfuck.h
@@ -26,8 +26,14 @@
 #define BRAINFUCK_TOKEN_NEXT '>'
 #define BRAINFUCK_TOKEN_OUTPUT '.'
 #define BRAINFUCK_TOKEN_INPUT ','
+
 #define BRAINFUCK_TOKEN_LOOP_START '['
 #define BRAINFUCK_TOKEN_LOOP_END ']'
+
+// extern const char char_table[][3];
+// extern const int char_table_size;
+
+#define BRAINFUCK_EXTENSION_DEBUG
 #ifdef BRAINFUCK_EXTENSION_DEBUG
 #	define BRAINFUCK_TOKEN_BREAK '#'
 #else

diff --git a/man/brainfuck.1 b/man/brainfuck.1
@@ -28,23 +28,23 @@ A brainfuck interpreter written in C.
 The brainfuck syntax is described below:
 .Pp
 .Bl -tag -width -indent
-.It Sy >
-Increment the data pointer (to point to the next cell to the right).
-.It Sy <
+.It Sy < , a , A
 Decrement the data pointer (to point to the next cell to the left).
-.It Sy +
-Increment (increase by one) the byte at the data pointer.
-.It Sy -
+.It Sy > , e , E
+Increment the data pointer (to point to the next cell to the right).
+.It Sy - , i , I
 Decrement (decrease by one) the byte at the data pointer.
-.It Sy \&.
-Output the byte at the data pointer as an ASCII encoded character.
+.It Sy + , o , O
+Increment (increase by one) the byte at the data pointer.
 .It Sy \&,
 Accept one byte of input, storing its value in the byte at the data pointer.
-.It Sy \&[
+.It Sy \&.
+Output the byte at the data pointer as an ASCII encoded character.
+.It Sy \&[ , y , Y
 If the byte at the data pointer is zero, then instead of moving the instruction pointer forward to the next command, jump it forward to the command after the matching 
 .Sy \&]
 token.
-.It Sy \&]
+.It Sy \&] , u , U
 If the byte at the data pointer is nonzero, then instead of moving the instruction pointer forward to the next command, jump it back to the command after the matching 
 .Sy \&[
 token.