Lib.rs

Introduction

Ternlang is a stack based programming language, which means that you're able to push and pop variables to and from the stack, and that all instructions are operated on the stack. All values are in ternary, which is a base-3 number system.

Pushing to the stack

To push a value to the stack, use the > instruction, followed by either a character (can be any valid unicode character), or a number in ternary. Example:

>201

Push 0t201 to the stack (19 in decimal)

>a

Push the character a to the stack

Popping from the stack

If you want to manually pop a value from the stack, use the < instruction. Popping when the stack is empty will give a runtime error.

>122<

First push 0t122 to the stack, then pop from the stack. The stack is now empty

Printing

To print a value, use the ! instruction. This pops a value from the stack and prints it to the temrinal (as an unicode character).

>10121!

output: a

>d>l>r>o>w>o>l>l>e>h!!!!!!!!!!

output: helloworld

Getting input

To get the user's input, use the ? instruction:

?!

Read the user's input and then print it

>e?!!

Read the user's input, then print it followed by an e

Arithmetic

Each arithmetic instruction pops 2 values from the stack and executes that operation on them, then pushes the new value to the stack.

Addition

Add 2 numbers using +:

>1>2+

Value stored on the stack is now 3

Subtraction

Subtract a number from another using -:

>20>2-

Value stored on the stack is now 4

Multiplication

Multiply 2 numbers using *:

>10>11*

*Value stored on the stack is now 12

Division

Divide a number by another using /:

>22>11/

*Value stored on the stack is now 2

Comparing

The = instruction pops 2 values off the stack. If a < b it pushes 0, if a == b it pushes 1, and if a > b it pushes 2

>201>201=

Value stored on the stack is now 1

>1>2=

Value stored on the stack is now 0

Loops

You can create a loop using []. Each iteration, the top 2 values on the stack will be compared. If they are equal, the loop stops. Else, the loop continues running.

>10>0[>1+>a!]

output: aaa

Duplication

You can duplicate the value at the top of the stack using @:

>e@!!

output: ee