All these methods can be called for compiler configuration macros.
Static methods
staticaddClassPath(path:String):Void
Available on neko, macro
Add a class path where ".hx" source files or packages (sub-directories) can be found.
Usage of this function outside of initialization macros is deprecated and may cause compilation server issues.
staticaddGlobalMetadata(pathFilter:String, meta:String, recursive:Bool = true, toTypes:Bool = true, toFields:Bool = false):Void
Available on neko, macro
Adds metadata meta
to all types (if toTypes = true
) or fields (if
toFields = true
) whose dot-path matches pathFilter
.
If recursive
is true a dot-path is considered matched if it starts
with pathFilter
. This automatically applies to path filters of
packages. Otherwise an exact match is required.
If pathFilter
is the empty String ""
it matches everything (if
recursive = true
) or only top-level types (if recursive = false
).
This operation has no effect if the type has already been loaded, e.g.
through Context.getType
.
staticaddMetadata(meta:String, className:String, ?field:String, ?isStatic:Bool):Void
Available on neko, macro
Add metadata to a (static) field or class by name.
An error is thrown when className
or field
is invalid.
staticaddNativeArg(argument:String):Void
Available on neko, macro
Adds an argument to be passed to the native compiler (e.g. -javac-arg
for Java).
staticaddNativeLib(name:String):Void
Available on neko, macro
Adds a native library depending on the platform (e.g. -swf-lib
for Flash).
Usage of this function outside of initialization macros is deprecated and may cause compilation server issues.
staticdefine(flag:String, ?value:String):Void
Available on neko, macro
Set a conditional compiler flag.
Usage of this function outside of initialization macros is deprecated and may cause compilation server issues.
staticexclude(pack:String, rec:Bool = true):Void
Available on neko, macro
Exclude a specific class, enum, or all classes and enums in a
package from being generated. Excluded types become extern
.
Parameters:
pack | The package dot-path as String. Use |
---|---|
rec | If true, recursively excludes all sub-packages. |
staticexcludeFile(fileName:String):Void
Available on neko, macro
Exclude classes and enums listed in an extern file (one per line) from being generated.
staticgetDefine(key:Dynamic):Dynamic
A conditional compilation flag can be set on the command line using
-D key=value
.
Returns the value of a compiler flag.
If the compiler flag is defined but no value is set,
Compiler.getDefine
returns "1"
(e.g. -D key
).
If the compiler flag is not defined, Compiler.getDefine
returns
null
.
Note: This is a macro and cannot be called from within other macros. Refer
to haxe.macro.Context.definedValue
to obtain defined values in macro context.
See also:
staticinclude(pack:String, rec:Bool = true, ?ignore:Array<String>, ?classPaths:Array<String>, strict:Bool = false):Void
Available on neko, macro
Includes all modules in package pack
in the compilation.
In order to include single modules, their paths can be listed directly
on command line: haxe ... ModuleName pack.ModuleName
.
By default Compiler.include
will search for modules in the directories defined with -cp
.
If you want to specify a different set of paths to search for modules, you can use the optional
argument classPath
.
Parameters:
pack | The package dot-path as String. Use |
---|---|
rec | If true, recursively adds all sub-packages. |
ignore | Array of module names to ignore for inclusion.
You can use |
classPaths | An alternative array of paths (directory names) to use to search for modules to include. Note that if you pass this argument, only the specified paths will be used for inclusion. |
strict | If true and given package wasn't found in any of class paths, fail with an error. |
staticincludeFile(file:String, position:IncludePosition = Top):Expr
Available on macro
Embed a JavaScript or Lua file at compile time (can be called by --macro
or within an __init__
method).
staticincludeFile(file:Dynamic, position:Dynamic):Dynamic
Available on lua, js
Embed a JavaScript or Lua file at compile time (can be called by --macro
or within an __init__
method).
statickeep(?path:String, ?paths:Array<String>, recursive:Bool = true):Void
Available on neko, macro
Marks types or packages to be kept by DCE.
This also extends to the sub-types of resolved modules.
In order to include module sub-types directly, their full dot path
including the containing module has to be used
(e.g. msignal.Signal.Signal0
).
This operation has no effect if the type has already been loaded, e.g.
through Context.getType
.
Parameters:
path | A package, module or sub-type dot path to keep. |
---|---|
paths | An Array of package, module or sub-type dot paths to keep. |
recursive | If true, recurses into sub-packages for package paths. |
staticnullSafety(path:String, mode:NullSafetyMode = Loose, recursive:Bool = true):Void
Available on neko, macro
Enables null safety for a type or a package.
Parameters:
path | A package, module or sub-type dot path to enable null safety for. |
---|---|
recursive | If true, recurses into sub-packages for package paths. |
staticpatchTypes(file:String):Void
Available on neko, macro
Load a type patch file that can modify the field types within declared classes and enums.
staticremoveField(className:String, field:String, ?isStatic:Bool):Void
Available on neko, macro
Removes a (static) field from a given class by name.
An error is thrown when className
or field
is invalid.
staticsetCustomJSGenerator(callb:JSGenApi ‑> Void):Void
Available on neko, macro
Change the default JS output by using a custom generator callback