ante keyword is used for all things compile-time in Ante.
It is a modifier that can be applied to function declarations,
variable declarations, type declarations, and arbitrary expressions.
The most common use however, is the declaration of compile-time functions.
Note that when declaring such a function (an “ante function”), you do not
need to use the
ante keyword to call the function, only to declare it.
ante fun make_private: Type t = import Ante.Modifier for field in t do t.modifiers.remove Pub t.modifiers.remove Pro t.modifiers.append Pri type MyType = i32 one pub i32 two pro i32 three make_private MyType Ante.debug MyType //=> MyType = pri i32 one two three
ante can also be used to evaluate individual expressions during compile-time.
There are restrictions on what can be evaluated however. Mutable variables
cannot be used unless they are
ante mut, loop bindings cannot be evaluated
unless the entire loop is evaluated, and function parameters cannot be
evaluated unless they are also declared as
ante. Note that declaring a
ante makes the function a template, forcing it to be re-evaluated
each time in case any compile-time side effects need to be re-evaluated. If this
is not desired then odds are you do not need an
ante parameter. Here is an
example of an
ante parameter used to make a template function:
type Vec = 't* data, usz len cap //Take a type as a compile-time parameter and create a //new function that returns a vector of that type fun Vec.of: ante Type t = Vec with data = malloc (Ante.sizeof 't) as 't* len = 0usz cap = 1usz let v = Vec.of i32
ante parameters provide a convenient way of templating functions without any
obscure syntax and while maintaining strong, static typing. Compile-time functions,
like normal functions, can be declared to accept any parameter types, including
the type of types themselves in Ante. Resultingly, compile-time functions can be used
to implement new functionality for types (or functions, expressions, etc).
!macro fun derive_eq: Type t -> Expr //expand the macro into: fun (=): 't a b -> bool for field in t do if field a != field b then return false true type Person = Str name, u8 age derive_eq Person