Define Expressions

Define expression are responsible for all ahead-of-time things you can do, like creating a new color or defining a new keyword. It is generally recommended to only use #define Statements at the beginning of SusLang scripts.

If you are interested in how they actually work, you can find their source code [here].(https://github.com/zenonet/SusLang/blob/master/SusLang.Compiler/Expressions/DefaultExpressions/DefineExpression.cs)

#define color

#define color <color-name> allows you to create your own color which you can use like any other color.

Works in v0.5+

#define color neonblack

neonblack killed
report neonblack

#define suspect

#define suspect <color> sets a colors value to 65. This is useful when writing text is SusLang because 65 is the index of A, the first actual letter in ASCII
Note that this will set a colors value to 65 when the #define statement gets parsed. NOT when it's executed.
This might lead to unexpected behaviour in for example #define keyword expressions.

Works in v0.5+

#define suspect red

emergencyMeeting red

This will output the capital A.

#define keyword

#define keyword <name> [parameter1] [parameter2] allows you to create your own keywords like this:

Works in v0.5+

// This will create a keyword called vanished with one parameter (called red) which increases it's parameter by 5
#define keyword vanished red
    // Increase red by 5
    red vented
    red vented
    red vented
    red vented
    red vented
// This marks the end of the keyword definition:
#define keyword end

After defining the keyword, you can use it like this:

cyan killed

// Call the custom keyword
cyan vanished

//This will output 15 because vanished increased it's parameter by 5
report cyan

#define import

The name of this one is a but weird, I might change it some day.
Anyways, the #define import <path> expression allows you to import a SusLang-Library into your current file.
Here is an example:

Works in v0.5+

In your mylib.sus file

#define keyword plus red green
    //Copy green to blue
    blue wasWith green

    //Add blue to red
    sus blue
    [
        red vented
        blue wasWithMe
    ]
#define keyword end

In your main file:

#define import mylib.sus

red killed
green vented
green vented
green vented

red plus green

report red

As you can see, the add keyword is defined in the mylib file but because of the #define import Statement, you can still use the keyword in your main file.

This works by simply executing the imported files (in the same context) when parsing the #define import Statement. This is far from a clean solution but hey, this is an esolang!