 |
ALib C++ Library
|
|
|
ALib C++ Library
|
|
#include <compilerplugin.hpp>
Public inner base struct which provides input and output information for compiling single entities (nodes of the AST) of a parsed expression.
Descendant types
extend this struct with input information, specific to the type of AST-node currently compiled. Special, descendant type
in addition adds specific output members.
Together, these four descendants comprise the parameters of the four overloaded methods TryCompilation.
Definition at line 143 of file compilerplugin.hpp.
Public Fields | |
| ArgIterator | ArgsBegin |
| ArgIterator | ArgsEnd |
| CallbackDecl | Callback = nullptr |
| MonoAllocator & | CompileTimeAllocator |
| Scope & | CompileTimeScope |
| const nchar * | DbgCallbackName = nullptr |
| Box | TypeOrValue = nullptr |
Public Methods | |
| CompilationInfo (Scope &scope, MonoAllocator &allocator) | |
|
inline |
Constructor.
| scope | The scope usable for allocation of constant values (compile-time allocations). Assigned to field CompileTimeScope. |
| allocator | Assigned to field CompileTimeAllocator. |
Definition at line 214 of file compilerplugin.hpp.
| ArgIterator ArgsBegin |
Input: A start iterator to sample boxes that provide the argument types to search a native callback function for.
In case that descendant classes denote that arguments found in this iterator are constant, then the boxes are not just sample boxes, but contain the constant values.
Definition at line 176 of file compilerplugin.hpp.
| ArgIterator ArgsEnd |
Input: The end iterator to ArgsBegin. The expression ArgsEnd - ArgsBegin may be used to receive the number of arguments provided.
Definition at line 182 of file compilerplugin.hpp.
| CallbackDecl Callback = nullptr |
Output: The native C++ callback function to be set by one of the plug-ins.
Definition at line 196 of file compilerplugin.hpp.
| MonoAllocator& CompileTimeAllocator |
An allocator to be used exclusively during compile-time. Its memory is cleared (respectively reset to a previous state) after the compilation completed.
(Refers to object Compiler::allocator.)
Definition at line 168 of file compilerplugin.hpp.
| Scope& CompileTimeScope |
The scope found here is the same object that is passed to method Compiler::Compile, which internally invokes the overloaded methods TryCompilation, that receive an object of this type.
If a compiled expression syntax element evaluates to a constant stored in TypeOrValue it has to be assured that the boxed data is to available during the life-cycle of the expression.
To allocate custom compilation data, a custom, derived type, might for example be extended with simplestd::vector of pointers to the created objects. (Attention: Vectors of value-types must not be used, as with their growth, the objects get moved within the heap memory!).
. Any data allocated, is to be deleted in the virtual destructor of the custom scope type.
Definition at line 160 of file compilerplugin.hpp.
| const nchar* DbgCallbackName = nullptr |
Output: The C++ name of the callback function. This field is available only in debug compilations of the library. Hence, setting it must be performed with preprocessor conditionals.
Definition at line 190 of file compilerplugin.hpp.
| Box TypeOrValue = nullptr |
Output: Specifies the return type of Callback, respectively, as the name indicates, the result value in case of constant results.
Note that in case of constant compile-time values, it might be necessary to allocate compile-time memory for the values. For this, field CompileTimeScope is to be used.
Definition at line 204 of file compilerplugin.hpp.
