Skip to content
somebody1234 edited this page Oct 20, 2016 · 9 revisions

Getting started with Charcoal

Using Charcoal

There are many flags you can use to specify how you want to use Charcoal.

Types

Name Succinct mode Verbose mode
Integer (int) A run of ⁰¹²³⁴⁵⁶⁷⁸⁹ A run of 0123456789
String (str) A run of ASCII printables ( to ~), or a compressed string (more about this later) A string delimited with " or ', processed with Unicode unescaping
Variable (var) One of αβγδεζηθικλμνξπρσςτυφχψω One of abgdezhciklmnxprstufko
Literal (lit) An int, str, or var An int, str, or var
Arrow (arw) One of ←↑→↓↖↗↘↙ One of :Left, :Right, :Up, :Down, :UpLeft, :UpRight, :DownLeft and :DownRight.
List (lst) A list of lit, delimited by ⟦⟧
Separator (sep) ¦ One of ,;

Separators can be placed after any literal, i.e. an int, str, or var.

Compressed strings

Strings delimited by “” are compressed strings. This means they are ASCII strings converted from base 96 or under (the 95 printables and newline) to base 255 (the full 8-bit codepage minus ). The first character in the string is the encoded character for the base.

Strings delimited by ”” are permuted compressed strings. This means they are ASCII strings converted from base 96 or under to base 255. The first character in the string is the encoded index of the permutation number, the second is the encoded character for the base.

Permutation number

The default order of the ASCII character set is whitespace, symbols, lowercase letters, numbers, and uppercase letters. An index is generated based on the number of uses of each type of character using this order as the base.

Commands

Pretty simple. In succinct mode it's just <command><arguments>, in verbose mode it's just <command>(<arguments>).

Clone this wiki locally