Alx-Low_Level_Programming

Monty Interpreter

This is a simple interpreter for Monty Bytecode files written in C. It can read a Monty Bytecode file, interpret its instructions and execute them.

0x19. C - Stacks, Queues - LIFO, FIFO

Project Structure

The project is organized as follows:

.
├── monty
├── monty.h
├── execute.c
├── main.c
├── operations:
|  ├── op_push.c
|  ├── op_pall.c
|  ├── op_pint.c
|  ├── op_pop.c
|  ├── op_swap.c
|  ├── op_add.c
|  ├── op_sub.c
|  ├── op_div.c
|  ├── op_mul.c
|  ├── op_mod.c
|  ├── op_pchar.c
|  ├── op_pstr.c
|  └── op_nop.c
├── free_stack.c
└── bytecodes
    ├── 00.m
    ├── 01.m
    ├── ....
    ├── ....
    ├── ....
    └── 12.m

monty: the compiled executable file.

monty.h: the header file containing function prototypes, definitions and struct declarations.

execute.c: the file containing the execute_opcode() function that determines the opcode to be executed.

main.c: the file containing the main() function that reads the bytecode file and executes the opcodes.

operations: these are files containing the functions for each opcode (push(), pint(), pop(), swap(), add(), nop()).

stack.c: the file containing the stack functions (stack_len(), push_stack(), pop_stack(), free_stack()).

bytecodes: a folder containing the bytecode files to be executed by the monty program.

Installation

To install and run the Monty Interpreter, follow these steps:

Clone this repository: git clone https://github.com/FourtyThree43/monty
Change into the monty directory: cd monty
Compile the interpreter: gcc -Wall -Werror -Wextra -pedantic *.c -o monty
Run the interpreter: ./monty <filename>.m
- Replace <filename> with the name of the file containing the Monty code to execute.

Usage

The Monty Interpreter takes a single argument, which is the path to a Monty Bytecode file. The file should contain instructions for the interpreter to execute, one per line.

Supported Opcodes

The following opcodes are supported by the interpreter:

push: pushes an integer onto the stack
pop: removes the top element of the stack
swap: swaps the top two elements of the stack
add: adds the top two elements of the stack.
sub: subtracts the top element of the stack from the second top element.
div: divides the second top element of the stack by the top element.
mul: multiplies the second top element of the stack with the top element.
mod: computes the modulus of the second top element of the stack with the top element of the stack.
pall: prints all the values on the stack
pint: prints the value at the top of the stack
pchar: prints the character at the top of the stack
pstr: prints the string starting at the top of the stack
nop: does nothing.

For more information on how to use the Monty Interpreter see below.

Examples

Example 1

push 1
push 2
push 3
pall
pop
pall
pop
pall
pop
pall

Output

Example 2

push 1
push 2
push 3
add
pall

Output

AUTHOR(s)

This program was written by FourtyThree43.

License

This project is licensed under the MIT License - see the LICENSE file for details.

FourtyThree43/monty