commands.md

Commands

List of commands available in Pepe.

• Click the section title to view corresponding column in the project.
• Click the command name to view corresponding note in the project.
• Stack << - Push to stack
• Stack >> - Pop selected item from the stack and perform action on the popped item.
• Pushed items always go to the end of stack and they don't change pointer location.

1 E/e (2) Basic stack operations

• Flags: r = Insert, R = Prepend

  • E - WS << push 0
• e - WS >> Do nothing (pop)

2 E/e (4) Program flow

For every command in section: X is value of the selected item from WS.

Goto commands don't do anything if corresponding labels don't exist.

Commands in this section do not pop.

Flags are listed in a project column

• EE - Create label with name X
  • Calling again with the same name will result in replacing previous label
• Ee - Return to where a goto was called last
• eE - Goto label X if active item == active item in the other stack
• ee - Goto label X if active item != active item in the other stack

3 E/e (8) I/O

If input is a string, every contained byte is pushed as an integer

WARNING - Pepe has multiple inputs support. Calling an input-taking function will move the "input pointer" to the next value

• Flags: r = Insert, R = Prepend

  • EEE - WS << Auto-parse input
  • EEe - WS << Parse input as string
  • EeE - WS << Parse input as integer
  • Eee - WS << Parse input as float

• Flags: r = Preserve

  • eEE - WS >> Output as number
  • eEe - WS >> Output as character
• eeE - Output newline (\n)
• eee - Output WS content as string without popping

4 E/e (16) Pointer

1 slot left

• EEEE - Move WS pointer to first item
• EEEe - Move WS pointer to last item
• EEeE - Rewind - Move WS pointer to previous item
• EEee - Forward - Move WS pointer to next item
• EeEE - Set position to random item
• EeEe - Empty (reserved for random function)
• EeeE - Push pointer position (0-indexed)
• Eeee - Push pointer position in reverse
• eEEE - Move input pointer to the first item
• eEEe - Move input pointer to the last item
• eEeE - Move input pointer to the previous item
• eEee - Move input pointer to the next item
• eeEE - Push input pointer position
• eeEe - Push amount of input items left
  • Warning: this will return a negative number if end of input was crossed.
• eeeE - Lock input pointer – prevent automatic changes to it
• eeee - Unlock input pointer – allow automatic changes to it

5 E/e (32) Active item

12 slots left

• Flags: r = PopPush, R = PreservePush

  • EEEEE - Increment active item
  • EEEEe - Decrement active item
• EEEeE - Deprecated Duplicate active item (duplicate to next)

• Flags: r = Insert, R = Prepend

  • EEEee - Push active item (duplicate to end)

• Flags: r = PopPush, R = PreservePush

  • EEeEE - Random from 0 to active item value
  • EEeEe - Random from 1 to active item value
  • EEeeE - Round active item
  • EEeee - Round active item to 0.5
  • EeEEE - Ceil active item
  • EeEEe - Floor active item
  • EeEeE - Absolute value of active item
  • EeEee - Reverse sign of active item (times -1)
  • EeeEE - Square - Raise active item to second power
  • EeeEe - Cube - Raise active item to third power
  • EeeeE - Square root of active item
  • Eeeee - Cube root of active item
  • eEEEE - Modulo 2 of active item
  • eEEEe - Modulo 3 of active item
  • eEEeE - Active item << 1
  • eEEee - Active item >>> 1

6 E/e (64) 2 value

49 slots left

Commands operating on active items from both stacks.

A = active item from WS, B = active item from the other stack

All commands here support the flags:

r = Preserve,
R = Empty,
rr = Insert,
rR = Prepend,
Rr = Insert & Preserve,
RR = Prepend & Preserve

• EEEEEE - WS << A+B
• EEEEEe - WS << A-B
• EEEEeE - WS << A*B
• EEEEee - WS << A/B
• EEEeEE - WS << str(A)+str(B)
• EEEeEe - WS << A split every B digit
• EEEeeE - WS << B chunks of A
• EEEeee - Empty
• EEeEEE - WS << A^B
• EEeEEe - WS << B'th root of A
• EEeEeE - WS << A%B (modulo)
• EEeEee - Empty
• EEeeEE - Left bit shift
• EEeeEe - Logical right bit shift
• EEeeeE - WS << Character repeated B times.
• EEeeee - Empty
• EeEEEE - WS << Random number A...B (inclusive)
• EeEEEe - WS << Random number A..B (exclusive)
• EeEEeE - WS << Greater number (max) of A and B
• EeEEee - WS << Lower number (min) of A and B

7 E/e (128) Cross-stack

121 slots left

• Flags: r = Insert, R = Prepend

  • EEEEEEE - Move active item to the other stack
  • EEEEEEe - Copy active item to the other stack
  • EEEEEeE - Move WS content to the other stack
  • EEEEEee - Copy WS content to the other stack
• EEEEeEE - Reverse stack names (R = r; r = R)
• EEEEeEe - Empty
• EEEEeeE - Diff - Remove items from WS that occur in the other stack
• EEEEeee - Reverse diff - Remove items from wS that don't occur in the other stack

8 E/e (256) Full stack

246 slots left

Commands operating on the whole stack

• Flags:
  r = Preserve,
  R = Empty,
  rr = Insert,
  rR = Prepend,
  Rr = Insert & Preserve,
  RR = Prepend & Preserve

  • EEEEEEEE - Sum (+)
  • EEEEEEEe - Empty
  • EEEEEEeE - Product (*)
  • EEEEEEee - Empty
  • EEEEEeEE - Join
  • EEEEEeEe - Empty
• EEEEEeeE - Increment all
• EEEEEeee - Decrement all
• EEEEeEEE - Clear
• EEEEeEEe - Clear, but don't remove selected item
• EEEEeEeE - Sort
• EEEEeEee - Reverse order
• EEEEeeEE - Shuffle order
• EEEEeeEe - Reserved for an order-changing function
• EEEEeeeE - Greatest number in the stack (max)
• EEEEeeee - Lowest number in the stack (min)

9 E/e (512) Characters

First letter:

• E - Push
• e - Print as character

Following letters are parsed as:

• E - 1
• e - 0

Converted to a binary number, then to a corresponding ASCII character.

Ex: To print A, the command would be reEeeeeeeE.

Supported flags:

r = Insert R = Prepend