Report a bug
		
				If you spot a problem with this page, click here to create a Bugzilla issue.
		
			Improve this page
		
			Quickly fork, edit online, and submit a pull request for this page.
			Requires a signed-in GitHub account. This works well for small changes.
			If you'd like to make larger changes you may want to consider using
			a local clone.
		
	dmd.target
Handles target-specific parameters
In order to allow for cross compilation, when the compiler produces a binary
 for a different platform than it is running on, target information needs
 to be abstracted. This is done in this module, primarily through Target.
Note While DMD itself does not support cross-compilation, GDC and LDC do. Hence, this module is (sometimes heavily) modified by them, and contributors should review how their changes affect them.
See Also: 
Authors: 
License: 
Source target.d
Documentation https://dlang.org/phobos/dmd_target.html
- voidaddDefaultVersionIdentifiers(ref const Paramparams, ref const Targettgt);
- Add default version identifier for dmd, and set the target platform inparams. https://dlang.org/spec/version.html#predefined-versionsNeeds to be run after all arguments parsing (command line, DFLAGS environment variable and config file) in order to add final flags (such as X86_64 or the CRuntime used).Parameters:Param paramswhich target to compile for (set by setTarget()) Target tgttarget 
- structTarget;
- Describes a back-end target. At present it is incomplete, but in the future it should grow to contain most or all target machine and target O/S specific information.In many cases, calls to sizeof() can't be used directly for getting data type sizes since cross compiling is supported and would end up using the host sizes rather than the target sizes.- enumOS: ubyte;
- Bit decoding of the Target.OS
- ubyteptrsize;
- size of a pointer in bytes
- ubyterealsize;
- size a real consumes in memory
- ubyterealpad;
- padding added to the CPU real size to bring it up to realsize
- ubyterealalignsize;
- alignment for reals
- ubyteclassinfosize;
- size of ClassInfo
- ulongmaxStaticDataSize;
- maximum size of static data
- TargetCc;
- C ABI
- TargetCPPcpp;
- C++ ABI
- TargetObjCobjc;
- Objective-C ABI
- const(char)[]architectureName;
- Architecture name
- const(char)[]obj_ext;
- extension for object files
- const(char)[]lib_ext;
- extension for static library files
- const(char)[]dll_ext;
- extension for dynamic library files
- boolrun_noext;
- allow -run sources without extensions
- structFPTypeProperties(T);
- Values representing all properties for floating point types- real_tmax;
- largest representable value that's not infinity
- real_tmin_normal;
- smallest representable normalized value that's not 0
- real_tnan;
- NaN value
- real_tinfinity;
- infinity value
- real_tepsilon;
- smallest increment to the value 1
- longdig;
- number of decimal digits of precision
- longmant_dig;
- number of bits in mantissa
- longmax_exp;
- maximum int value such that 2max_exp-1 is representable
- longmin_exp;
- minimum int value such that 2min_exp-1 is representable as a normalized value
- longmax_10_exp;
- maximum int value such that 10max_10_expis representable
- longmin_10_exp;
- minimum int value such that 10min_10_expis representable as a normalized value
 
- FPTypeProperties!floatFloatProperties;
- FPTypeProperties!doubleDoubleProperties;
- FPTypeProperties!real_tRealProperties;
- void_init(ref const Paramparams);
- Initialize the Target
- @safe Target.ObjectFormatobjectFormat() const;
- Determine the object format to be used
- @safe voidsetCPU();
- Determine the instruction set to be used
- @safe voiddeinitialize();
- Deinitializes the global state of the compiler.This can be used to restore the state set by _init to its original state.
- uintalignsize(Typetype);
- Requested target memory alignment size of the given type.Parameters:Type typetype to inspect Returns:alignment in bytes
- uintfieldalign(Typetype);
- Requested target field alignment size of the given type.Parameters:Type typetype to inspect Returns:alignment in bytes
- Typeva_listType(Locloc, Scope*sc);
- Type for the va_list type for the target; e.g., required for _argptr declarations.NOTE For Posix/x86_64 this returns the type which will really be used for passing an argument of type va_list. Returns:Type that represents va_list.
- @safe intisVectorTypeSupported(intsz, Typetype);
- Checks whether the target supports a vector type.Parameters:int szvector type size in bytes Type typevector element type Returns:0 vector type is supported, 1 vector type is not supported on the target at all 2 vector element type is not supported 3 vector size is not supported
- boolisVectorOpSupported(Typetype, EXPop, Typet2= null);
- Checks whether the target supports the given operation for vectors.Parameters:Type typetarget type of operation EXP opthe unary or binary op being done on the typeType t2type of second operand if opis a binary operationReturns:true if the operation is supported or type is not a vector
- @safe LINKsystemLinkage();
- Default system linkage for the target.Returns:LINK to use for extern(System)
- TypeTupletoArgTypes(Typet);
- Describes how an argument type is passed to a function on target.Parameters:Type ttype to break down Returns:tuple of types if type is passed in one or more registers empty tuple if type is always passed on the stack null if the type is a void or argtypes aren't supported by the target
- boolisReturnOnStack(TypeFunctiontf, boolneedsThis);
- Determine return style of function - whether in registers or through a hidden pointer to the caller's stack.Parameters:TypeFunction tffunction type to check bool needsThistrue if the function type is for a non-static member function Returns:true if return value from function is on the stack
- boolpreferPassByRef(Typet);
- Decides whether an in parameter of the specified POD type is to be passed by reference or by value. To be used with -preview=in only!Parameters:Type ttype of the in parameter, must be a POD Returns:true if the in parameter is to be passed by reference
- ExpressiongetTargetInfo(const(char)*name, Locloc);
- Get targetInfo by keyParameters:const(char)* namename of targetInfo to get Loc loclocation to use for error messages Returns:Expression for the requested targetInfo
- @safe boolisCalleeDestroyingArgs(TypeFunctiontf);
- Parameters:TypeFunction tftype of function being called Returns:true if the callee invokes destructors for arguments.
- boollibraryObjectMonitors(FuncDeclarationfd, Statementfbody);
- Returns true if the implementation for object monitors is always defined in the D runtime library (rt/monitor_.d).Parameters:FuncDeclaration fdfunction with synchronized storage class. Statement fbodyentire function body of fdReturns:false if the target backend handles synchronizing monitors.
- @safe boolsupportsLinkerDirective() const;
- Returns true if the target supports pragma(linkerDirective).Returns:false if the target does not support pragma(linkerDirective).
- @safe boolisXmmSupported();
- Returns:true if xmm usage is supported
- nothrow @nogc @property @safe boolisPOSIX() const scope;
- Returns:true if generating code for POSIX
- @safe uintstackAlign();
- Returns:alignment of the stack
 
- structTargetC;
- Functions and variables specific to interfacing with extern(C) ABI.- boolcrtDestructorsSupported;
- Not all platforms support crt_destructor
- ubyteboolsize;
- size of a C _Bool type
- ubyteshortsize;
- size of a C short or unsigned short type
- ubyteintsize;
- size of a C int or unsigned int type
- ubytelongsize;
- size of a C long or unsigned long type
- ubytelong_longsize;
- size of a C long long or unsigned long long type
- ubytelong_doublesize;
- size of a C long double
- ubytewchar_tsize;
- size of a C wchar_t type
- Runtimeruntime;
- vendor of the C runtime to link against
- BitFieldStylebitFieldStyle;
- different C compilers do it differently
- boolcontributesToAggregateAlignment(BitFieldDeclarationbfd);
- Indicates whether the specified bit-field contributes to the alignment of the containing aggregate. E.g., (not all) ARM ABIs do NOT ignore anonymous (incl. 0-length) bit-fields.
 
- structTargetCPP;
- Functions and variables specific to interface with extern(C++) ABI.- boolreverseOverloads;
- set if overloaded functions are grouped and in reverse order (such as in dmc and cl)
- boolexceptions;
- set if catching C++ exceptions is supported
- booltwoDtorInVtable;
- target C++ ABI puts deleting and non-deleting destructor into vtable
- boolsplitVBasetable;
- set if C++ ABI uses separate tables for virtual functions and virtual bases
- boolwrapDtorInExternD;
- set if C++ dtors require a D wrapper to be callable from runtime
- Runtimeruntime;
- vendor of the C++ runtime to link against
- const(char)*toMangle(Dsymbols);
- Mangle the given symbol for C++ ABI.Parameters:Dsymbol sdeclaration with C++ linkage Returns:string mangling of symbol
- const(char)*typeInfoMangle(ClassDeclarationcd);
- Get RTTI mangling of the given class declaration for C++ ABI.Parameters:ClassDeclaration cdclass with C++ linkage Returns:string mangling of C++ typeinfo
- const(char)*thunkMangle(FuncDeclarationfd, intoffset);
- Get mangle name of a this-adjusting thunk to the given function declaration for C++ ABI.Parameters:FuncDeclaration fdfunction with C++ linkage int offsetcall offset to the vptr Returns:string mangling of C++ thunk, or null if unhandled
- const(char)*typeMangle(Typet);
- Gets vendor-specific type mangling for C++ ABI.Parameters:Type ttype to inspect Returns:string if type is mangled specially on target null if unhandled
- TypeparameterType(Typet);
- Get the type that will really be used for passing the given argument to an extern(C++) function, or null if unhandled.Parameters:Type ttype to be passed. Returns:Type to use for typet.
- boolfundamentalType(const Typet, ref boolisFundamental);
- Checks whether type is a vendor-specific fundamental type.Parameters:Type ttype to inspect bool isFundamentalwhere to store result Returns:true if isFundamental was set by function
- uintderivedClassOffset(ClassDeclarationbaseClass);
- Get the starting offset position for fields of an extern(C++) class that is derived from the given base class.Parameters:ClassDeclaration baseClassbase class with C++ linkage Returns:starting offset to lay out derived class fields
 
- structTargetObjC;
- Functions and variables specific to interface with extern(Objective-C) ABI.- boolsupported;
- set if compiler can interface with Objective-C
 
- Targettarget;
Copyright © 1999-2025 by the D Language Foundation | Page generated by
Ddoc on Mon Mar 31 10:28:03 2025