Attributes

Spice offers the option to annotate single function or whole modules via attributes.

For attributes of type bool, the value true can be omitted.

Module attributes¶

1
2
3
4

// Attribute for the whole module
#![core.linker.flag = "-pthread"]

// ...

Available attributes¶

• core.linker.flag: string (default: ""): Append linker flag
• core.linux.linker.flag: string (default: ""): Append linker flag for Linux
• core.windows.linker.flag: string (default: ""): Append linker flag for Windows
• core.compiler.alwaysKeepOnNameCollision: bool (default: false): Always keep the symbols of this source files when merging the name registries of multiple source files

Function attributes¶

1
2
3
4
5
6

#[core.compiler.mangleName = false]
f<int> test(long input) {
    return input == 0 ? 123 : 456;
}

// ...

Available attributes¶

• core.compiler.mangle: bool (default: true): Enable/disable name mangling for the annotated function
• core.compiler.mangledName: string: Set the mangled name for the annotated function

External declaration attributes¶

1
2
3
4

#[core.compiler.mangleName = false]
ext f<heap byte*> malloc(unsigned long);

// ...

Available attributes¶

• core.compiler.mangle: bool (default: true): Enable/disable name mangling for the annotated function
• core.compiler.mangledName: string: Set the mangled name for the annotated function
• core.linker.dll: bool: Enable linkage as dll (only relevant for Windows)
• test: bool: Mark the annotated function as test
• test.name: string: Set the name of the test (only procedures with the test attribute are considered as tests)
• test.skip: bool: Skip the annotated function (only procedures with the test attribute are considered as tests)

Struct attributes¶

1
2
3
4

#[core.compiler.alwaysEmitVTable = true]
public type A struct {
    // ...
}

Available attributes¶

• core.compiler.alwaysEmitVTable: bool: Always emit a vtable for the annotated struct
• core.compiler.packed: bool: Pack the annotated struct

Interface attributes¶

1
2
3
4

#[core.compiler.fixedTypeId = 230]
public type A interface {
    // ...
}

Available attributes¶

• core.compiler.fixedTypeId: int: Set a fixed type id for the annotated interface. Intended for internal use only.