tabbykatz/monty

An interpreter for the Monty language built by @derric-d and myself for Holberton School.

Monty

Description

This is a program built to interpret Monty-like scripted files according to operation codes provided to us in the project.

Formatting and Examples

Format for user to write in "testfile.m": opcode argument

NOTE: No more than one instruction per line is allowed, there can however be as many spaces, new lines or tabs before or after the instruction.

Allowable opcodes and what they do

opcode	functionality
push	add element to the 'top' of stack and 'end' of queue
pop	remove element from 'top' of stack and 'end' of queue
pall	print every member of the structure
pint	prints the member value at the top of stack
swap	swaps the order of the 1st and 2nd elements in stack
add	add top two member values
sub	subtract the top element from the 2nd top element
div	divide the 2nd element by the top element
mul	multiply the top two elements of the stack
mod	the remainder when the 2nd element is divided by the top element
comment	there is the ability to parse comments found in bytecode ->'#'
pchar	print character at the top of the stack
pstr	print the character at the top of the stack
rotl	moves element at the top to the bottom of the stack
rotr	the bottom of the stack becomes the top
queue, stack	toggles the doubly link list implementation style
nop	opcode should do nothing

Examples: $ cat opcodetestfile.m

push 1

push 2

push 3

pall

$ ./montyfile opcodetestfile.m

3

2

1

$

---

$ cat opcodetestfile.m

push 1

push 2

push 3

pall

rotl

pall

$ ./montyfile opcodetestfile.m

3

2

1

2

1

3

---

$ cat opcodetestfile.m

push 4

push 5

push 18

push 3

pall

sub

pall

$ ./montyfile opcodetestfile.m

3

18

5

4

15

5

4

---

File List

File Name	Description
README.md	Provides details regarding functionality and creation of our version of a monty program (present file)
main.c	The entry point of our interpreter, recieves data and initializes data struct
init.c	This is where data gets read and processed, data is read from file and added to our data structure accordingly
mathops.c	All the functions to perform math operations on the data structure members
string_ops.c	Contains operations for string manipulation
opfuncs.c, opfuncs2.c	these files contain functionality for basic bytecode operations (pop, push, etc..)
printops.c	operatons to print members from data structure
check_input.c	checks the type of input given to resolve errors

Flow chart

Exit Status

Exits with status EXIT_FAILURE

Compilation

All files were compiled on Ubuntu 14.04 LTS.

All programs and functions were compiled with gcc 4.8.4 using flags -Wall -Werror -Wextra and -pedantic.

Styling

All files have been written in the Betty Style.

Authors

• Derric Donehoo - derric-d
• Tabitha O'Melay - tabbykatz