All these methods can be called for compiler configuration macros.

Static methods

staticaddClassPath (path:String):Void

Available on macro, neko

staticaddGlobalMetadata (pathFilter:String, meta:String, recursive:Bool = true, toTypes:Bool = true, toFields:Bool = false):Void

Available on macro, neko

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 macro, neko

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 macro, neko

Adds an argument to be passed to the native compiler (e.g. -javac-arg for Java).

staticaddNativeLib (name:String):Void

Available on macro, neko

Adds a native library depending on the platform (e.g. -swf-lib for Flash).

staticallowPackage (v:String):Void

Available on macro, neko

staticdefine (flag:String, ?value:String):Void

Available on macro, neko

Set a conditional compiler flag.

staticexclude (pack:String, rec:Bool = true):Void

Available on macro, neko

Exclude a specific class, enum, or all classes and enums in a package from being generated. Excluded types become extern.

Parameters:

rec

If true, recursively excludes all sub-packages.

staticexcludeFile (fileName:String):Void

Available on macro, neko

Exclude classes and enums listed in an extern file (one per line) from being generated.

staticgetDefine (key:Dynamic):Dynamic

A conditional compiler flag can be set 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.

See:

staticgetDisplayPos ():Null<{pos:Int, file:String}>

Available on macro, neko

staticgetOutput ():String

Available on macro, neko

staticinclude (pack:String, rec:Bool = true, ?ignore:Array<String>, ?classPaths:Array<String>, strict:Bool = false):Void

Available on macro, neko

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:

rec

If true, recursively adds all sub-packages.

ignore

Array of module names to ignore for inclusion.

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:Dynamic, position:Dynamic):Dynamic

Available on js, lua

Embed a JavaScript file at compile time (can be called by --macro or within an __init__ method).

staticincludeFile (file:String, position:IncludePosition = Top):{pos:Position, expr:ExprDef}

Available on macro

Embed a JavaScript 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 macro, neko

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.

staticpatchTypes (file:String):Void

Available on macro, neko

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 macro, neko

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 macro, neko

Change the default JS output by using a custom generator callback

staticsetFieldType (className:String, field:String, type:String, ?isStatic:Bool):Void

Available on macro, neko

Set the type of a (static) field at a given class by name. An error is thrown when className or field is invalid.

staticsetOutput (fileOrDir:String):Void

Available on macro, neko