Skip to content

Latest commit

 

History

History
178 lines (143 loc) · 20.3 KB

README.md

File metadata and controls

178 lines (143 loc) · 20.3 KB

The Golden

Table of contents

  1. Basic info
    1.1 Brainfuck compatibility
  2. How to run your code
    2.1 Arguments
    2.2 Flags
  3. Main features
  4. Important notes
  5. Mechanics
  6. Syntax
  7. Preprocessor
    7.1 Using it
    7.2 Supported statements
  8. Incoming features
  9. Examples

Basic info

The language is currently in development and there is no stable release yet. There may be a lot of breaking changes introduced in updates.
This language is a fairly good superset of a faily popular language called Brainfuck. It takes the beauty of not using any letters in the code from it but also provides some handy features, like printing output as numbers instead of characters and more, while preserving backwards compatibility (unless you explicitly remove it).
Its purpose is to let people make Brainfuck-styled programs less painfully.

Brainfuck compatibility

In the version 0.4.0, the language was made compatible with Brainfuck code, meaning you can paste in Brainfuck code, add The Golden features, and it will work. It has one limit though - the + and - commands will only work if the active cell in the inactive memory is 1. This is true by default and as long as you don't change the value during runtime (which isn't possible in Brainfuck programs, so we consider it enough) or you don't use the --no-brainfuck flag or #no-brainfuck preprocessor statement, which set all memory cells to 0.
An example of such code is below:
Brainfuck:

>++++++++[<+++++++++>-]<.>++++[<+++++++>-]<+.+++++++..+++.>>++++++[<+++++++>-]<++.------------.>++++++[<+++++++++>-]<+.<.+++.------.--------.>>>++++[<++++++++>-]<+.

Brainfuck with The Golden:

>|8|+[<|9|+>-]<.>++++[<|7|+>-]<+.|7|+..+++.>>|6|+[<|7|+>-]<++.|12|-.>|6|+[<|9|+>-]<+.<.+++.|6|-.|8|-.>>>++++[<|8|+>-]<+.

How to run your code

All you need to do it run the interpreter file with the run argument and a path to the maumivu.au file (for example the-golden run .). You will have to download a binary from one of the releases (I recommend using the latest one). Then you will have to set it up in a way you want - you can either run the binary from a specific place, or set it up as a custom command.

Arguments

You can run the code with some arguments including:

  • The maumivu.au file location
  • Code to run if you don't provide the maumivu.au file location
  • Some flags

Flags

See the table below for some flags you can provide when running your code.

Flag Usage Effect
- <code> - '!!![~]: You can provide some code to be ran by the interpreter - no need to have a maumivu.au file
--debug --debug Enabled debug mode - print parsed commands, which command was ran and the memory state at the end of execution
--debug-heavy --debug-heavy Enabled heavy debug mode - print all the things printed in debug mode + stop for 0.5 seconds after each command and print the memory state
--disable-warnings --disable-warnings Disable all warnings
--disable-too-left-pointer-warning --disable-too-left-pointer-warning Disable the warning fired when you go to the -1 index in memory
--hide-console --hide-console Hide the console when running the code
--no-brainfuck --no-brainfuck Set first cells of secondary memories to 0, removing the compatibility with Brainfuck
--sebek --sebek -1|0|1 Specify the results for division by 0. First number is for dividing a number < 0, second for dividing 0 itself, and the third is for dividing a number > 0
--version --version 0.1.0 Run the code using a specific version of the interpreter

Main features

How good or bad the features of this language are is completely subjective, but here are some of them:

  • Brainfuck-like syntax - other will have no idea wth your code does
  • Easy operations chaining - forget code looking like >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>.<<<<<<<<<<<<<<<<<<<<<<<<<<, now you can do |49|>.|26|< to achieve the exact same result
  • Easy arithmetics - tired of multiplication in O(N^2) time? The solution is here! Just do * and you are done in ~O(1)
  • Decimal numbers - pretty self-explanatory, but now you can use decimal numbers in your code
  • And much more!

Important notes

This language uses multiple memory rows - you have access to 2 global memory rows and 2 local memory rows. Both with global and local memory, you are always using just one row at a time. I will be referring to those rows as active (the one you are using) and inactive (the one you are not using).
Unless said otherwise, cell is referring to the selected cell (and also if not said otherwise in the active global memory row).

Mechanics

The main file has to be named maumivu.au. This isn't required with command-line-provided code (obviously). When converting numbers to characters and vice versa, the ASCII table is used.
The memory has unlimited size and consists of double-precision numbers. When you go to an unexisting index (to the right) that cell is created with the value of 0.
If you go into memory index -1, a 0 is added at that position and the whole memory is shifted one cell to the right. While this is allowed, I would discourage you from doing it since it can be fairly slow (compared to other operations). That's why it will fire a warning.
Loops function the exact same way as in Brainfuck - they only run if the current cell value isn't 0. This language also offers do-while loops, which ignore the check the first time.
You can chain commands by putting || in front of them. You can also put a number between those pipes. If you decide to put a number in there, the command right after it will run floor(the number) times. If you leave it empty, the code will run floor(cell value) times. If the value is negative, the opposite command will be ran (see the table below). If the value is 0, it won't be ran at all.

Command Opposite command
! ~
~ !
+ -
- +
_ /
/ _
> <
< >

Syntax

The magic of Brainfuck-like syntax is that it is easy and extremely difficult at the same time. Here are all the commands the interpreter will understand:

Command Explanation Showcase Chainable? Usable on local memory?
! Adds one to the current cell ! Yes Yes
~ Subtracts one from the current cell ~ Yes Yes
+ Adds the cell in the inactive row to the cell in the active row (also adds one to the current cell in brainfuck compatible mode, because the inactive cell is 1) + Yes Yes
- Subtracts the cell in the inactive row from the cell in the active row (also subtracts one from the current cell in brainfuck compatible mode, because the inactive cell is 1) - Yes Yes
* Multiplies the cell in the active row by the cell in the inactive row * Yes Yes
/ Divides the cell in the active row by the cell in the inactive row / Yes Yes
_ Floors the current cell value (towards -infinity) _ No Yes
& Ceils the current cell value (towards +infinity) & No Yes
` Sets the cell to a random number from 0 (inclusive) to 1 (exclusive) ` No Yes
> Move the cell pointer one to the right > Yes Yes
< Move the cell pointer one to the left < Yes Yes
^ Switch active memory (sets the active as inactive and the inactive as active) ^ No Yes
$, Sets the cell to the value of user input as a number (if they input 69, the cell value will be 69) $, No Yes
, Sets the cell to the value of user input as a character (if they input E, the cell value will be 69) , No Yes
$. Output the cell as a number (if the cell value is 69, 69 will be printed) $. Yes Yes
. Output the cell as a character (if the cell value is 69, E will be printed) . Yes Yes
[ Start a while loop [ No Yes
] End a while loop ] No Yes
[@ Start a do-while loop [@ No Yes
@] End a do-while loop @] No Yes
?? Sets the cell value to its index ?? No Yes
?= If the cells in the active and inactive rows have the same value, break the loop [?=] Yes Yes
?< If the cell in the active row has a lower value than the cell in the inactive row, break the loop [?<] Yes Yes
?> If the cell in the active row has a higher value than the cell in the inactive row, break the loop [?>] Yes Yes
; Switches the values of the active global cell and the active local cell ; No Yes
' Toggle if you are working with local or global memory ' No Yes
"" Comments "This is a comment" No No

Preprocessor

The preprocessor allows you to include flags into the code itself, so you don't have to rely on the user to run the code with the correct flags.
The values parsed by the preprocessor are overridden by the flags passed in from the command line.

Using it

The statements are put into the code file and begin with a #. They can either end by a new line, a # and a new line, or just a #:

#version 0.4.0
#sebek -1|0|1#
#no-brainfuck#'!!!'$.'$.^|5|!$. "a"

Supported statements

Statement names are case-insensitive, so version is the same as VERSION and VerSIoN. However, this may not be true for other parts of the statement.

Statement Aliases Arguments Explanation Example
version None None Specifies the version of the interpreter to launch #version 0.3.0
no-console noconsole, no_console None Hides the console when running the code #no-console
no-brainfuck brainfuck, no_brainfuck None Sets first cells of secondary memories to 0, removing the compatibility with Brainfuck, but preserving old memory values #no-brainfuck
disable-warnings disablewarnings, disable_warnings The warning to disable: too-left-pointer (tooleftpointer) Disables the specified warning #disable-warnings too-left-pointer
sebek None The results of division by zero for negative numbers (<n>), zero itself (<z>), and positive numbers (<p>), separated by |: <n>|<z>|<p> Sets the result of division by zero to the specified number depending on the value of the number being divided sebek -1|0|1 (if a negative number was divided by 0 the result would be -1, if 0 was divided by 0 the result would be 0, and if a positive number was divided by 0 the result would be 1)

Incoming features

  • Functions
  • Running other files
  • A compiled interpreter ✔️

Examples

Here are some examples written in this language:
"Hello, world!":

|72|!.|29|!.|7|!..|3|!.|67|~.|12|~.|87|!.|8|~.|3|!.|6|~.|8|~.|67|~.

Fibonacci sequence:

^~^!>|10|!<^>|10|!<[@^+$.>.<@]

You can find all the examples in the examples folder.