TPPL

From Esolang
Jump to: navigation, search
Not to be confused with TP, another language also based on toilet paper.

The Toilet Paper Programming Language, or TPPL for short, is an esoteric language created by User:Saka. It is based on toilet paper but is not truly toilet paper.

The language is still somewhat work in progress.

Data Types

There are 2 main data types in this language: Integers and Sequences.
Sequences are just what they sound like, sequences of integers. A sequence can be represented in the form of a string of numbers separated by commas (,) such as 1,0,2,2.
An integer is an ordinary number, such as 6.

Basics

A TPPL program starts with "ENTER RESTROOM" or "ENTER BATHROOM", otherwise it will throw an error.
A TPPL program starts with a roll of toilet paper with length 1. Imagine this as a stack with 1 item which has value 0.
Each sheet of toilet paper (An item in a stack) can have a value from 0 to 2 (Inclusive), this is because the toilet paper being used is 2-ply.
In TPPL, only 1 sheet of the toilet paper (1 item of the stack) may be read at a time. The PULL instruction changes what sheet is being read. There are 3 places data can be stored, the main toilet paper roll (Main stack), the trash bin (A stack of sequences), and the HOLD slot, where toilet paper that has been ripped off awaits further processing.

Instructions

Instruction Description
PULL Change the current index of the sheet currently visible by +1. Equivalent to going 1 item up in a stack. It will go back to index 0 (Bottom of the stack) if the program tries to pull more than the length of the toilet paper.
ADD Add 1 more sheet of toilet paper to the back with value 0 (Add an item to the top of the stack with value 0).
WIPE Increment the value of the current visible sheet by 1.
CLEAN Decrease the value of the current visible sheet by 1.
RIP Rip off the visible sheet along with the ones below it and hold it (Pop off values from index n (Current item) to index 0 and turn the values into a sequence and move the sequence to HOLD).
TRASH Throw the toilet paper in HOLD to the trash (Take the sequence in HOLD, push it to the "TRASH" stack).
DISCARD Throw the toilet paper in HOLD to the corner where you will never get it back (Clear HOLD. Will not return error if HOLD is empty.).
TAKE n Take the sequence with index n from the trash (Pop item n from TRASH and put it in HOLD).
COPY n Take sequence n from the trash and photocopy it (Copy item n from TRASH into HOLD).
APPEND Stitch the toilet paper in HOLD to back to the main roll (Convert the sequences into individual values and put those values on the bottom of the roll stack). The visible roll is moved by +1 except if the roll has length 0 before APPEND.
EXIT Exit the restroom (Terminate the program).
CHECK s YES? n Check if the toilet paper in HOLD is equal to the sequence s, if so, go to line n, otherwise, go to the next line like nothing happened. If s is more than 2, check if the sequence in HOLD is the same as the sequence in TRASH with index s-3.
JUMP n Go to line n.
SPIN n Like JUMP but relative to the command, so n = 2 will go 2 lines down and n = -2 will go 2 lines up.
SET Set the current sheet's value to a user input.
GET Get a 1-character ASCII input, convert it to ternary, and then add the values to the end of the toilet paper (Top of stack).
FLUSH Throw the toilet paper in HOLD down the toilet (Convert the sequence in HOLD to an integer (e.g. 1,2,0 -> 120) and output it as ASCII)

More may be added.
Comments are any line starting with "#".
Any error that occurs terminates the program

Examples

Truth Machine

Input 0 or 1

ENTER BATHROOM
SET
RIP
ADD
ADD
ADD
ADD
CHECK 1 YES? 19
TRASH
PULL
WIPE
PULL
WIPE
WIPE
PULL
WIPE
RIP
FLUSH
EXIT
TRASH
WIPE
PULL
WIPE
PULL
WIPE
WIPE
PULL
WIPE
RIP
FLUSH
ADD
ADD
ADD
ADD
JUMP 20

Hello, World!

No newline.

ENTER BATHROOM
#Hello, World!
ADD
ADD
ADD
PULL
PULL
WIPE
WIPE
PULL
WIPE
WIPE
RIP
FLUSH
ADD
ADD
ADD
ADD
ADD
WIPE
WIPE
PULL
PULL
WIPE
WIPE
PULL
PULL
WIPE
RIP
FLUSH
ADD
ADD
ADD
ADD
ADD
PULL
PULL
PULL
WIPE
PULL
WIPE
RIP
FLUSH
ADD
ADD
ADD
ADD
ADD
PULL
PULL
PULL
WIPE
PULL
WIPE
RIP
FLUSH
ADD
ADD
ADD
ADD
ADD
PULL
WIPE
PULL
PULL
WIPE
PULL
WIPE
RIP
FLUSH
ADD
ADD
ADD
ADD
WIPE
WIPE
PULL
WIPE
WIPE
PULL
WIPE
PULL
WIPE
RIP
FLUSH
ADD
ADD
ADD
ADD
WIPE
WIPE
PULL
WIPE
PULL
PULL
WIPE
RIP
FLUSH
ADD
ADD
ADD
ADD
ADD
PULL
WIPE
WIPE
PULL
PULL
PULL
WIPE
RIP
FLUSH
ADD
ADD
ADD
ADD
ADD
PULL
WIPE
PULL
PULL
WIPE
PULL
WIPE
RIP
FLUSH
ADD
ADD
ADD
ADD
ADD
PULL
WIPE
WIPE
PULL
PULL
WIPE
PULL
WIPE
RIP
FLUSH
ADD
ADD
ADD
ADD
ADD
PULL
PULL
PULL
WIPE
PULL
WIPE
RIP
FLUSH
ADD
ADD
ADD
ADD
ADD
WIPE
PULL
PULL
WIPE
WIPE
PULL
PULL
WIPE
RIP
FLUSH
ADD
ADD
ADD
ADD
PULL
WIPE
WIPE
PULL
PULL
WIPE
RIP
FLUSH
EXIT

CAT Program

Input 1 character.

ENTER BATHROOM
RIP
DISCARD
GET
RIP
FLUSH
EXIT

Interpreters

Python

Available on GitHub