README.md

PINS22

This is a compiler for PINS22 programming language as defined in this specification.

Usage

To compile and run a pins24 program, you must clone this repository and run:

./pins24 ./path-to-my-source-program.pins24

You can check out the ./examples directory for some example pins24 programs.

Examples

Hello World

fun main() =
    putstr("Hello World\n\00")

Variable assignment, function calling

fun main() =
    let
        var x = 10
    in
	    x = inc(x),
	    x
    end

fun inc(n) = n + 1

Conditionals, loops

var x = 20

fun main() =
    while x > 0 do
        putint(x),
        if x % 2 == 0 then
            putstr(" is even\n\00")
        else
            putstr(" is odd\n\00")
        end,
        x = x - 1
    end,
    0

Standard library

exit(exitcode)

Exits the program with the specified exit code.

getint()

Returns the integer read from the standard input.

putint(value)

Prints the integer to standard input.

getstr(straddr)

Writes the string from standard input to the specified address.

putstr(straddr)

Writes the string from specified address to standard output.

new(size)

Reserves the specified amount of space on the heap.

del(straddr)

Frees up reserved memory space at the specified address on the heap.

Note: This technically does nothing, due to our simplified heap implementation.

append(dst_ptr, src_str)

Appends the string at the source address to the string at the destination address.

The destination must have enough memory allocated for both strings.

repeat(dst_ptr, char, count)

Writes count repetitions of character char to the destination string memory address.

strcat(dst_ptr, src_ptr)

Concatenates provided strings at the destination string memory address.

strlen(src_ptr)

Returns the length of the string at the specified memory address.

strcpy(dst_ptr, src_ptr)

Copies the string from source memory address to the destination memory address.

The destination memory address must have enough allocated memory for the whole source string length.