Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ahmadyousif89/monty
The Monty Program | An interpreter for Monty ByteCodes files
https://github.com/ahmadyousif89/monty
Last synced: about 6 hours ago
JSON representation
The Monty Program | An interpreter for Monty ByteCodes files
- Host: GitHub
- URL: https://github.com/ahmadyousif89/monty
- Owner: AhmadYousif89
- Created: 2024-01-18T16:38:59.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-01-25T22:53:17.000Z (10 months ago)
- Last Synced: 2024-01-25T23:53:26.119Z (10 months ago)
- Language: C
- Size: 43 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Interpreter for Monty ByteCodes files.
A simple interpreter for Monty ByteCode files written in C. It reads a bytecode file line by line and executes the bytecode commands on a Stack or Queue.
## The Monty language
Monty 0.98 is a scripting language that is first compiled into Monty byte codes (Just like Python). It relies on a unique stack, with specific instructions to manipulate it. The goal of this project is to create an interpreter for Monty ByteCodes files.
Files containing Monty byte codes usually have the .m extension. Most of the industry uses this standard but it is not required by the specification of the language.
There can not be more than one instruction per line. There can be any number of spaces before or after the opcode and its argument.
## Getting Started
You can start by cloning this repo into your machine by following these commands:
```bash
git clone https://github.com/AhmadYousif89/monty
cd monty
```
All files were compiled on Ubuntu 20.04 LTS using the __GCC__ compiler with the following options:
```bash
gcc -Wall -Werror -Wextra -pedantic -std=c89 *.c -o monty
```
so make sure you have the gcc compiler installed.
To run the program simply type:
```bash
./monty
```
### Available operation codes:
|__Opcode__|__Description__|
|:---------|:-------------:|
|stack |An opcode that sets the insertion mode to a Stack (LIFO). This is the default behavior.|
|queue |An opcode that sets the insertion mode to a Queue (FIFO).|
|push |Pushes an element onto the stack. e.g (push 1 onto the stack)|
|pop |Removes an element from the stack or queue.|
|nop |This opcode doesn't do anything.|
|swap |Swaps the top to elements of the stack.|
|add |Adds the top two elements of the stack. The result is then stored in the second node, and the first node is removed.|
|sub |Subtracts the top two elements of the stack from the second top element. The result is then stored in the second node, and the first node is removed.|
|div |Divides the top two elements of the stack from the second top element. The result is then stored in the second node, and the first node is removed.|
|mul |Multiplies the top two elements of the stack from the second top element. The result is then stored in the second node, and the first node is removed.|
|mod |Computes the remainder of the top two elements of the stack from the second top element. The result is then stored in the second node, and the first node is removed.|
|pall |Prints all the values on the stack, starting from the head of the stack.|
|pint |Prints the value at the top of the stack.|
|pchar |Prints a character representation for the number stored in the top node of the stack. e.g (H)|
|pstr |Prints a string representation of all the numbers stored in the stack from the top. e.g (olleH)|
|prevs |Prints a string representation of all the numbers stored in the stack in reverse order. e.g (Hello)|
|rotl |Rotates the stack from top to bottom.|
|rotr |Rotates the bottom of the stack to the top of the stack.|
|# |Lines that starts with the (#) symbol will be trated as a comment.|
|// |Lines that starts with the (//) symbol will be trated as a comment.|
### Examples
To test the monty interpreter create a text file that contain the bytecode operations then save the file with the extension __(.m)__.
Here is an example of a __test.m__ file that contains the following opcodes:
and the output on the terminal will look like this:
more opcode tests:
and the results are
#### Aurthor
[Ahmad Yousif](https://github.com/AhmadYousif89)