Keeps track of the various options that can be enabled, which controls the dialect of C or C++ that is accepted. More...

#include "clang/Basic/LangOptions.h"

Inheritance diagram for clang::LangOptions:

[legend]

Public Member Functions
	LangOptions ()

bool	isCompilingModule () const
	Are we compiling a module?

bool	isCompilingModuleImplementation () const
	Are we compiling a module implementation?

bool	trackLocalOwningModule () const
	Do we need to track the owning module for a local declaration?

bool	isSignedOverflowDefined () const

bool	isSubscriptPointerArithmetic () const

bool	isCompatibleWithMSVC (MSVCMajorVersion MajorVersion) const

bool	isOverflowPatternExcluded (OverflowPatternExclusionKind Kind) const

void	resetNonModularOptions ()
	Reset all of the options that are not considered when building a module.

bool	isNoBuiltinFunc (StringRef Name) const
	Is this a libc/libm function that is no longer recognized as a builtin because a -fno-builtin-* option has been specified?

bool	allowsNonTrivialObjCLifetimeQualifiers () const
	True if any ObjC types may have non-trivial lifetime qualifiers.

bool	assumeFunctionsAreConvergent () const

bool	threadPrivateMemoryAtomicsAreUndefined () const
	Return true if atomicrmw operations targeting allocations in private memory are undefined.

VersionTuple	getOpenCLVersionTuple () const
	Return the OpenCL C or C++ version as a VersionTuple.

unsigned	getOpenCLCompatibleVersion () const
	Return the OpenCL version that kernel language is compatible with.

std::string	getOpenCLVersionString () const
	Return the OpenCL C or C++ for OpenCL language name and version as a string.

bool	requiresStrictPrototypes () const
	Returns true if functions without prototypes or functions with an identifier list (aka K&R C functions) are not allowed.

bool	implicitFunctionsAllowed () const
	Returns true if implicit function declarations are allowed in the current language mode.

bool	hasAtExit () const
	Returns true if the language supports calling the 'atexit' function.

bool	isImplicitIntRequired () const
	Returns true if implicit int is part of the language requirements.

bool	isImplicitIntAllowed () const
	Returns true if implicit int is supported at all.

bool	hasSignReturnAddress () const
	Check if return address signing is enabled.

bool	isSignReturnAddressWithAKey () const
	Check if return address signing uses AKey.

bool	isSignReturnAddressScopeAll () const
	Check if leaf functions are also signed.

bool	hasSjLjExceptions () const

bool	hasSEHExceptions () const

bool	hasDWARFExceptions () const

bool	hasWasmExceptions () const

bool	isSYCL () const

bool	hasDefaultVisibilityExportMapping () const

bool	isExplicitDefaultVisibilityExportMapping () const

bool	isAllDefaultVisibilityExportMapping () const

bool	hasGlobalAllocationFunctionVisibility () const

bool	hasDefaultGlobalAllocationFunctionVisibility () const

bool	hasProtectedGlobalAllocationFunctionVisibility () const

bool	hasHiddenGlobalAllocationFunctionVisibility () const

void	remapPathPrefix (SmallVectorImpl< char > &Path) const
	Remap path prefix according to -fmacro-prefix-path option.

RoundingMode	getDefaultRoundingMode () const

FPExceptionModeKind	getDefaultExceptionMode () const

Static Public Member Functions
static void	setLangDefaults (LangOptions &Opts, Language Lang, const llvm::Triple &T, std::vector< std::string > &Includes, LangStandard::Kind LangStd=LangStandard::lang_unspecified)
	Set language defaults for the given input language and language standard in the given LangOptions object.

Public Attributes
LangStandard::Kind	LangStd
	The used language standard.

SanitizerSet	Sanitize
	Set of enabled sanitizers.

bool	SanitizeCoverage = false
	Is at least one coverage instrumentation type enabled.

std::vector< std::string >	NoSanitizeFiles
	Paths to files specifying which objects (files, functions, variables) should not be instrumented.

std::vector< std::string >	XRayAlwaysInstrumentFiles
	Paths to the XRay "always instrument" files specifying which objects (files, functions, variables) should be imbued with the XRay "always instrument" attribute.

std::vector< std::string >	XRayNeverInstrumentFiles
	Paths to the XRay "never instrument" files specifying which objects (files, functions, variables) should be imbued with the XRay "never instrument" attribute.

std::vector< std::string >	XRayAttrListFiles
	Paths to the XRay attribute list files, specifying which objects (files, functions, variables) should be imbued with the appropriate XRay attribute(s).

std::vector< std::string >	ProfileListFiles
	Paths to special case list files specifying which entities (files, functions) should or should not be instrumented.

clang::ObjCRuntime	ObjCRuntime

CoreFoundationABI	CFRuntime = CoreFoundationABI::Unspecified

std::string	ObjCConstantStringClass

std::string	OverflowHandler
	The name of the handler function to be called when -ftrapv is specified.

std::string	ModuleName
	The module currently being compiled as specified by -fmodule-name.

std::string	CurrentModule
	The name of the current module, of which the main source file is a part.

std::vector< std::string >	ModuleFeatures
	The names of any features to enable in module 'requires' decls in addition to the hard-coded list in Module.cpp and the target features.

CommentOptions	CommentOpts
	Options for parsing comments.

std::vector< std::string >	NoBuiltinFuncs
	A list of all -fno-builtin-* function names (e.g., memset).

std::map< std::string, std::string, std::greater< std::string > >	MacroPrefixMap
	A prefix map for FILE, BASE_FILE and __builtin_FILE().

std::vector< llvm::Triple >	OMPTargetTriples
	Triples of the OpenMP targets that the host code codegen should take into account in order to generate accurate offloading descriptors.

std::string	OMPHostIRFile
	Name of the IR file that contains the result of the OpenMP target host code generation.

std::string	CUID
	The user provided compilation unit ID, if non-empty.

std::optional< TargetCXXABI::Kind >	CXXABI
	C++ ABI to compile with, if specified by the frontend through -fc++-abi=.

bool	IsHeaderFile = false
	Indicates whether the front-end is explicitly told that the input is a header file (i.e.

GPUDefaultStreamKind	GPUDefaultStream
	The default stream kind used for HIP kernel launching.

unsigned	OverflowPatternExclusionMask = 0
	Which overflow patterns should be excluded from sanitizer instrumentation.

std::vector< std::string >	OverflowPatternExclusionValues

std::string	RandstructSeed
	The seed used by the randomize structure layout feature.

bool	UseTargetPathSeparator = false
	Indicates whether to use target's platform-specific file separator when FILE macro is used and when concatenating filename with directory or to use build environment environment's platform-specific file separator.

bool	CheckNew = false

std::string	OpenACCMacroOverride

bool	NoWasmOpt = false

Additional Inherited Members
Public Types inherited from clang::LangOptionsBase
enum	GCMode { NonGC , GCOnly , HybridGC }

enum	StackProtectorMode { SSPOff , SSPOn , SSPStrong , SSPReq }

enum class	TrivialAutoVarInitKind { Uninitialized , Zero , Pattern }

enum	SignedOverflowBehaviorTy { SOB_Undefined , SOB_Defined , SOB_Trapping }

enum	CompilingModuleKind { CMK_None , CMK_ModuleMap , CMK_HeaderUnit , CMK_ModuleInterface }

enum	PragmaMSPointersToMembersKind { PPTMK_BestCase , PPTMK_FullGeneralitySingleInheritance , PPTMK_FullGeneralityMultipleInheritance , PPTMK_FullGeneralityVirtualInheritance }

enum	DefaultCallingConvention { DCC_None , DCC_CDecl , DCC_FastCall , DCC_StdCall , DCC_VectorCall , DCC_RegCall , DCC_RtdCall }

enum	AddrSpaceMapMangling { ASMM_Target , ASMM_On , ASMM_Off }

enum	MSVCMajorVersion { MSVC2010 = 1600 , MSVC2012 = 1700 , MSVC2013 = 1800 , MSVC2015 = 1900 , MSVC2017 = 1910 , MSVC2017_5 = 1912 , MSVC2017_7 = 1914 , MSVC2019 = 1920 , MSVC2019_5 = 1925 , MSVC2019_8 = 1928 , MSVC2022_3 = 1933 , MSVC2022_9 = 1939 }

enum	SYCLMajorVersion { SYCL_None , SYCL_2017 , SYCL_2020 , SYCL_Default = SYCL_2020 }

enum	HLSLLangStd { HLSL_Unset = 0 , HLSL_2015 = 2015 , HLSL_2016 = 2016 , HLSL_2017 = 2017 , HLSL_2018 = 2018 , HLSL_2021 = 2021 , HLSL_202x = 2028 , HLSL_202y = 2029 }

enum class	ClangABI { Ver3_8 , Ver4 , Ver6 , Ver7 , Ver9 , Ver11 , Ver12 , Ver14 , Ver15 , Ver17 , Ver18 , Ver19 , Latest }
	Clang versions with different platform ABI conformance. More...

enum class	CoreFoundationABI { Unspecified , Standalone , ObjectiveC , Swift , Swift5_0 , Swift4_2 , Swift4_1 }

enum	FPModeKind { FPM_Off , FPM_On , FPM_Fast , FPM_FastHonorPragmas }

enum	FPExceptionModeKind { FPE_Ignore , FPE_MayTrap , FPE_Strict , FPE_Default }
	Possible floating point exception behavior. More...

enum	FPEvalMethodKind { FEM_Indeterminable = -1 , FEM_Source = 0 , FEM_Double = 1 , FEM_Extended = 2 , FEM_UnsetOnCommandLine = 3 }
	Possible float expression evaluation method choices. More...

enum	ExcessPrecisionKind { FPP_Standard , FPP_Fast , FPP_None }

enum class	ExceptionHandlingKind { None , SjLj , WinEH , DwarfCFI , Wasm }
	Possible exception handling behavior. More...

enum class	LaxVectorConversionKind { None , Integer , All }

enum class	AltivecSrcCompatKind { Mixed , GCC , XL , Default = Mixed }

enum class	SignReturnAddressScopeKind { None , NonLeaf , All }

enum class	SignReturnAddressKeyKind { AKey , BKey }

enum class	ThreadModelKind { POSIX , Single }

enum class	ExtendArgsKind { ExtendTo32 , ExtendTo64 }

enum class	GPUDefaultStreamKind { Legacy , PerThread }

enum	OverflowPatternExclusionKind { None = 1 << 0 , All = 1 << 1 , AddSignedOverflowTest = 1 << 2 , AddUnsignedOverflowTest = 1 << 3 , NegUnsignedConst = 1 << 4 , PostDecrInWhile = 1 << 5 }
	Exclude certain code patterns from being instrumented by arithmetic overflow sanitizers. More...

enum class	DefaultVisiblityExportMapping { None , Explicit , All }

enum class	VisibilityForcedKinds { ForceHidden , ForceProtected , ForceDefault , Source }

enum class	VisibilityFromDLLStorageClassKinds { Keep , Default , Hidden , Protected }

enum class	StrictFlexArraysLevelKind { Default = 0 , OneZeroOrIncomplete = 1 , ZeroOrIncomplete = 2 , IncompleteOnly = 3 }

enum	ComplexRangeKind { CX_Full , CX_Improved , CX_Promoted , CX_Basic , CX_None }
	Controls the various implementations for complex multiplication and. More...

enum class	RegisterStaticDestructorsKind { All , ThreadLocal , None }
	Controls which variables have static destructors registered. More...

using	Visibility = clang::Visibility

using	RoundingMode = llvm::RoundingMode

using	CFBranchLabelSchemeKind = clang::CFBranchLabelSchemeKind

using	MSVtorDispMode = clang::MSVtorDispMode

Detailed Description

Keeps track of the various options that can be enabled, which controls the dialect of C or C++ that is accepted.

Definition at line 500 of file LangOptions.h.

Constructor & Destructor Documentation

◆ LangOptions()

LangOptions::LangOptions ( )

Definition at line 19 of file LangOptions.cpp.

Member Function Documentation

◆ allowsNonTrivialObjCLifetimeQualifiers()

bool clang::LangOptions::allowsNonTrivialObjCLifetimeQualifiers ( ) const

inline

True if any ObjC types may have non-trivial lifetime qualifiers.

Definition at line 694 of file LangOptions.h.

Referenced by clang::Sema::PerformImplicitConversion().

◆ assumeFunctionsAreConvergent()

bool clang::LangOptions::assumeFunctionsAreConvergent ( ) const

inline

Definition at line 698 of file LangOptions.h.

Referenced by getTrivialDefaultFunctionAttributes(), and UpdateAsmCallInst().

◆ getDefaultExceptionMode()

FPExceptionModeKind clang::LangOptions::getDefaultExceptionMode ( ) const

inline

Definition at line 817 of file LangOptions.h.

References clang::LangOptionsBase::FPE_Default, and clang::LangOptionsBase::FPE_Ignore.

Referenced by clang::Sema::AddKnownFunctionAttributes(), clang::targets::addVisualCDefines(), and getTrivialDefaultFunctionAttributes().

◆ getDefaultRoundingMode()

RoundingMode clang::LangOptions::getDefaultRoundingMode ( ) const

inline

Definition at line 812 of file LangOptions.h.

Referenced by clang::targets::addVisualCDefines().

◆ getOpenCLCompatibleVersion()

unsigned LangOptions::getOpenCLCompatibleVersion ( ) const

Return the OpenCL version that kernel language is compatible with.

Definition at line 63 of file LangOptions.cpp.

Referenced by clang::Sema::ActOnNumericConstant(), clang::TargetInfo::adjust(), clang::OpenCLOptions::areProgramScopeVariablesSupported(), builtinIsSupported(), CheckExtVectorComponent(), ConvertDeclSpecToType(), clang::Sema::CreateBuiltinUnaryOp(), FixupInvocation(), GetFullTypeForDeclarator(), getOpenCLKernelParameterType(), clang::SemaOpenCL::handleAccessAttr(), clang::Sema::Initialize(), clang::OpenCLOptions::OpenCLOptionInfo::isAvailableIn(), clang::CodeGen::CodeGenModule::Release(), setLangDefaults(), clang::DeclSpec::SetStorageClassSpec(), and clang::TargetInfo::validateOpenCLTarget().

◆ getOpenCLVersionString()

std::string LangOptions::getOpenCLVersionString ( ) const

Return the OpenCL C or C++ for OpenCL language name and version as a string.

Definition at line 79 of file LangOptions.cpp.

References getOpenCLVersionTuple(), and clang::Result.

Referenced by clang::Sema::ActOnVariableDeclarator(), FixupInvocation(), and clang::SemaOpenCL::handleNoSVMAttr().

◆ getOpenCLVersionTuple()

VersionTuple LangOptions::getOpenCLVersionTuple ( ) const

Return the OpenCL C or C++ version as a VersionTuple.

Definition at line 56 of file LangOptions.cpp.

Referenced by getOpenCLVersionString(), and clang::TargetInfo::validateOpenCLTarget().

◆ hasAtExit()

bool clang::LangOptions::hasAtExit ( ) const

inline

Returns true if the language supports calling the 'atexit' function.

Definition at line 733 of file LangOptions.h.

◆ hasDefaultGlobalAllocationFunctionVisibility()

bool clang::LangOptions::hasDefaultGlobalAllocationFunctionVisibility ( ) const

inline

Definition at line 794 of file LangOptions.h.

References clang::LangOptionsBase::ForceDefault.

◆ hasDefaultVisibilityExportMapping()

bool clang::LangOptions::hasDefaultVisibilityExportMapping ( ) const

inline

Definition at line 774 of file LangOptions.h.

References clang::LangOptionsBase::None.

Referenced by clang::CodeGen::CodeGenModule::shouldMapVisibilityToDLLExport().

◆ hasDWARFExceptions()

bool clang::LangOptions::hasDWARFExceptions ( ) const

inline

Definition at line 764 of file LangOptions.h.

References clang::LangOptionsBase::DwarfCFI.

Referenced by getCPersonality(), getCXXPersonality(), InitializePredefinedMacros(), and initTargetOptions().

◆ hasGlobalAllocationFunctionVisibility()

bool clang::LangOptions::hasGlobalAllocationFunctionVisibility ( ) const

inline

Definition at line 789 of file LangOptions.h.

References clang::LangOptionsBase::Source.

Referenced by clang::Sema::DeclareGlobalAllocationFunction().

◆ hasHiddenGlobalAllocationFunctionVisibility()

bool clang::LangOptions::hasHiddenGlobalAllocationFunctionVisibility ( ) const

inline

Definition at line 804 of file LangOptions.h.

References clang::LangOptionsBase::ForceHidden.

Referenced by clang::Sema::DeclareGlobalAllocationFunction().

◆ hasProtectedGlobalAllocationFunctionVisibility()

bool clang::LangOptions::hasProtectedGlobalAllocationFunctionVisibility ( ) const

inline

Definition at line 799 of file LangOptions.h.

References clang::LangOptionsBase::ForceProtected.

Referenced by clang::Sema::DeclareGlobalAllocationFunction().

◆ hasSEHExceptions()

bool clang::LangOptions::hasSEHExceptions ( ) const

inline

Definition at line 760 of file LangOptions.h.

References clang::LangOptionsBase::WinEH.

Referenced by getCPersonality(), getCXXPersonality(), getObjCPersonality(), InitializePredefinedMacros(), and initTargetOptions().

◆ hasSignReturnAddress()

bool clang::LangOptions::hasSignReturnAddress ( ) const

inline

Check if return address signing is enabled.

Definition at line 742 of file LangOptions.h.

References clang::LangOptionsBase::None.

Referenced by clang::targets::AArch64TargetInfo::getTargetDefines(), clang::targets::ARMTargetInfo::getTargetDefines(), and clang::CodeGen::CodeGenModule::Release().

◆ hasSjLjExceptions()

bool clang::LangOptions::hasSjLjExceptions ( ) const

inline

Definition at line 756 of file LangOptions.h.

References clang::LangOptionsBase::SjLj.

Referenced by getCPersonality(), getCXXPersonality(), getObjCPersonality(), InitializePredefinedMacros(), and initTargetOptions().

◆ hasWasmExceptions()

bool clang::LangOptions::hasWasmExceptions ( ) const

inline

Definition at line 768 of file LangOptions.h.

References clang::LangOptionsBase::Wasm.

Referenced by getCXXPersonality(), InitializePredefinedMacros(), and initTargetOptions().

◆ implicitFunctionsAllowed()

bool clang::LangOptions::implicitFunctionsAllowed ( ) const

inline

Returns true if implicit function declarations are allowed in the current language mode.

Definition at line 728 of file LangOptions.h.

References clang::OpenCL, and requiresStrictPrototypes().

Referenced by clang::Sema::ImplicitlyDefineFunction().

◆ isAllDefaultVisibilityExportMapping()

bool clang::LangOptions::isAllDefaultVisibilityExportMapping ( ) const

inline

Definition at line 784 of file LangOptions.h.

References clang::LangOptionsBase::All.

Referenced by clang::CodeGen::CodeGenModule::shouldMapVisibilityToDLLExport().

◆ isCompatibleWithMSVC()

bool clang::LangOptions::isCompatibleWithMSVC ( MSVCMajorVersion MajorVersion ) const

inline

Definition at line 673 of file LangOptions.h.

Referenced by clang::targets::addVisualCDefines(), clang::Sema::CheckFieldDecl(), CompareStandardConversionSequences(), clang::TextDiagnostic::emitDiagnosticLoc(), getKeywordStatus(), getMSManglingNumber(), handleMSConstexprAttr(), and clang::Sema::ShouldDeleteSpecialMember().

◆ isCompilingModule()

bool clang::LangOptions::isCompilingModule ( ) const

inline

Are we compiling a module?

Definition at line 650 of file LangOptions.h.

References clang::LangOptionsBase::CMK_None.

Referenced by clang::ModuleMap::diagnoseHeaderInclusion(), clang::PCHGenerator::getEmittingModule(), isCompilingModuleImplementation(), clang::Module::isForBuilding(), clang::ASTUnit::isModuleFile(), and trackLocalOwningModule().

◆ isCompilingModuleImplementation()

bool clang::LangOptions::isCompilingModuleImplementation ( ) const

inline

Are we compiling a module implementation?

Definition at line 655 of file LangOptions.h.

References isCompilingModule(), and ModuleName.

◆ isExplicitDefaultVisibilityExportMapping()

bool clang::LangOptions::isExplicitDefaultVisibilityExportMapping ( ) const

inline

Definition at line 779 of file LangOptions.h.

References clang::LangOptionsBase::Explicit.

Referenced by clang::CodeGen::CodeGenModule::shouldMapVisibilityToDLLExport().

◆ isImplicitIntAllowed()

bool clang::LangOptions::isImplicitIntAllowed ( ) const

inline

Returns true if implicit int is supported at all.

Definition at line 739 of file LangOptions.h.

References clang::C23, and clang::CPlusPlus.

Referenced by ConvertDeclSpecToType().

◆ isImplicitIntRequired()

bool clang::LangOptions::isImplicitIntRequired ( ) const

inline

Returns true if implicit int is part of the language requirements.

Definition at line 736 of file LangOptions.h.

References clang::C99, and clang::CPlusPlus.

Referenced by ConvertDeclSpecToType().

◆ isNoBuiltinFunc()

bool LangOptions::isNoBuiltinFunc ( StringRef Name ) const

Is this a libc/libm function that is no longer recognized as a builtin because a -fno-builtin-* option has been specified?

Definition at line 49 of file LangOptions.cpp.

References NoBuiltinFuncs.

Referenced by getTrivialDefaultFunctionAttributes().

◆ isOverflowPatternExcluded()

bool clang::LangOptions::isOverflowPatternExcluded ( OverflowPatternExclusionKind Kind ) const

inline

Definition at line 677 of file LangOptions.h.

References clang::LangOptionsBase::All, Kind, clang::LangOptionsBase::None, and OverflowPatternExclusionMask.

Referenced by computeOverflowPatternExclusion(), and matchesPostDecrInWhile().

◆ isSignedOverflowDefined()

bool clang::LangOptions::isSignedOverflowDefined ( ) const

inline

Definition at line 664 of file LangOptions.h.

References clang::LangOptionsBase::SOB_Defined.

Referenced by DiagnoseBadShiftValues(), emitPointerArithmetic(), and isTautologicalBoundsCheck().

◆ isSignReturnAddressScopeAll()

bool clang::LangOptions::isSignReturnAddressScopeAll ( ) const

inline

Check if leaf functions are also signed.

Definition at line 752 of file LangOptions.h.

References clang::LangOptionsBase::All.

Referenced by clang::targets::AArch64TargetInfo::getTargetDefines(), clang::targets::ARMTargetInfo::getTargetDefines(), and clang::CodeGen::CodeGenModule::Release().

◆ isSignReturnAddressWithAKey()

bool clang::LangOptions::isSignReturnAddressWithAKey ( ) const

inline

Check if return address signing uses AKey.

Definition at line 747 of file LangOptions.h.

References clang::LangOptionsBase::AKey.

Referenced by clang::targets::AArch64TargetInfo::getTargetDefines(), and clang::CodeGen::CodeGenModule::Release().

◆ isSubscriptPointerArithmetic()

bool clang::LangOptions::isSubscriptPointerArithmetic ( ) const

inline

Definition at line 668 of file LangOptions.h.

References clang::ObjCRuntime::isSubscriptPointerArithmetic().

Referenced by clang::Sema::CreateBuiltinArraySubscriptExpr().

◆ isSYCL()

bool clang::LangOptions::isSYCL ( ) const

inline

Definition at line 772 of file LangOptions.h.

Referenced by getKeywordStatusHelper().

◆ remapPathPrefix()

void LangOptions::remapPathPrefix ( SmallVectorImpl< char > & Path ) const

Remap path prefix according to -fmacro-prefix-path option.

Definition at line 73 of file LangOptions.cpp.

References MacroPrefixMap, and Path.

Referenced by clang::PredefinedExpr::ComputeName(), and clang::Preprocessor::processPathForFileMacro().

◆ requiresStrictPrototypes()

bool clang::LangOptions::requiresStrictPrototypes ( ) const

inline

Returns true if functions without prototypes or functions with an identifier list (aka K&R C functions) are not allowed.

Definition at line 722 of file LangOptions.h.

References clang::C23, and clang::CPlusPlus.

Referenced by CreateNewFunctionDecl(), GetFullTypeForDeclarator(), and implicitFunctionsAllowed().

◆ resetNonModularOptions()

void LangOptions::resetNonModularOptions ( )

Reset all of the options that are not considered when building a module.

Definition at line 25 of file LangOptions.cpp.

References CurrentModule, IsHeaderFile, NoSanitizeFiles, XRayAlwaysInstrumentFiles, and XRayNeverInstrumentFiles.

Referenced by clang::CompilerInvocation::resetNonModularOptions().

◆ setLangDefaults()

void LangOptions::setLangDefaults	(	LangOptions &	Opts,
		Language	Lang,
		const llvm::Triple &	T,
		std::vector< std::string > &	Includes,
		LangStandard::Kind	LangStd = `LangStandard::lang_unspecified`
	)

static

Set language defaults for the given input language and language standard in the given LangOptions object.

Parameters

Opts	- The LangOptions object to set up.
Lang	- The input language.
T	- The target triple.
Includes	- If the language requires extra headers to be implicitly included, they will be appended to this list.
LangStd	- The input language standard.

Definition at line 89 of file LangOptions.cpp.

◆ threadPrivateMemoryAtomicsAreUndefined()

bool clang::LangOptions::threadPrivateMemoryAtomicsAreUndefined ( ) const

inline

Return true if atomicrmw operations targeting allocations in private memory are undefined.

Definition at line 704 of file LangOptions.h.

References clang::CUDA, and clang::OpenCL.

◆ trackLocalOwningModule()

bool clang::LangOptions::trackLocalOwningModule ( ) const

inline

Do we need to track the owning module for a local declaration?

Definition at line 660 of file LangOptions.h.

References isCompilingModule().

Referenced by clang::Decl::hasLocalOwningModuleStorage(), and clang::Decl::operator new().

Member Data Documentation

◆ CFRuntime

CoreFoundationABI clang::LangOptions::CFRuntime = CoreFoundationABI::Unspecified

Definition at line 537 of file LangOptions.h.

Referenced by clang::CodeGen::CodeGenModule::GetAddrOfConstantCFString(), and clang::ASTContext::getCFConstantStringDecl().

◆ CheckNew

bool clang::LangOptions::CheckNew = false

Definition at line 615 of file LangOptions.h.

◆ CommentOpts

CommentOptions clang::LangOptions::CommentOpts

Options for parsing comments.

Definition at line 564 of file LangOptions.h.

Referenced by clang::Sema::ActOnComment(), clang::ASTContext::addComment(), clang::ASTContext::cacheRawCommentForDecl(), checkLanguageOptions(), and clang::ASTContext::getRawCommentForDeclNoCacheImpl().

◆ CUID

std::string clang::LangOptions::CUID

The user provided compilation unit ID, if non-empty.

This is used to externalize static variables which is needed to support accessing static device variables in host code for single source offloading languages like CUDA/HIP.

Definition at line 584 of file LangOptions.h.

Referenced by clang::ASTContext::getCUIDHash(), and clang::CodeGen::CodeGenModule::printPostfixForExternalizedDecl().

◆ CurrentModule

std::string clang::LangOptions::CurrentModule

The name of the current module, of which the main source file is a part.

If CompilingModule is set, we are compiling the interface of this module, otherwise we are compiling an implementation file of it. This starts as ModuleName in case -fmodule-name is provided and changes during compilation to reflect the current module.

Definition at line 555 of file LangOptions.h.

Referenced by clang::Sema::ActOnModuleDecl(), clang::Sema::ActOnModuleImport(), clang::FrontendAction::BeginSourceFile(), clang::ModuleMap::createHeaderUnit(), clang::ModuleMap::createModule(), clang::ModuleMap::createModuleForImplementationUnit(), clang::ModuleMap::createModuleForInterfaceUnit(), clang::DumpModuleInfoAction::ExecuteAction(), FixupInvocation(), clang::FrontendAction::getCurrentModule(), clang::PCHGenerator::getEmittingModule(), clang::Preprocessor::getModuleForLocation(), clang::Module::isForBuilding(), prepareToBuildModule(), and resetNonModularOptions().

◆ CXXABI

std::optional<TargetCXXABI::Kind> clang::LangOptions::CXXABI

C++ ABI to compile with, if specified by the frontend through -fc++-abi=.

This overrides the default ABI used by the target.

Definition at line 588 of file LangOptions.h.

Referenced by clang::ASTContext::getCXXABIKind().

◆ GPUDefaultStream

GPUDefaultStreamKind clang::LangOptions::GPUDefaultStream

The default stream kind used for HIP kernel launching.

Definition at line 595 of file LangOptions.h.

Referenced by InitializeStandardPredefinedMacros().

◆ IsHeaderFile

bool clang::LangOptions::IsHeaderFile = false

Indicates whether the front-end is explicitly told that the input is a header file (i.e.

-x c-header).

Definition at line 592 of file LangOptions.h.

Referenced by clang::Sema::ActOnEndOfTranslationUnit(), isMainFileLoc(), and resetNonModularOptions().

◆ LangStd

LangStandard::Kind clang::LangOptions::LangStd

The used language standard.

Definition at line 503 of file LangOptions.h.

Referenced by clang::CodeGen::CodeGenModule::Release(), and setLangDefaults().

◆ MacroPrefixMap

std::map<std::string, std::string, std::greater<std::string> > clang::LangOptions::MacroPrefixMap

A prefix map for FILE, BASE_FILE and __builtin_FILE().

Definition at line 570 of file LangOptions.h.

Referenced by clang::CodeGen::CodeGenModule::CodeGenModule(), and remapPathPrefix().

◆ ModuleFeatures

std::vector<std::string> clang::LangOptions::ModuleFeatures

The names of any features to enable in module 'requires' decls in addition to the hard-coded list in Module.cpp and the target features.

This list is sorted.

Definition at line 561 of file LangOptions.h.

Referenced by checkLanguageOptions(), and hasFeature().

◆ ModuleName

std::string clang::LangOptions::ModuleName

The module currently being compiled as specified by -fmodule-name.

Definition at line 548 of file LangOptions.h.

Referenced by clang::FrontendAction::BeginSourceFile(), FixupInvocation(), isCompilingModuleImplementation(), clang::Module::isForBuilding(), loadModuleMapForModuleBuild(), and makeCommonInvocationForModuleBuild().

◆ NoBuiltinFuncs

std::vector<std::string> clang::LangOptions::NoBuiltinFuncs

A list of all -fno-builtin-* function names (e.g., memset).

Definition at line 567 of file LangOptions.h.

Referenced by addNoBuiltinAttributes(), clang::Builtin::Context::initializeBuiltins(), and isNoBuiltinFunc().

◆ NoSanitizeFiles

std::vector<std::string> clang::LangOptions::NoSanitizeFiles

Paths to files specifying which objects (files, functions, variables) should not be instrumented.

Definition at line 512 of file LangOptions.h.

Referenced by addSanitizers(), and resetNonModularOptions().

◆ NoWasmOpt

bool clang::LangOptions::NoWasmOpt = false

Definition at line 624 of file LangOptions.h.

◆ ObjCConstantStringClass

std::string clang::LangOptions::ObjCConstantStringClass

Definition at line 539 of file LangOptions.h.

◆ ObjCRuntime

◆ OMPHostIRFile

std::string clang::LangOptions::OMPHostIRFile

Name of the IR file that contains the result of the OpenMP target host code generation.

Definition at line 578 of file LangOptions.h.

Referenced by clang::CodeGen::CGOpenMPRuntime::CGOpenMPRuntime(), and clang::CodeGen::CGOpenMPRuntimeGPU::CGOpenMPRuntimeGPU().

◆ OMPTargetTriples

std::vector<llvm::Triple> clang::LangOptions::OMPTargetTriples

Triples of the OpenMP targets that the host code codegen should take into account in order to generate accurate offloading descriptors.

Definition at line 574 of file LangOptions.h.

Referenced by clang::Sema::ActOnFinishFunctionBody(), clang::Sema::AddInitializerToDecl(), emitCommonOMPTargetDirective(), clang::CodeGen::CGOpenMPRuntime::getAddrOfDeclareTargetVar(), and clang::CodeGen::CGOpenMPRuntime::registerTargetGlobalVariable().

◆ OpenACCMacroOverride

std::string clang::LangOptions::OpenACCMacroOverride

Definition at line 620 of file LangOptions.h.

Referenced by InitializeStandardPredefinedMacros().

◆ OverflowHandler

std::string clang::LangOptions::OverflowHandler

The name of the handler function to be called when -ftrapv is specified.

If none is specified, abort (GCC-compatible behaviour).

Definition at line 545 of file LangOptions.h.

◆ OverflowPatternExclusionMask

unsigned clang::LangOptions::OverflowPatternExclusionMask = 0

Which overflow patterns should be excluded from sanitizer instrumentation.

Definition at line 598 of file LangOptions.h.

Referenced by isOverflowPatternExcluded().

◆ OverflowPatternExclusionValues

std::vector<std::string> clang::LangOptions::OverflowPatternExclusionValues

Definition at line 600 of file LangOptions.h.

◆ ProfileListFiles

std::vector<std::string> clang::LangOptions::ProfileListFiles

Paths to special case list files specifying which entities (files, functions) should or should not be instrumented.

Definition at line 533 of file LangOptions.h.

◆ RandstructSeed

std::string clang::LangOptions::RandstructSeed

The seed used by the randomize structure layout feature.

Definition at line 603 of file LangOptions.h.

Referenced by clang::randstruct::randomizeStructureLayout().

◆ Sanitize

SanitizerSet clang::LangOptions::Sanitize

Set of enabled sanitizers.

Definition at line 506 of file LangOptions.h.

Referenced by addKCFIPass(), addSanitizers(), checkLanguageOptions(), clang::CodeGen::CodeGenModule::CodeGenModule(), clang::CodeGen::CodeGenModule::CreateFunctionTypeMetadataForIcall(), clang::targets::getAppleMachODefines(), clang::CompilerInvocation::getModuleHash(), clang::CodeGen::CodeGenTBAA::getTypeInfo(), clang::RecordDecl::mayInsertExtraPadding(), clang::CodeGen::CodeGenModule::NeedAllVtablesTypeId(), clang::CodeGen::CodeGenModule::Release(), clang::CodeGen::CodeGenVTables::RemoveHwasanMetadata(), clang::CodeGen::SanitizerMetadata::reportGlobal(), and shouldEmitLifetimeMarkers().

◆ SanitizeCoverage

bool clang::LangOptions::SanitizeCoverage = false

Is at least one coverage instrumentation type enabled.

Definition at line 508 of file LangOptions.h.

Referenced by FixupInvocation().

◆ UseTargetPathSeparator

bool clang::LangOptions::UseTargetPathSeparator = false

Indicates whether to use target's platform-specific file separator when FILE macro is used and when concatenating filename with directory or to use build environment environment's platform-specific file separator.

The plaform-specific path separator is the backslash() for Windows and forward slash (/) elsewhere.

Definition at line 611 of file LangOptions.h.

Referenced by clang::Preprocessor::processPathForFileMacro().

◆ XRayAlwaysInstrumentFiles

std::vector<std::string> clang::LangOptions::XRayAlwaysInstrumentFiles

Paths to the XRay "always instrument" files specifying which objects (files, functions, variables) should be imbued with the XRay "always instrument" attribute.

WARNING: This is a deprecated field and will go away in the future.

Definition at line 518 of file LangOptions.h.

Referenced by resetNonModularOptions().

◆ XRayAttrListFiles

std::vector<std::string> clang::LangOptions::XRayAttrListFiles

Paths to the XRay attribute list files, specifying which objects (files, functions, variables) should be imbued with the appropriate XRay attribute(s).

Definition at line 529 of file LangOptions.h.

◆ XRayNeverInstrumentFiles

std::vector<std::string> clang::LangOptions::XRayNeverInstrumentFiles

Paths to the XRay "never instrument" files specifying which objects (files, functions, variables) should be imbued with the XRay "never instrument" attribute.

WARNING: This is a deprecated field and will go away in the future.

Definition at line 524 of file LangOptions.h.

Referenced by resetNonModularOptions().

The documentation for this class was generated from the following files:

include/clang/Basic/LangOptions.h
lib/Basic/LangOptions.cpp

Public Member Functions

Static Public Member Functions

Public Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ LangOptions()

Member Function Documentation

◆ allowsNonTrivialObjCLifetimeQualifiers()

◆ assumeFunctionsAreConvergent()

◆ getDefaultExceptionMode()

◆ getDefaultRoundingMode()

◆ getOpenCLCompatibleVersion()

◆ getOpenCLVersionString()

◆ getOpenCLVersionTuple()

◆ hasAtExit()

◆ hasDefaultGlobalAllocationFunctionVisibility()

◆ hasDefaultVisibilityExportMapping()

◆ hasDWARFExceptions()

◆ hasGlobalAllocationFunctionVisibility()

◆ hasHiddenGlobalAllocationFunctionVisibility()

◆ hasProtectedGlobalAllocationFunctionVisibility()

◆ hasSEHExceptions()

◆ hasSignReturnAddress()

◆ hasSjLjExceptions()

◆ hasWasmExceptions()

◆ implicitFunctionsAllowed()

◆ isAllDefaultVisibilityExportMapping()

◆ isCompatibleWithMSVC()

◆ isCompilingModule()

◆ isCompilingModuleImplementation()

◆ isExplicitDefaultVisibilityExportMapping()

◆ isImplicitIntAllowed()

◆ isImplicitIntRequired()

◆ isNoBuiltinFunc()

◆ isOverflowPatternExcluded()

◆ isSignedOverflowDefined()

◆ isSignReturnAddressScopeAll()

◆ isSignReturnAddressWithAKey()

◆ isSubscriptPointerArithmetic()

◆ isSYCL()

◆ remapPathPrefix()

◆ requiresStrictPrototypes()

◆ resetNonModularOptions()

◆ setLangDefaults()

◆ threadPrivateMemoryAtomicsAreUndefined()

◆ trackLocalOwningModule()

Member Data Documentation

◆ CFRuntime

◆ CheckNew

◆ CommentOpts

◆ CUID

◆ CurrentModule

◆ CXXABI

◆ GPUDefaultStream

◆ IsHeaderFile

◆ LangStd

◆ MacroPrefixMap

◆ ModuleFeatures

◆ ModuleName

◆ NoBuiltinFuncs

◆ NoSanitizeFiles

◆ NoWasmOpt

◆ ObjCConstantStringClass

◆ ObjCRuntime

◆ OMPHostIRFile

◆ OMPTargetTriples

◆ OpenACCMacroOverride

◆ OverflowHandler

◆ OverflowPatternExclusionMask

◆ OverflowPatternExclusionValues

◆ ProfileListFiles

◆ RandstructSeed

◆ Sanitize

◆ SanitizeCoverage

◆ UseTargetPathSeparator

◆ XRayAlwaysInstrumentFiles

◆ XRayAttrListFiles

◆ XRayNeverInstrumentFiles