xref: /llvm-project/clang/lib/Frontend/InitPreprocessor.cpp (revision f05b58a9468cc2990678e06bc51df56b30344807)
1 //===--- InitPreprocessor.cpp - PP initialization code. ---------*- C++ -*-===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 //
9 // This file implements the clang::InitializePreprocessor function.
10 //
11 //===----------------------------------------------------------------------===//
12 
13 #include "clang/Basic/FileManager.h"
14 #include "clang/Basic/HLSLRuntime.h"
15 #include "clang/Basic/MacroBuilder.h"
16 #include "clang/Basic/SourceManager.h"
17 #include "clang/Basic/SyncScope.h"
18 #include "clang/Basic/TargetInfo.h"
19 #include "clang/Basic/Version.h"
20 #include "clang/Frontend/FrontendDiagnostic.h"
21 #include "clang/Frontend/FrontendOptions.h"
22 #include "clang/Frontend/Utils.h"
23 #include "clang/Lex/HeaderSearch.h"
24 #include "clang/Lex/Preprocessor.h"
25 #include "clang/Lex/PreprocessorOptions.h"
26 #include "clang/Serialization/ASTReader.h"
27 #include "llvm/ADT/APFloat.h"
28 #include "llvm/IR/DataLayout.h"
29 #include "llvm/IR/DerivedTypes.h"
30 using namespace clang;
31 
32 static bool MacroBodyEndsInBackslash(StringRef MacroBody) {
33   while (!MacroBody.empty() && isWhitespace(MacroBody.back()))
34     MacroBody = MacroBody.drop_back();
35   return !MacroBody.empty() && MacroBody.back() == '\\';
36 }
37 
38 // Append a #define line to Buf for Macro.  Macro should be of the form XXX,
39 // in which case we emit "#define XXX 1" or "XXX=Y z W" in which case we emit
40 // "#define XXX Y z W".  To get a #define with no value, use "XXX=".
41 static void DefineBuiltinMacro(MacroBuilder &Builder, StringRef Macro,
42                                DiagnosticsEngine &Diags) {
43   std::pair<StringRef, StringRef> MacroPair = Macro.split('=');
44   StringRef MacroName = MacroPair.first;
45   StringRef MacroBody = MacroPair.second;
46   if (MacroName.size() != Macro.size()) {
47     // Per GCC -D semantics, the macro ends at \n if it exists.
48     StringRef::size_type End = MacroBody.find_first_of("\n\r");
49     if (End != StringRef::npos)
50       Diags.Report(diag::warn_fe_macro_contains_embedded_newline)
51         << MacroName;
52     MacroBody = MacroBody.substr(0, End);
53     // We handle macro bodies which end in a backslash by appending an extra
54     // backslash+newline.  This makes sure we don't accidentally treat the
55     // backslash as a line continuation marker.
56     if (MacroBodyEndsInBackslash(MacroBody))
57       Builder.defineMacro(MacroName, Twine(MacroBody) + "\\\n");
58     else
59       Builder.defineMacro(MacroName, MacroBody);
60   } else {
61     // Push "macroname 1".
62     Builder.defineMacro(Macro);
63   }
64 }
65 
66 /// AddImplicitInclude - Add an implicit \#include of the specified file to the
67 /// predefines buffer.
68 /// As these includes are generated by -include arguments the header search
69 /// logic is going to search relatively to the current working directory.
70 static void AddImplicitInclude(MacroBuilder &Builder, StringRef File) {
71   Builder.append(Twine("#include \"") + File + "\"");
72 }
73 
74 static void AddImplicitIncludeMacros(MacroBuilder &Builder, StringRef File) {
75   Builder.append(Twine("#__include_macros \"") + File + "\"");
76   // Marker token to stop the __include_macros fetch loop.
77   Builder.append("##"); // ##?
78 }
79 
80 /// Add an implicit \#include using the original file used to generate
81 /// a PCH file.
82 static void AddImplicitIncludePCH(MacroBuilder &Builder, Preprocessor &PP,
83                                   const PCHContainerReader &PCHContainerRdr,
84                                   StringRef ImplicitIncludePCH) {
85   std::string OriginalFile = ASTReader::getOriginalSourceFile(
86       std::string(ImplicitIncludePCH), PP.getFileManager(), PCHContainerRdr,
87       PP.getDiagnostics());
88   if (OriginalFile.empty())
89     return;
90 
91   AddImplicitInclude(Builder, OriginalFile);
92 }
93 
94 /// PickFP - This is used to pick a value based on the FP semantics of the
95 /// specified FP model.
96 template <typename T>
97 static T PickFP(const llvm::fltSemantics *Sem, T IEEEHalfVal, T IEEESingleVal,
98                 T IEEEDoubleVal, T X87DoubleExtendedVal, T PPCDoubleDoubleVal,
99                 T IEEEQuadVal) {
100   if (Sem == (const llvm::fltSemantics*)&llvm::APFloat::IEEEhalf())
101     return IEEEHalfVal;
102   if (Sem == (const llvm::fltSemantics*)&llvm::APFloat::IEEEsingle())
103     return IEEESingleVal;
104   if (Sem == (const llvm::fltSemantics*)&llvm::APFloat::IEEEdouble())
105     return IEEEDoubleVal;
106   if (Sem == (const llvm::fltSemantics*)&llvm::APFloat::x87DoubleExtended())
107     return X87DoubleExtendedVal;
108   if (Sem == (const llvm::fltSemantics*)&llvm::APFloat::PPCDoubleDouble())
109     return PPCDoubleDoubleVal;
110   assert(Sem == (const llvm::fltSemantics*)&llvm::APFloat::IEEEquad());
111   return IEEEQuadVal;
112 }
113 
114 static void DefineFloatMacros(MacroBuilder &Builder, StringRef Prefix,
115                               const llvm::fltSemantics *Sem, StringRef Ext) {
116   const char *DenormMin, *Epsilon, *Max, *Min;
117   DenormMin = PickFP(Sem, "5.9604644775390625e-8", "1.40129846e-45",
118                      "4.9406564584124654e-324", "3.64519953188247460253e-4951",
119                      "4.94065645841246544176568792868221e-324",
120                      "6.47517511943802511092443895822764655e-4966");
121   int Digits = PickFP(Sem, 3, 6, 15, 18, 31, 33);
122   int DecimalDigits = PickFP(Sem, 5, 9, 17, 21, 33, 36);
123   Epsilon = PickFP(Sem, "9.765625e-4", "1.19209290e-7",
124                    "2.2204460492503131e-16", "1.08420217248550443401e-19",
125                    "4.94065645841246544176568792868221e-324",
126                    "1.92592994438723585305597794258492732e-34");
127   int MantissaDigits = PickFP(Sem, 11, 24, 53, 64, 106, 113);
128   int Min10Exp = PickFP(Sem, -4, -37, -307, -4931, -291, -4931);
129   int Max10Exp = PickFP(Sem, 4, 38, 308, 4932, 308, 4932);
130   int MinExp = PickFP(Sem, -13, -125, -1021, -16381, -968, -16381);
131   int MaxExp = PickFP(Sem, 16, 128, 1024, 16384, 1024, 16384);
132   Min = PickFP(Sem, "6.103515625e-5", "1.17549435e-38", "2.2250738585072014e-308",
133                "3.36210314311209350626e-4932",
134                "2.00416836000897277799610805135016e-292",
135                "3.36210314311209350626267781732175260e-4932");
136   Max = PickFP(Sem, "6.5504e+4", "3.40282347e+38", "1.7976931348623157e+308",
137                "1.18973149535723176502e+4932",
138                "1.79769313486231580793728971405301e+308",
139                "1.18973149535723176508575932662800702e+4932");
140 
141   SmallString<32> DefPrefix;
142   DefPrefix = "__";
143   DefPrefix += Prefix;
144   DefPrefix += "_";
145 
146   Builder.defineMacro(DefPrefix + "DENORM_MIN__", Twine(DenormMin)+Ext);
147   Builder.defineMacro(DefPrefix + "HAS_DENORM__");
148   Builder.defineMacro(DefPrefix + "DIG__", Twine(Digits));
149   Builder.defineMacro(DefPrefix + "DECIMAL_DIG__", Twine(DecimalDigits));
150   Builder.defineMacro(DefPrefix + "EPSILON__", Twine(Epsilon)+Ext);
151   Builder.defineMacro(DefPrefix + "HAS_INFINITY__");
152   Builder.defineMacro(DefPrefix + "HAS_QUIET_NAN__");
153   Builder.defineMacro(DefPrefix + "MANT_DIG__", Twine(MantissaDigits));
154 
155   Builder.defineMacro(DefPrefix + "MAX_10_EXP__", Twine(Max10Exp));
156   Builder.defineMacro(DefPrefix + "MAX_EXP__", Twine(MaxExp));
157   Builder.defineMacro(DefPrefix + "MAX__", Twine(Max)+Ext);
158 
159   Builder.defineMacro(DefPrefix + "MIN_10_EXP__","("+Twine(Min10Exp)+")");
160   Builder.defineMacro(DefPrefix + "MIN_EXP__", "("+Twine(MinExp)+")");
161   Builder.defineMacro(DefPrefix + "MIN__", Twine(Min)+Ext);
162 }
163 
164 
165 /// DefineTypeSize - Emit a macro to the predefines buffer that declares a macro
166 /// named MacroName with the max value for a type with width 'TypeWidth' a
167 /// signedness of 'isSigned' and with a value suffix of 'ValSuffix' (e.g. LL).
168 static void DefineTypeSize(const Twine &MacroName, unsigned TypeWidth,
169                            StringRef ValSuffix, bool isSigned,
170                            MacroBuilder &Builder) {
171   llvm::APInt MaxVal = isSigned ? llvm::APInt::getSignedMaxValue(TypeWidth)
172                                 : llvm::APInt::getMaxValue(TypeWidth);
173   Builder.defineMacro(MacroName, toString(MaxVal, 10, isSigned) + ValSuffix);
174 }
175 
176 /// DefineTypeSize - An overloaded helper that uses TargetInfo to determine
177 /// the width, suffix, and signedness of the given type
178 static void DefineTypeSize(const Twine &MacroName, TargetInfo::IntType Ty,
179                            const TargetInfo &TI, MacroBuilder &Builder) {
180   DefineTypeSize(MacroName, TI.getTypeWidth(Ty), TI.getTypeConstantSuffix(Ty),
181                  TI.isTypeSigned(Ty), Builder);
182 }
183 
184 static void DefineFmt(const Twine &Prefix, TargetInfo::IntType Ty,
185                       const TargetInfo &TI, MacroBuilder &Builder) {
186   bool IsSigned = TI.isTypeSigned(Ty);
187   StringRef FmtModifier = TI.getTypeFormatModifier(Ty);
188   for (const char *Fmt = IsSigned ? "di" : "ouxX"; *Fmt; ++Fmt) {
189     Builder.defineMacro(Prefix + "_FMT" + Twine(*Fmt) + "__",
190                         Twine("\"") + FmtModifier + Twine(*Fmt) + "\"");
191   }
192 }
193 
194 static void DefineType(const Twine &MacroName, TargetInfo::IntType Ty,
195                        MacroBuilder &Builder) {
196   Builder.defineMacro(MacroName, TargetInfo::getTypeName(Ty));
197 }
198 
199 static void DefineTypeWidth(const Twine &MacroName, TargetInfo::IntType Ty,
200                             const TargetInfo &TI, MacroBuilder &Builder) {
201   Builder.defineMacro(MacroName, Twine(TI.getTypeWidth(Ty)));
202 }
203 
204 static void DefineTypeSizeof(StringRef MacroName, unsigned BitWidth,
205                              const TargetInfo &TI, MacroBuilder &Builder) {
206   Builder.defineMacro(MacroName,
207                       Twine(BitWidth / TI.getCharWidth()));
208 }
209 
210 // This will generate a macro based on the prefix with `_MAX__` as the suffix
211 // for the max value representable for the type, and a macro with a `_WIDTH__`
212 // suffix for the width of the type.
213 static void DefineTypeSizeAndWidth(const Twine &Prefix, TargetInfo::IntType Ty,
214                                    const TargetInfo &TI,
215                                    MacroBuilder &Builder) {
216   DefineTypeSize(Prefix + "_MAX__", Ty, TI, Builder);
217   DefineTypeWidth(Prefix + "_WIDTH__", Ty, TI, Builder);
218 }
219 
220 static void DefineExactWidthIntType(TargetInfo::IntType Ty,
221                                     const TargetInfo &TI,
222                                     MacroBuilder &Builder) {
223   int TypeWidth = TI.getTypeWidth(Ty);
224   bool IsSigned = TI.isTypeSigned(Ty);
225 
226   // Use the target specified int64 type, when appropriate, so that [u]int64_t
227   // ends up being defined in terms of the correct type.
228   if (TypeWidth == 64)
229     Ty = IsSigned ? TI.getInt64Type() : TI.getUInt64Type();
230 
231   // Use the target specified int16 type when appropriate. Some MCU targets
232   // (such as AVR) have definition of [u]int16_t to [un]signed int.
233   if (TypeWidth == 16)
234     Ty = IsSigned ? TI.getInt16Type() : TI.getUInt16Type();
235 
236   const char *Prefix = IsSigned ? "__INT" : "__UINT";
237 
238   DefineType(Prefix + Twine(TypeWidth) + "_TYPE__", Ty, Builder);
239   DefineFmt(Prefix + Twine(TypeWidth), Ty, TI, Builder);
240 
241   StringRef ConstSuffix(TI.getTypeConstantSuffix(Ty));
242   Builder.defineMacro(Prefix + Twine(TypeWidth) + "_C_SUFFIX__", ConstSuffix);
243 }
244 
245 static void DefineExactWidthIntTypeSize(TargetInfo::IntType Ty,
246                                         const TargetInfo &TI,
247                                         MacroBuilder &Builder) {
248   int TypeWidth = TI.getTypeWidth(Ty);
249   bool IsSigned = TI.isTypeSigned(Ty);
250 
251   // Use the target specified int64 type, when appropriate, so that [u]int64_t
252   // ends up being defined in terms of the correct type.
253   if (TypeWidth == 64)
254     Ty = IsSigned ? TI.getInt64Type() : TI.getUInt64Type();
255 
256   // We don't need to define a _WIDTH macro for the exact-width types because
257   // we already know the width.
258   const char *Prefix = IsSigned ? "__INT" : "__UINT";
259   DefineTypeSize(Prefix + Twine(TypeWidth) + "_MAX__", Ty, TI, Builder);
260 }
261 
262 static void DefineLeastWidthIntType(unsigned TypeWidth, bool IsSigned,
263                                     const TargetInfo &TI,
264                                     MacroBuilder &Builder) {
265   TargetInfo::IntType Ty = TI.getLeastIntTypeByWidth(TypeWidth, IsSigned);
266   if (Ty == TargetInfo::NoInt)
267     return;
268 
269   const char *Prefix = IsSigned ? "__INT_LEAST" : "__UINT_LEAST";
270   DefineType(Prefix + Twine(TypeWidth) + "_TYPE__", Ty, Builder);
271   // We only want the *_WIDTH macro for the signed types to avoid too many
272   // predefined macros (the unsigned width and the signed width are identical.)
273   if (IsSigned)
274     DefineTypeSizeAndWidth(Prefix + Twine(TypeWidth), Ty, TI, Builder);
275   else
276     DefineTypeSize(Prefix + Twine(TypeWidth) + "_MAX__", Ty, TI, Builder);
277   DefineFmt(Prefix + Twine(TypeWidth), Ty, TI, Builder);
278 }
279 
280 static void DefineFastIntType(unsigned TypeWidth, bool IsSigned,
281                               const TargetInfo &TI, MacroBuilder &Builder) {
282   // stdint.h currently defines the fast int types as equivalent to the least
283   // types.
284   TargetInfo::IntType Ty = TI.getLeastIntTypeByWidth(TypeWidth, IsSigned);
285   if (Ty == TargetInfo::NoInt)
286     return;
287 
288   const char *Prefix = IsSigned ? "__INT_FAST" : "__UINT_FAST";
289   DefineType(Prefix + Twine(TypeWidth) + "_TYPE__", Ty, Builder);
290   // We only want the *_WIDTH macro for the signed types to avoid too many
291   // predefined macros (the unsigned width and the signed width are identical.)
292   if (IsSigned)
293     DefineTypeSizeAndWidth(Prefix + Twine(TypeWidth), Ty, TI, Builder);
294   else
295     DefineTypeSize(Prefix + Twine(TypeWidth) + "_MAX__", Ty, TI, Builder);
296   DefineFmt(Prefix + Twine(TypeWidth), Ty, TI, Builder);
297 }
298 
299 
300 /// Get the value the ATOMIC_*_LOCK_FREE macro should have for a type with
301 /// the specified properties.
302 static const char *getLockFreeValue(unsigned TypeWidth, const TargetInfo &TI) {
303   // Fully-aligned, power-of-2 sizes no larger than the inline
304   // width will be inlined as lock-free operations.
305   // Note: we do not need to check alignment since _Atomic(T) is always
306   // appropriately-aligned in clang.
307   if (TI.hasBuiltinAtomic(TypeWidth, TypeWidth))
308     return "2"; // "always lock free"
309   // We cannot be certain what operations the lib calls might be
310   // able to implement as lock-free on future processors.
311   return "1"; // "sometimes lock free"
312 }
313 
314 /// Add definitions required for a smooth interaction between
315 /// Objective-C++ automated reference counting and libstdc++ (4.2).
316 static void AddObjCXXARCLibstdcxxDefines(const LangOptions &LangOpts,
317                                          MacroBuilder &Builder) {
318   Builder.defineMacro("_GLIBCXX_PREDEFINED_OBJC_ARC_IS_SCALAR");
319 
320   std::string Result;
321   {
322     // Provide specializations for the __is_scalar type trait so that
323     // lifetime-qualified objects are not considered "scalar" types, which
324     // libstdc++ uses as an indicator of the presence of trivial copy, assign,
325     // default-construct, and destruct semantics (none of which hold for
326     // lifetime-qualified objects in ARC).
327     llvm::raw_string_ostream Out(Result);
328 
329     Out << "namespace std {\n"
330         << "\n"
331         << "struct __true_type;\n"
332         << "struct __false_type;\n"
333         << "\n";
334 
335     Out << "template<typename _Tp> struct __is_scalar;\n"
336         << "\n";
337 
338     if (LangOpts.ObjCAutoRefCount) {
339       Out << "template<typename _Tp>\n"
340           << "struct __is_scalar<__attribute__((objc_ownership(strong))) _Tp> {\n"
341           << "  enum { __value = 0 };\n"
342           << "  typedef __false_type __type;\n"
343           << "};\n"
344           << "\n";
345     }
346 
347     if (LangOpts.ObjCWeak) {
348       Out << "template<typename _Tp>\n"
349           << "struct __is_scalar<__attribute__((objc_ownership(weak))) _Tp> {\n"
350           << "  enum { __value = 0 };\n"
351           << "  typedef __false_type __type;\n"
352           << "};\n"
353           << "\n";
354     }
355 
356     if (LangOpts.ObjCAutoRefCount) {
357       Out << "template<typename _Tp>\n"
358           << "struct __is_scalar<__attribute__((objc_ownership(autoreleasing)))"
359           << " _Tp> {\n"
360           << "  enum { __value = 0 };\n"
361           << "  typedef __false_type __type;\n"
362           << "};\n"
363           << "\n";
364     }
365 
366     Out << "}\n";
367   }
368   Builder.append(Result);
369 }
370 
371 static void InitializeStandardPredefinedMacros(const TargetInfo &TI,
372                                                const LangOptions &LangOpts,
373                                                const FrontendOptions &FEOpts,
374                                                MacroBuilder &Builder) {
375   if (LangOpts.HLSL) {
376     Builder.defineMacro("__hlsl_clang");
377     // HLSL Version
378     Builder.defineMacro("__HLSL_VERSION",
379                         Twine((unsigned)LangOpts.getHLSLVersion()));
380 
381     if (LangOpts.NativeHalfType)
382       Builder.defineMacro("__HLSL_ENABLE_16_BIT",
383                           Twine((unsigned)LangOpts.getHLSLVersion()));
384 
385     // Shader target information
386     // "enums" for shader stages
387     Builder.defineMacro("__SHADER_STAGE_VERTEX",
388                         Twine((uint32_t)ShaderStage::Vertex));
389     Builder.defineMacro("__SHADER_STAGE_PIXEL",
390                         Twine((uint32_t)ShaderStage::Pixel));
391     Builder.defineMacro("__SHADER_STAGE_GEOMETRY",
392                         Twine((uint32_t)ShaderStage::Geometry));
393     Builder.defineMacro("__SHADER_STAGE_HULL",
394                         Twine((uint32_t)ShaderStage::Hull));
395     Builder.defineMacro("__SHADER_STAGE_DOMAIN",
396                         Twine((uint32_t)ShaderStage::Domain));
397     Builder.defineMacro("__SHADER_STAGE_COMPUTE",
398                         Twine((uint32_t)ShaderStage::Compute));
399     Builder.defineMacro("__SHADER_STAGE_AMPLIFICATION",
400                         Twine((uint32_t)ShaderStage::Amplification));
401     Builder.defineMacro("__SHADER_STAGE_MESH",
402                         Twine((uint32_t)ShaderStage::Mesh));
403     Builder.defineMacro("__SHADER_STAGE_LIBRARY",
404                         Twine((uint32_t)ShaderStage::Library));
405     // The current shader stage itself
406     uint32_t StageInteger = static_cast<uint32_t>(
407         hlsl::getStageFromEnvironment(TI.getTriple().getEnvironment()));
408 
409     Builder.defineMacro("__SHADER_TARGET_STAGE", Twine(StageInteger));
410     // Add target versions
411     if (TI.getTriple().getOS() == llvm::Triple::ShaderModel) {
412       VersionTuple Version = TI.getTriple().getOSVersion();
413       Builder.defineMacro("__SHADER_TARGET_MAJOR", Twine(Version.getMajor()));
414       unsigned Minor = Version.getMinor().value_or(0);
415       Builder.defineMacro("__SHADER_TARGET_MINOR", Twine(Minor));
416     }
417     return;
418   }
419   // C++ [cpp.predefined]p1:
420   //   The following macro names shall be defined by the implementation:
421 
422   //   -- __STDC__
423   //      [C++] Whether __STDC__ is predefined and if so, what its value is,
424   //      are implementation-defined.
425   // (Removed in C++20.)
426   if (!LangOpts.MSVCCompat && !LangOpts.TraditionalCPP)
427     Builder.defineMacro("__STDC__");
428   //   -- __STDC_HOSTED__
429   //      The integer literal 1 if the implementation is a hosted
430   //      implementation or the integer literal 0 if it is not.
431   if (LangOpts.Freestanding)
432     Builder.defineMacro("__STDC_HOSTED__", "0");
433   else
434     Builder.defineMacro("__STDC_HOSTED__");
435 
436   //   -- __STDC_VERSION__
437   //      [C++] Whether __STDC_VERSION__ is predefined and if so, what its
438   //      value is, are implementation-defined.
439   // (Removed in C++20.)
440   if (!LangOpts.CPlusPlus) {
441     // FIXME: Use correct value for C23.
442     if (LangOpts.C2x)
443       Builder.defineMacro("__STDC_VERSION__", "202000L");
444     else if (LangOpts.C17)
445       Builder.defineMacro("__STDC_VERSION__", "201710L");
446     else if (LangOpts.C11)
447       Builder.defineMacro("__STDC_VERSION__", "201112L");
448     else if (LangOpts.C99)
449       Builder.defineMacro("__STDC_VERSION__", "199901L");
450     else if (!LangOpts.GNUMode && LangOpts.Digraphs)
451       Builder.defineMacro("__STDC_VERSION__", "199409L");
452   } else {
453     //   -- __cplusplus
454     if (LangOpts.CPlusPlus26)
455       // FIXME: Use correct value for C++26.
456       Builder.defineMacro("__cplusplus", "202400L");
457     else if (LangOpts.CPlusPlus23)
458       Builder.defineMacro("__cplusplus", "202302L");
459     //      [C++20] The integer literal 202002L.
460     else if (LangOpts.CPlusPlus20)
461       Builder.defineMacro("__cplusplus", "202002L");
462     //      [C++17] The integer literal 201703L.
463     else if (LangOpts.CPlusPlus17)
464       Builder.defineMacro("__cplusplus", "201703L");
465     //      [C++14] The name __cplusplus is defined to the value 201402L when
466     //      compiling a C++ translation unit.
467     else if (LangOpts.CPlusPlus14)
468       Builder.defineMacro("__cplusplus", "201402L");
469     //      [C++11] The name __cplusplus is defined to the value 201103L when
470     //      compiling a C++ translation unit.
471     else if (LangOpts.CPlusPlus11)
472       Builder.defineMacro("__cplusplus", "201103L");
473     //      [C++03] The name __cplusplus is defined to the value 199711L when
474     //      compiling a C++ translation unit.
475     else
476       Builder.defineMacro("__cplusplus", "199711L");
477 
478     //   -- __STDCPP_DEFAULT_NEW_ALIGNMENT__
479     //      [C++17] An integer literal of type std::size_t whose value is the
480     //      alignment guaranteed by a call to operator new(std::size_t)
481     //
482     // We provide this in all language modes, since it seems generally useful.
483     Builder.defineMacro("__STDCPP_DEFAULT_NEW_ALIGNMENT__",
484                         Twine(TI.getNewAlign() / TI.getCharWidth()) +
485                             TI.getTypeConstantSuffix(TI.getSizeType()));
486 
487     //   -- __STDCPP_­THREADS__
488     //      Defined, and has the value integer literal 1, if and only if a
489     //      program can have more than one thread of execution.
490     if (LangOpts.getThreadModel() == LangOptions::ThreadModelKind::POSIX)
491       Builder.defineMacro("__STDCPP_THREADS__", "1");
492   }
493 
494   // In C11 these are environment macros. In C++11 they are only defined
495   // as part of <cuchar>. To prevent breakage when mixing C and C++
496   // code, define these macros unconditionally. We can define them
497   // unconditionally, as Clang always uses UTF-16 and UTF-32 for 16-bit
498   // and 32-bit character literals.
499   Builder.defineMacro("__STDC_UTF_16__", "1");
500   Builder.defineMacro("__STDC_UTF_32__", "1");
501 
502   if (LangOpts.ObjC)
503     Builder.defineMacro("__OBJC__");
504 
505   // OpenCL v1.0/1.1 s6.9, v1.2/2.0 s6.10: Preprocessor Directives and Macros.
506   if (LangOpts.OpenCL) {
507     if (LangOpts.CPlusPlus) {
508       switch (LangOpts.OpenCLCPlusPlusVersion) {
509       case 100:
510         Builder.defineMacro("__OPENCL_CPP_VERSION__", "100");
511         break;
512       case 202100:
513         Builder.defineMacro("__OPENCL_CPP_VERSION__", "202100");
514         break;
515       default:
516         llvm_unreachable("Unsupported C++ version for OpenCL");
517       }
518       Builder.defineMacro("__CL_CPP_VERSION_1_0__", "100");
519       Builder.defineMacro("__CL_CPP_VERSION_2021__", "202100");
520     } else {
521       // OpenCL v1.0 and v1.1 do not have a predefined macro to indicate the
522       // language standard with which the program is compiled. __OPENCL_VERSION__
523       // is for the OpenCL version supported by the OpenCL device, which is not
524       // necessarily the language standard with which the program is compiled.
525       // A shared OpenCL header file requires a macro to indicate the language
526       // standard. As a workaround, __OPENCL_C_VERSION__ is defined for
527       // OpenCL v1.0 and v1.1.
528       switch (LangOpts.OpenCLVersion) {
529       case 100:
530         Builder.defineMacro("__OPENCL_C_VERSION__", "100");
531         break;
532       case 110:
533         Builder.defineMacro("__OPENCL_C_VERSION__", "110");
534         break;
535       case 120:
536         Builder.defineMacro("__OPENCL_C_VERSION__", "120");
537         break;
538       case 200:
539         Builder.defineMacro("__OPENCL_C_VERSION__", "200");
540         break;
541       case 300:
542         Builder.defineMacro("__OPENCL_C_VERSION__", "300");
543         break;
544       default:
545         llvm_unreachable("Unsupported OpenCL version");
546       }
547     }
548     Builder.defineMacro("CL_VERSION_1_0", "100");
549     Builder.defineMacro("CL_VERSION_1_1", "110");
550     Builder.defineMacro("CL_VERSION_1_2", "120");
551     Builder.defineMacro("CL_VERSION_2_0", "200");
552     Builder.defineMacro("CL_VERSION_3_0", "300");
553 
554     if (TI.isLittleEndian())
555       Builder.defineMacro("__ENDIAN_LITTLE__");
556 
557     if (LangOpts.FastRelaxedMath)
558       Builder.defineMacro("__FAST_RELAXED_MATH__");
559   }
560 
561   if (LangOpts.SYCLIsDevice || LangOpts.SYCLIsHost) {
562     // SYCL Version is set to a value when building SYCL applications
563     if (LangOpts.getSYCLVersion() == LangOptions::SYCL_2017)
564       Builder.defineMacro("CL_SYCL_LANGUAGE_VERSION", "121");
565     else if (LangOpts.getSYCLVersion() == LangOptions::SYCL_2020)
566       Builder.defineMacro("SYCL_LANGUAGE_VERSION", "202001");
567   }
568 
569   // Not "standard" per se, but available even with the -undef flag.
570   if (LangOpts.AsmPreprocessor)
571     Builder.defineMacro("__ASSEMBLER__");
572   if (LangOpts.CUDA) {
573     if (LangOpts.GPURelocatableDeviceCode)
574       Builder.defineMacro("__CLANG_RDC__");
575     if (!LangOpts.HIP)
576       Builder.defineMacro("__CUDA__");
577     if (LangOpts.GPUDefaultStream ==
578         LangOptions::GPUDefaultStreamKind::PerThread)
579       Builder.defineMacro("CUDA_API_PER_THREAD_DEFAULT_STREAM");
580   }
581   if (LangOpts.HIP) {
582     Builder.defineMacro("__HIP__");
583     Builder.defineMacro("__HIPCC__");
584     Builder.defineMacro("__HIP_MEMORY_SCOPE_SINGLETHREAD", "1");
585     Builder.defineMacro("__HIP_MEMORY_SCOPE_WAVEFRONT", "2");
586     Builder.defineMacro("__HIP_MEMORY_SCOPE_WORKGROUP", "3");
587     Builder.defineMacro("__HIP_MEMORY_SCOPE_AGENT", "4");
588     Builder.defineMacro("__HIP_MEMORY_SCOPE_SYSTEM", "5");
589     if (LangOpts.CUDAIsDevice) {
590       Builder.defineMacro("__HIP_DEVICE_COMPILE__");
591       if (!TI.hasHIPImageSupport())
592         Builder.defineMacro("__HIP_NO_IMAGE_SUPPORT", "1");
593     }
594     if (LangOpts.GPUDefaultStream ==
595         LangOptions::GPUDefaultStreamKind::PerThread)
596       Builder.defineMacro("HIP_API_PER_THREAD_DEFAULT_STREAM");
597   }
598 }
599 
600 /// Initialize the predefined C++ language feature test macros defined in
601 /// ISO/IEC JTC1/SC22/WG21 (C++) SD-6: "SG10 Feature Test Recommendations".
602 static void InitializeCPlusPlusFeatureTestMacros(const LangOptions &LangOpts,
603                                                  MacroBuilder &Builder) {
604   // C++98 features.
605   if (LangOpts.RTTI)
606     Builder.defineMacro("__cpp_rtti", "199711L");
607   if (LangOpts.CXXExceptions)
608     Builder.defineMacro("__cpp_exceptions", "199711L");
609 
610   // C++11 features.
611   if (LangOpts.CPlusPlus11) {
612     Builder.defineMacro("__cpp_unicode_characters", "200704L");
613     Builder.defineMacro("__cpp_raw_strings", "200710L");
614     Builder.defineMacro("__cpp_unicode_literals", "200710L");
615     Builder.defineMacro("__cpp_user_defined_literals", "200809L");
616     Builder.defineMacro("__cpp_lambdas", "200907L");
617     Builder.defineMacro("__cpp_constexpr", LangOpts.CPlusPlus26   ? "202306L"
618                                            : LangOpts.CPlusPlus23 ? "202211L"
619                                            : LangOpts.CPlusPlus20 ? "201907L"
620                                            : LangOpts.CPlusPlus17 ? "201603L"
621                                            : LangOpts.CPlusPlus14 ? "201304L"
622                                                                   : "200704");
623     Builder.defineMacro("__cpp_constexpr_in_decltype", "201711L");
624     Builder.defineMacro("__cpp_range_based_for",
625                         LangOpts.CPlusPlus17 ? "201603L" : "200907");
626     Builder.defineMacro("__cpp_static_assert",
627                         LangOpts.CPlusPlus17 ? "201411L" : "200410");
628     Builder.defineMacro("__cpp_decltype", "200707L");
629     Builder.defineMacro("__cpp_attributes", "200809L");
630     Builder.defineMacro("__cpp_rvalue_references", "200610L");
631     Builder.defineMacro("__cpp_variadic_templates", "200704L");
632     Builder.defineMacro("__cpp_initializer_lists", "200806L");
633     Builder.defineMacro("__cpp_delegating_constructors", "200604L");
634     Builder.defineMacro("__cpp_nsdmi", "200809L");
635     Builder.defineMacro("__cpp_inheriting_constructors", "201511L");
636     Builder.defineMacro("__cpp_ref_qualifiers", "200710L");
637     Builder.defineMacro("__cpp_alias_templates", "200704L");
638   }
639   if (LangOpts.ThreadsafeStatics)
640     Builder.defineMacro("__cpp_threadsafe_static_init", "200806L");
641 
642   // C++14 features.
643   if (LangOpts.CPlusPlus14) {
644     Builder.defineMacro("__cpp_binary_literals", "201304L");
645     Builder.defineMacro("__cpp_digit_separators", "201309L");
646     Builder.defineMacro("__cpp_init_captures",
647                         LangOpts.CPlusPlus20 ? "201803L" : "201304L");
648     Builder.defineMacro("__cpp_generic_lambdas",
649                         LangOpts.CPlusPlus20 ? "201707L" : "201304L");
650     Builder.defineMacro("__cpp_decltype_auto", "201304L");
651     Builder.defineMacro("__cpp_return_type_deduction", "201304L");
652     Builder.defineMacro("__cpp_aggregate_nsdmi", "201304L");
653     Builder.defineMacro("__cpp_variable_templates", "201304L");
654   }
655   if (LangOpts.SizedDeallocation)
656     Builder.defineMacro("__cpp_sized_deallocation", "201309L");
657 
658   // C++17 features.
659   if (LangOpts.CPlusPlus17) {
660     Builder.defineMacro("__cpp_hex_float", "201603L");
661     Builder.defineMacro("__cpp_inline_variables", "201606L");
662     Builder.defineMacro("__cpp_noexcept_function_type", "201510L");
663     Builder.defineMacro("__cpp_capture_star_this", "201603L");
664     Builder.defineMacro("__cpp_if_constexpr", "201606L");
665     Builder.defineMacro("__cpp_deduction_guides", "201703L"); // (not latest)
666     Builder.defineMacro("__cpp_template_auto", "201606L"); // (old name)
667     Builder.defineMacro("__cpp_namespace_attributes", "201411L");
668     Builder.defineMacro("__cpp_enumerator_attributes", "201411L");
669     Builder.defineMacro("__cpp_nested_namespace_definitions", "201411L");
670     Builder.defineMacro("__cpp_variadic_using", "201611L");
671     Builder.defineMacro("__cpp_aggregate_bases", "201603L");
672     Builder.defineMacro("__cpp_structured_bindings", "201606L");
673     Builder.defineMacro("__cpp_nontype_template_args",
674                         "201411L"); // (not latest)
675     Builder.defineMacro("__cpp_fold_expressions", "201603L");
676     Builder.defineMacro("__cpp_guaranteed_copy_elision", "201606L");
677     Builder.defineMacro("__cpp_nontype_template_parameter_auto", "201606L");
678   }
679   if (LangOpts.AlignedAllocation && !LangOpts.AlignedAllocationUnavailable)
680     Builder.defineMacro("__cpp_aligned_new", "201606L");
681   if (LangOpts.RelaxedTemplateTemplateArgs)
682     Builder.defineMacro("__cpp_template_template_args", "201611L");
683 
684   // C++20 features.
685   if (LangOpts.CPlusPlus20) {
686     Builder.defineMacro("__cpp_aggregate_paren_init", "201902L");
687 
688     // P0848 is implemented, but we're still waiting for other concepts
689     // issues to be addressed before bumping __cpp_concepts up to 202002L.
690     // Refer to the discussion of this at https://reviews.llvm.org/D128619.
691     Builder.defineMacro("__cpp_concepts", "201907L");
692     Builder.defineMacro("__cpp_conditional_explicit", "201806L");
693     Builder.defineMacro("__cpp_consteval", "202211L");
694     Builder.defineMacro("__cpp_constexpr_dynamic_alloc", "201907L");
695     Builder.defineMacro("__cpp_constinit", "201907L");
696     Builder.defineMacro("__cpp_impl_coroutine", "201902L");
697     Builder.defineMacro("__cpp_designated_initializers", "201707L");
698     Builder.defineMacro("__cpp_impl_three_way_comparison", "201907L");
699     //Builder.defineMacro("__cpp_modules", "201907L");
700     Builder.defineMacro("__cpp_using_enum", "201907L");
701   }
702   // C++23 features.
703   if (LangOpts.CPlusPlus23) {
704     Builder.defineMacro("__cpp_implicit_move", "202011L");
705     Builder.defineMacro("__cpp_size_t_suffix", "202011L");
706     Builder.defineMacro("__cpp_if_consteval", "202106L");
707     Builder.defineMacro("__cpp_multidimensional_subscript", "202211L");
708   }
709 
710   // We provide those C++23 features as extensions in earlier language modes, so
711   // we also define their feature test macros.
712   if (LangOpts.CPlusPlus11)
713     Builder.defineMacro("__cpp_static_call_operator", "202207L");
714   Builder.defineMacro("__cpp_named_character_escapes", "202207L");
715 
716   if (LangOpts.Char8)
717     Builder.defineMacro("__cpp_char8_t", "202207L");
718   Builder.defineMacro("__cpp_impl_destroying_delete", "201806L");
719 }
720 
721 /// InitializeOpenCLFeatureTestMacros - Define OpenCL macros based on target
722 /// settings and language version
723 void InitializeOpenCLFeatureTestMacros(const TargetInfo &TI,
724                                        const LangOptions &Opts,
725                                        MacroBuilder &Builder) {
726   const llvm::StringMap<bool> &OpenCLFeaturesMap = TI.getSupportedOpenCLOpts();
727   // FIXME: OpenCL options which affect language semantics/syntax
728   // should be moved into LangOptions.
729   auto defineOpenCLExtMacro = [&](llvm::StringRef Name, auto... OptArgs) {
730     // Check if extension is supported by target and is available in this
731     // OpenCL version
732     if (TI.hasFeatureEnabled(OpenCLFeaturesMap, Name) &&
733         OpenCLOptions::isOpenCLOptionAvailableIn(Opts, OptArgs...))
734       Builder.defineMacro(Name);
735   };
736 #define OPENCL_GENERIC_EXTENSION(Ext, ...)                                     \
737   defineOpenCLExtMacro(#Ext, __VA_ARGS__);
738 #include "clang/Basic/OpenCLExtensions.def"
739 
740   // Assume compiling for FULL profile
741   Builder.defineMacro("__opencl_c_int64");
742 }
743 
744 static void InitializePredefinedMacros(const TargetInfo &TI,
745                                        const LangOptions &LangOpts,
746                                        const FrontendOptions &FEOpts,
747                                        const PreprocessorOptions &PPOpts,
748                                        MacroBuilder &Builder) {
749   // Compiler version introspection macros.
750   Builder.defineMacro("__llvm__");  // LLVM Backend
751   Builder.defineMacro("__clang__"); // Clang Frontend
752 #define TOSTR2(X) #X
753 #define TOSTR(X) TOSTR2(X)
754   Builder.defineMacro("__clang_major__", TOSTR(CLANG_VERSION_MAJOR));
755   Builder.defineMacro("__clang_minor__", TOSTR(CLANG_VERSION_MINOR));
756   Builder.defineMacro("__clang_patchlevel__", TOSTR(CLANG_VERSION_PATCHLEVEL));
757 #undef TOSTR
758 #undef TOSTR2
759   Builder.defineMacro("__clang_version__",
760                       "\"" CLANG_VERSION_STRING " "
761                       + getClangFullRepositoryVersion() + "\"");
762 
763   if (LangOpts.GNUCVersion != 0) {
764     // Major, minor, patch, are given two decimal places each, so 4.2.1 becomes
765     // 40201.
766     unsigned GNUCMajor = LangOpts.GNUCVersion / 100 / 100;
767     unsigned GNUCMinor = LangOpts.GNUCVersion / 100 % 100;
768     unsigned GNUCPatch = LangOpts.GNUCVersion % 100;
769     Builder.defineMacro("__GNUC__", Twine(GNUCMajor));
770     Builder.defineMacro("__GNUC_MINOR__", Twine(GNUCMinor));
771     Builder.defineMacro("__GNUC_PATCHLEVEL__", Twine(GNUCPatch));
772     Builder.defineMacro("__GXX_ABI_VERSION", "1002");
773 
774     if (LangOpts.CPlusPlus) {
775       Builder.defineMacro("__GNUG__", Twine(GNUCMajor));
776       Builder.defineMacro("__GXX_WEAK__");
777     }
778   }
779 
780   // Define macros for the C11 / C++11 memory orderings
781   Builder.defineMacro("__ATOMIC_RELAXED", "0");
782   Builder.defineMacro("__ATOMIC_CONSUME", "1");
783   Builder.defineMacro("__ATOMIC_ACQUIRE", "2");
784   Builder.defineMacro("__ATOMIC_RELEASE", "3");
785   Builder.defineMacro("__ATOMIC_ACQ_REL", "4");
786   Builder.defineMacro("__ATOMIC_SEQ_CST", "5");
787 
788   // Define macros for the OpenCL memory scope.
789   // The values should match AtomicScopeOpenCLModel::ID enum.
790   static_assert(
791       static_cast<unsigned>(AtomicScopeOpenCLModel::WorkGroup) == 1 &&
792           static_cast<unsigned>(AtomicScopeOpenCLModel::Device) == 2 &&
793           static_cast<unsigned>(AtomicScopeOpenCLModel::AllSVMDevices) == 3 &&
794           static_cast<unsigned>(AtomicScopeOpenCLModel::SubGroup) == 4,
795       "Invalid OpenCL memory scope enum definition");
796   Builder.defineMacro("__OPENCL_MEMORY_SCOPE_WORK_ITEM", "0");
797   Builder.defineMacro("__OPENCL_MEMORY_SCOPE_WORK_GROUP", "1");
798   Builder.defineMacro("__OPENCL_MEMORY_SCOPE_DEVICE", "2");
799   Builder.defineMacro("__OPENCL_MEMORY_SCOPE_ALL_SVM_DEVICES", "3");
800   Builder.defineMacro("__OPENCL_MEMORY_SCOPE_SUB_GROUP", "4");
801 
802   // Define macros for floating-point data classes, used in __builtin_isfpclass.
803   Builder.defineMacro("__FPCLASS_SNAN", "0x0001");
804   Builder.defineMacro("__FPCLASS_QNAN", "0x0002");
805   Builder.defineMacro("__FPCLASS_NEGINF", "0x0004");
806   Builder.defineMacro("__FPCLASS_NEGNORMAL", "0x0008");
807   Builder.defineMacro("__FPCLASS_NEGSUBNORMAL", "0x0010");
808   Builder.defineMacro("__FPCLASS_NEGZERO", "0x0020");
809   Builder.defineMacro("__FPCLASS_POSZERO", "0x0040");
810   Builder.defineMacro("__FPCLASS_POSSUBNORMAL", "0x0080");
811   Builder.defineMacro("__FPCLASS_POSNORMAL", "0x0100");
812   Builder.defineMacro("__FPCLASS_POSINF", "0x0200");
813 
814   // Support for #pragma redefine_extname (Sun compatibility)
815   Builder.defineMacro("__PRAGMA_REDEFINE_EXTNAME", "1");
816 
817   // Previously this macro was set to a string aiming to achieve compatibility
818   // with GCC 4.2.1. Now, just return the full Clang version
819   Builder.defineMacro("__VERSION__", "\"" +
820                       Twine(getClangFullCPPVersion()) + "\"");
821 
822   // Initialize language-specific preprocessor defines.
823 
824   // Standard conforming mode?
825   if (!LangOpts.GNUMode && !LangOpts.MSVCCompat)
826     Builder.defineMacro("__STRICT_ANSI__");
827 
828   if (LangOpts.GNUCVersion && LangOpts.CPlusPlus11)
829     Builder.defineMacro("__GXX_EXPERIMENTAL_CXX0X__");
830 
831   if (LangOpts.ObjC) {
832     if (LangOpts.ObjCRuntime.isNonFragile()) {
833       Builder.defineMacro("__OBJC2__");
834 
835       if (LangOpts.ObjCExceptions)
836         Builder.defineMacro("OBJC_ZEROCOST_EXCEPTIONS");
837     }
838 
839     if (LangOpts.getGC() != LangOptions::NonGC)
840       Builder.defineMacro("__OBJC_GC__");
841 
842     if (LangOpts.ObjCRuntime.isNeXTFamily())
843       Builder.defineMacro("__NEXT_RUNTIME__");
844 
845     if (LangOpts.ObjCRuntime.getKind() == ObjCRuntime::GNUstep) {
846       auto version = LangOpts.ObjCRuntime.getVersion();
847       std::string versionString = "1";
848       // Don't rely on the tuple argument, because we can be asked to target
849       // later ABIs than we actually support, so clamp these values to those
850       // currently supported
851       if (version >= VersionTuple(2, 0))
852         Builder.defineMacro("__OBJC_GNUSTEP_RUNTIME_ABI__", "20");
853       else
854         Builder.defineMacro(
855             "__OBJC_GNUSTEP_RUNTIME_ABI__",
856             "1" + Twine(std::min(8U, version.getMinor().value_or(0))));
857     }
858 
859     if (LangOpts.ObjCRuntime.getKind() == ObjCRuntime::ObjFW) {
860       VersionTuple tuple = LangOpts.ObjCRuntime.getVersion();
861       unsigned minor = tuple.getMinor().value_or(0);
862       unsigned subminor = tuple.getSubminor().value_or(0);
863       Builder.defineMacro("__OBJFW_RUNTIME_ABI__",
864                           Twine(tuple.getMajor() * 10000 + minor * 100 +
865                                 subminor));
866     }
867 
868     Builder.defineMacro("IBOutlet", "__attribute__((iboutlet))");
869     Builder.defineMacro("IBOutletCollection(ClassName)",
870                         "__attribute__((iboutletcollection(ClassName)))");
871     Builder.defineMacro("IBAction", "void)__attribute__((ibaction)");
872     Builder.defineMacro("IBInspectable", "");
873     Builder.defineMacro("IB_DESIGNABLE", "");
874   }
875 
876   // Define a macro that describes the Objective-C boolean type even for C
877   // and C++ since BOOL can be used from non Objective-C code.
878   Builder.defineMacro("__OBJC_BOOL_IS_BOOL",
879                       Twine(TI.useSignedCharForObjCBool() ? "0" : "1"));
880 
881   if (LangOpts.CPlusPlus)
882     InitializeCPlusPlusFeatureTestMacros(LangOpts, Builder);
883 
884   // darwin_constant_cfstrings controls this. This is also dependent
885   // on other things like the runtime I believe.  This is set even for C code.
886   if (!LangOpts.NoConstantCFStrings)
887       Builder.defineMacro("__CONSTANT_CFSTRINGS__");
888 
889   if (LangOpts.ObjC)
890     Builder.defineMacro("OBJC_NEW_PROPERTIES");
891 
892   if (LangOpts.PascalStrings)
893     Builder.defineMacro("__PASCAL_STRINGS__");
894 
895   if (LangOpts.Blocks) {
896     Builder.defineMacro("__block", "__attribute__((__blocks__(byref)))");
897     Builder.defineMacro("__BLOCKS__");
898   }
899 
900   if (!LangOpts.MSVCCompat && LangOpts.Exceptions)
901     Builder.defineMacro("__EXCEPTIONS");
902   if (LangOpts.GNUCVersion && LangOpts.RTTI)
903     Builder.defineMacro("__GXX_RTTI");
904 
905   if (LangOpts.hasSjLjExceptions())
906     Builder.defineMacro("__USING_SJLJ_EXCEPTIONS__");
907   else if (LangOpts.hasSEHExceptions())
908     Builder.defineMacro("__SEH__");
909   else if (LangOpts.hasDWARFExceptions() &&
910            (TI.getTriple().isThumb() || TI.getTriple().isARM()))
911     Builder.defineMacro("__ARM_DWARF_EH__");
912 
913   if (LangOpts.Deprecated)
914     Builder.defineMacro("__DEPRECATED");
915 
916   if (!LangOpts.MSVCCompat && LangOpts.CPlusPlus)
917     Builder.defineMacro("__private_extern__", "extern");
918 
919   if (LangOpts.MicrosoftExt) {
920     if (LangOpts.WChar) {
921       // wchar_t supported as a keyword.
922       Builder.defineMacro("_WCHAR_T_DEFINED");
923       Builder.defineMacro("_NATIVE_WCHAR_T_DEFINED");
924     }
925   }
926 
927   // Macros to help identify the narrow and wide character sets
928   // FIXME: clang currently ignores -fexec-charset=. If this changes,
929   // then this may need to be updated.
930   Builder.defineMacro("__clang_literal_encoding__", "\"UTF-8\"");
931   if (TI.getTypeWidth(TI.getWCharType()) >= 32) {
932     // FIXME: 32-bit wchar_t signals UTF-32. This may change
933     // if -fwide-exec-charset= is ever supported.
934     Builder.defineMacro("__clang_wide_literal_encoding__", "\"UTF-32\"");
935   } else {
936     // FIXME: Less-than 32-bit wchar_t generally means UTF-16
937     // (e.g., Windows, 32-bit IBM). This may need to be
938     // updated if -fwide-exec-charset= is ever supported.
939     Builder.defineMacro("__clang_wide_literal_encoding__", "\"UTF-16\"");
940   }
941 
942   if (LangOpts.Optimize)
943     Builder.defineMacro("__OPTIMIZE__");
944   if (LangOpts.OptimizeSize)
945     Builder.defineMacro("__OPTIMIZE_SIZE__");
946 
947   if (LangOpts.FastMath)
948     Builder.defineMacro("__FAST_MATH__");
949 
950   // Initialize target-specific preprocessor defines.
951 
952   // __BYTE_ORDER__ was added in GCC 4.6. It's analogous
953   // to the macro __BYTE_ORDER (no trailing underscores)
954   // from glibc's <endian.h> header.
955   // We don't support the PDP-11 as a target, but include
956   // the define so it can still be compared against.
957   Builder.defineMacro("__ORDER_LITTLE_ENDIAN__", "1234");
958   Builder.defineMacro("__ORDER_BIG_ENDIAN__",    "4321");
959   Builder.defineMacro("__ORDER_PDP_ENDIAN__",    "3412");
960   if (TI.isBigEndian()) {
961     Builder.defineMacro("__BYTE_ORDER__", "__ORDER_BIG_ENDIAN__");
962     Builder.defineMacro("__BIG_ENDIAN__");
963   } else {
964     Builder.defineMacro("__BYTE_ORDER__", "__ORDER_LITTLE_ENDIAN__");
965     Builder.defineMacro("__LITTLE_ENDIAN__");
966   }
967 
968   if (TI.getPointerWidth(LangAS::Default) == 64 && TI.getLongWidth() == 64 &&
969       TI.getIntWidth() == 32) {
970     Builder.defineMacro("_LP64");
971     Builder.defineMacro("__LP64__");
972   }
973 
974   if (TI.getPointerWidth(LangAS::Default) == 32 && TI.getLongWidth() == 32 &&
975       TI.getIntWidth() == 32) {
976     Builder.defineMacro("_ILP32");
977     Builder.defineMacro("__ILP32__");
978   }
979 
980   // Define type sizing macros based on the target properties.
981   assert(TI.getCharWidth() == 8 && "Only support 8-bit char so far");
982   Builder.defineMacro("__CHAR_BIT__", Twine(TI.getCharWidth()));
983 
984   Builder.defineMacro("__BOOL_WIDTH__", Twine(TI.getBoolWidth()));
985   Builder.defineMacro("__SHRT_WIDTH__", Twine(TI.getShortWidth()));
986   Builder.defineMacro("__INT_WIDTH__", Twine(TI.getIntWidth()));
987   Builder.defineMacro("__LONG_WIDTH__", Twine(TI.getLongWidth()));
988   Builder.defineMacro("__LLONG_WIDTH__", Twine(TI.getLongLongWidth()));
989 
990   size_t BitIntMaxWidth = TI.getMaxBitIntWidth();
991   assert(BitIntMaxWidth <= llvm::IntegerType::MAX_INT_BITS &&
992          "Target defined a max bit width larger than LLVM can support!");
993   assert(BitIntMaxWidth >= TI.getLongLongWidth() &&
994          "Target defined a max bit width smaller than the C standard allows!");
995   Builder.defineMacro("__BITINT_MAXWIDTH__", Twine(BitIntMaxWidth));
996 
997   DefineTypeSize("__SCHAR_MAX__", TargetInfo::SignedChar, TI, Builder);
998   DefineTypeSize("__SHRT_MAX__", TargetInfo::SignedShort, TI, Builder);
999   DefineTypeSize("__INT_MAX__", TargetInfo::SignedInt, TI, Builder);
1000   DefineTypeSize("__LONG_MAX__", TargetInfo::SignedLong, TI, Builder);
1001   DefineTypeSize("__LONG_LONG_MAX__", TargetInfo::SignedLongLong, TI, Builder);
1002   DefineTypeSizeAndWidth("__WCHAR", TI.getWCharType(), TI, Builder);
1003   DefineTypeSizeAndWidth("__WINT", TI.getWIntType(), TI, Builder);
1004   DefineTypeSizeAndWidth("__INTMAX", TI.getIntMaxType(), TI, Builder);
1005   DefineTypeSizeAndWidth("__SIZE", TI.getSizeType(), TI, Builder);
1006 
1007   DefineTypeSizeAndWidth("__UINTMAX", TI.getUIntMaxType(), TI, Builder);
1008   DefineTypeSizeAndWidth("__PTRDIFF", TI.getPtrDiffType(LangAS::Default), TI,
1009                          Builder);
1010   DefineTypeSizeAndWidth("__INTPTR", TI.getIntPtrType(), TI, Builder);
1011   DefineTypeSizeAndWidth("__UINTPTR", TI.getUIntPtrType(), TI, Builder);
1012 
1013   DefineTypeSizeof("__SIZEOF_DOUBLE__", TI.getDoubleWidth(), TI, Builder);
1014   DefineTypeSizeof("__SIZEOF_FLOAT__", TI.getFloatWidth(), TI, Builder);
1015   DefineTypeSizeof("__SIZEOF_INT__", TI.getIntWidth(), TI, Builder);
1016   DefineTypeSizeof("__SIZEOF_LONG__", TI.getLongWidth(), TI, Builder);
1017   DefineTypeSizeof("__SIZEOF_LONG_DOUBLE__",TI.getLongDoubleWidth(),TI,Builder);
1018   DefineTypeSizeof("__SIZEOF_LONG_LONG__", TI.getLongLongWidth(), TI, Builder);
1019   DefineTypeSizeof("__SIZEOF_POINTER__", TI.getPointerWidth(LangAS::Default),
1020                    TI, Builder);
1021   DefineTypeSizeof("__SIZEOF_SHORT__", TI.getShortWidth(), TI, Builder);
1022   DefineTypeSizeof("__SIZEOF_PTRDIFF_T__",
1023                    TI.getTypeWidth(TI.getPtrDiffType(LangAS::Default)), TI,
1024                    Builder);
1025   DefineTypeSizeof("__SIZEOF_SIZE_T__",
1026                    TI.getTypeWidth(TI.getSizeType()), TI, Builder);
1027   DefineTypeSizeof("__SIZEOF_WCHAR_T__",
1028                    TI.getTypeWidth(TI.getWCharType()), TI, Builder);
1029   DefineTypeSizeof("__SIZEOF_WINT_T__",
1030                    TI.getTypeWidth(TI.getWIntType()), TI, Builder);
1031   if (TI.hasInt128Type())
1032     DefineTypeSizeof("__SIZEOF_INT128__", 128, TI, Builder);
1033 
1034   DefineType("__INTMAX_TYPE__", TI.getIntMaxType(), Builder);
1035   DefineFmt("__INTMAX", TI.getIntMaxType(), TI, Builder);
1036   Builder.defineMacro("__INTMAX_C_SUFFIX__",
1037                       TI.getTypeConstantSuffix(TI.getIntMaxType()));
1038   DefineType("__UINTMAX_TYPE__", TI.getUIntMaxType(), Builder);
1039   DefineFmt("__UINTMAX", TI.getUIntMaxType(), TI, Builder);
1040   Builder.defineMacro("__UINTMAX_C_SUFFIX__",
1041                       TI.getTypeConstantSuffix(TI.getUIntMaxType()));
1042   DefineType("__PTRDIFF_TYPE__", TI.getPtrDiffType(LangAS::Default), Builder);
1043   DefineFmt("__PTRDIFF", TI.getPtrDiffType(LangAS::Default), TI, Builder);
1044   DefineType("__INTPTR_TYPE__", TI.getIntPtrType(), Builder);
1045   DefineFmt("__INTPTR", TI.getIntPtrType(), TI, Builder);
1046   DefineType("__SIZE_TYPE__", TI.getSizeType(), Builder);
1047   DefineFmt("__SIZE", TI.getSizeType(), TI, Builder);
1048   DefineType("__WCHAR_TYPE__", TI.getWCharType(), Builder);
1049   DefineType("__WINT_TYPE__", TI.getWIntType(), Builder);
1050   DefineTypeSizeAndWidth("__SIG_ATOMIC", TI.getSigAtomicType(), TI, Builder);
1051   DefineType("__CHAR16_TYPE__", TI.getChar16Type(), Builder);
1052   DefineType("__CHAR32_TYPE__", TI.getChar32Type(), Builder);
1053 
1054   DefineType("__UINTPTR_TYPE__", TI.getUIntPtrType(), Builder);
1055   DefineFmt("__UINTPTR", TI.getUIntPtrType(), TI, Builder);
1056 
1057   // The C standard requires the width of uintptr_t and intptr_t to be the same,
1058   // per 7.20.2.4p1. Same for intmax_t and uintmax_t, per 7.20.2.5p1.
1059   assert(TI.getTypeWidth(TI.getUIntPtrType()) ==
1060              TI.getTypeWidth(TI.getIntPtrType()) &&
1061          "uintptr_t and intptr_t have different widths?");
1062   assert(TI.getTypeWidth(TI.getUIntMaxType()) ==
1063              TI.getTypeWidth(TI.getIntMaxType()) &&
1064          "uintmax_t and intmax_t have different widths?");
1065 
1066   if (TI.hasFloat16Type())
1067     DefineFloatMacros(Builder, "FLT16", &TI.getHalfFormat(), "F16");
1068   DefineFloatMacros(Builder, "FLT", &TI.getFloatFormat(), "F");
1069   DefineFloatMacros(Builder, "DBL", &TI.getDoubleFormat(), "");
1070   DefineFloatMacros(Builder, "LDBL", &TI.getLongDoubleFormat(), "L");
1071 
1072   // Define a __POINTER_WIDTH__ macro for stdint.h.
1073   Builder.defineMacro("__POINTER_WIDTH__",
1074                       Twine((int)TI.getPointerWidth(LangAS::Default)));
1075 
1076   // Define __BIGGEST_ALIGNMENT__ to be compatible with gcc.
1077   Builder.defineMacro("__BIGGEST_ALIGNMENT__",
1078                       Twine(TI.getSuitableAlign() / TI.getCharWidth()) );
1079 
1080   if (!LangOpts.CharIsSigned)
1081     Builder.defineMacro("__CHAR_UNSIGNED__");
1082 
1083   if (!TargetInfo::isTypeSigned(TI.getWCharType()))
1084     Builder.defineMacro("__WCHAR_UNSIGNED__");
1085 
1086   if (!TargetInfo::isTypeSigned(TI.getWIntType()))
1087     Builder.defineMacro("__WINT_UNSIGNED__");
1088 
1089   // Define exact-width integer types for stdint.h
1090   DefineExactWidthIntType(TargetInfo::SignedChar, TI, Builder);
1091 
1092   if (TI.getShortWidth() > TI.getCharWidth())
1093     DefineExactWidthIntType(TargetInfo::SignedShort, TI, Builder);
1094 
1095   if (TI.getIntWidth() > TI.getShortWidth())
1096     DefineExactWidthIntType(TargetInfo::SignedInt, TI, Builder);
1097 
1098   if (TI.getLongWidth() > TI.getIntWidth())
1099     DefineExactWidthIntType(TargetInfo::SignedLong, TI, Builder);
1100 
1101   if (TI.getLongLongWidth() > TI.getLongWidth())
1102     DefineExactWidthIntType(TargetInfo::SignedLongLong, TI, Builder);
1103 
1104   DefineExactWidthIntType(TargetInfo::UnsignedChar, TI, Builder);
1105   DefineExactWidthIntTypeSize(TargetInfo::UnsignedChar, TI, Builder);
1106   DefineExactWidthIntTypeSize(TargetInfo::SignedChar, TI, Builder);
1107 
1108   if (TI.getShortWidth() > TI.getCharWidth()) {
1109     DefineExactWidthIntType(TargetInfo::UnsignedShort, TI, Builder);
1110     DefineExactWidthIntTypeSize(TargetInfo::UnsignedShort, TI, Builder);
1111     DefineExactWidthIntTypeSize(TargetInfo::SignedShort, TI, Builder);
1112   }
1113 
1114   if (TI.getIntWidth() > TI.getShortWidth()) {
1115     DefineExactWidthIntType(TargetInfo::UnsignedInt, TI, Builder);
1116     DefineExactWidthIntTypeSize(TargetInfo::UnsignedInt, TI, Builder);
1117     DefineExactWidthIntTypeSize(TargetInfo::SignedInt, TI, Builder);
1118   }
1119 
1120   if (TI.getLongWidth() > TI.getIntWidth()) {
1121     DefineExactWidthIntType(TargetInfo::UnsignedLong, TI, Builder);
1122     DefineExactWidthIntTypeSize(TargetInfo::UnsignedLong, TI, Builder);
1123     DefineExactWidthIntTypeSize(TargetInfo::SignedLong, TI, Builder);
1124   }
1125 
1126   if (TI.getLongLongWidth() > TI.getLongWidth()) {
1127     DefineExactWidthIntType(TargetInfo::UnsignedLongLong, TI, Builder);
1128     DefineExactWidthIntTypeSize(TargetInfo::UnsignedLongLong, TI, Builder);
1129     DefineExactWidthIntTypeSize(TargetInfo::SignedLongLong, TI, Builder);
1130   }
1131 
1132   DefineLeastWidthIntType(8, true, TI, Builder);
1133   DefineLeastWidthIntType(8, false, TI, Builder);
1134   DefineLeastWidthIntType(16, true, TI, Builder);
1135   DefineLeastWidthIntType(16, false, TI, Builder);
1136   DefineLeastWidthIntType(32, true, TI, Builder);
1137   DefineLeastWidthIntType(32, false, TI, Builder);
1138   DefineLeastWidthIntType(64, true, TI, Builder);
1139   DefineLeastWidthIntType(64, false, TI, Builder);
1140 
1141   DefineFastIntType(8, true, TI, Builder);
1142   DefineFastIntType(8, false, TI, Builder);
1143   DefineFastIntType(16, true, TI, Builder);
1144   DefineFastIntType(16, false, TI, Builder);
1145   DefineFastIntType(32, true, TI, Builder);
1146   DefineFastIntType(32, false, TI, Builder);
1147   DefineFastIntType(64, true, TI, Builder);
1148   DefineFastIntType(64, false, TI, Builder);
1149 
1150   Builder.defineMacro("__USER_LABEL_PREFIX__", TI.getUserLabelPrefix());
1151 
1152   if (!LangOpts.MathErrno)
1153     Builder.defineMacro("__NO_MATH_ERRNO__");
1154 
1155   if (LangOpts.FastMath || LangOpts.FiniteMathOnly)
1156     Builder.defineMacro("__FINITE_MATH_ONLY__", "1");
1157   else
1158     Builder.defineMacro("__FINITE_MATH_ONLY__", "0");
1159 
1160   if (LangOpts.GNUCVersion) {
1161     if (LangOpts.GNUInline || LangOpts.CPlusPlus)
1162       Builder.defineMacro("__GNUC_GNU_INLINE__");
1163     else
1164       Builder.defineMacro("__GNUC_STDC_INLINE__");
1165 
1166     // The value written by __atomic_test_and_set.
1167     // FIXME: This is target-dependent.
1168     Builder.defineMacro("__GCC_ATOMIC_TEST_AND_SET_TRUEVAL", "1");
1169   }
1170 
1171   auto addLockFreeMacros = [&](const llvm::Twine &Prefix) {
1172     // Used by libc++ and libstdc++ to implement ATOMIC_<foo>_LOCK_FREE.
1173 #define DEFINE_LOCK_FREE_MACRO(TYPE, Type)                                     \
1174   Builder.defineMacro(Prefix + #TYPE "_LOCK_FREE",                             \
1175                       getLockFreeValue(TI.get##Type##Width(), TI));
1176     DEFINE_LOCK_FREE_MACRO(BOOL, Bool);
1177     DEFINE_LOCK_FREE_MACRO(CHAR, Char);
1178     if (LangOpts.Char8)
1179       DEFINE_LOCK_FREE_MACRO(CHAR8_T, Char); // Treat char8_t like char.
1180     DEFINE_LOCK_FREE_MACRO(CHAR16_T, Char16);
1181     DEFINE_LOCK_FREE_MACRO(CHAR32_T, Char32);
1182     DEFINE_LOCK_FREE_MACRO(WCHAR_T, WChar);
1183     DEFINE_LOCK_FREE_MACRO(SHORT, Short);
1184     DEFINE_LOCK_FREE_MACRO(INT, Int);
1185     DEFINE_LOCK_FREE_MACRO(LONG, Long);
1186     DEFINE_LOCK_FREE_MACRO(LLONG, LongLong);
1187     Builder.defineMacro(
1188         Prefix + "POINTER_LOCK_FREE",
1189         getLockFreeValue(TI.getPointerWidth(LangAS::Default), TI));
1190 #undef DEFINE_LOCK_FREE_MACRO
1191   };
1192   addLockFreeMacros("__CLANG_ATOMIC_");
1193   if (LangOpts.GNUCVersion)
1194     addLockFreeMacros("__GCC_ATOMIC_");
1195 
1196   if (LangOpts.NoInlineDefine)
1197     Builder.defineMacro("__NO_INLINE__");
1198 
1199   if (unsigned PICLevel = LangOpts.PICLevel) {
1200     Builder.defineMacro("__PIC__", Twine(PICLevel));
1201     Builder.defineMacro("__pic__", Twine(PICLevel));
1202     if (LangOpts.PIE) {
1203       Builder.defineMacro("__PIE__", Twine(PICLevel));
1204       Builder.defineMacro("__pie__", Twine(PICLevel));
1205     }
1206   }
1207 
1208   // Macros to control C99 numerics and <float.h>
1209   Builder.defineMacro("__FLT_RADIX__", "2");
1210   Builder.defineMacro("__DECIMAL_DIG__", "__LDBL_DECIMAL_DIG__");
1211 
1212   if (LangOpts.getStackProtector() == LangOptions::SSPOn)
1213     Builder.defineMacro("__SSP__");
1214   else if (LangOpts.getStackProtector() == LangOptions::SSPStrong)
1215     Builder.defineMacro("__SSP_STRONG__", "2");
1216   else if (LangOpts.getStackProtector() == LangOptions::SSPReq)
1217     Builder.defineMacro("__SSP_ALL__", "3");
1218 
1219   if (PPOpts.SetUpStaticAnalyzer)
1220     Builder.defineMacro("__clang_analyzer__");
1221 
1222   if (LangOpts.FastRelaxedMath)
1223     Builder.defineMacro("__FAST_RELAXED_MATH__");
1224 
1225   if (FEOpts.ProgramAction == frontend::RewriteObjC ||
1226       LangOpts.getGC() != LangOptions::NonGC) {
1227     Builder.defineMacro("__weak", "__attribute__((objc_gc(weak)))");
1228     Builder.defineMacro("__strong", "__attribute__((objc_gc(strong)))");
1229     Builder.defineMacro("__autoreleasing", "");
1230     Builder.defineMacro("__unsafe_unretained", "");
1231   } else if (LangOpts.ObjC) {
1232     Builder.defineMacro("__weak", "__attribute__((objc_ownership(weak)))");
1233     Builder.defineMacro("__strong", "__attribute__((objc_ownership(strong)))");
1234     Builder.defineMacro("__autoreleasing",
1235                         "__attribute__((objc_ownership(autoreleasing)))");
1236     Builder.defineMacro("__unsafe_unretained",
1237                         "__attribute__((objc_ownership(none)))");
1238   }
1239 
1240   // On Darwin, there are __double_underscored variants of the type
1241   // nullability qualifiers.
1242   if (TI.getTriple().isOSDarwin()) {
1243     Builder.defineMacro("__nonnull", "_Nonnull");
1244     Builder.defineMacro("__null_unspecified", "_Null_unspecified");
1245     Builder.defineMacro("__nullable", "_Nullable");
1246   }
1247 
1248   // Add a macro to differentiate between regular iOS/tvOS/watchOS targets and
1249   // the corresponding simulator targets.
1250   if (TI.getTriple().isOSDarwin() && TI.getTriple().isSimulatorEnvironment())
1251     Builder.defineMacro("__APPLE_EMBEDDED_SIMULATOR__", "1");
1252 
1253   // OpenMP definition
1254   // OpenMP 2.2:
1255   //   In implementations that support a preprocessor, the _OPENMP
1256   //   macro name is defined to have the decimal value yyyymm where
1257   //   yyyy and mm are the year and the month designations of the
1258   //   version of the OpenMP API that the implementation support.
1259   if (!LangOpts.OpenMPSimd) {
1260     switch (LangOpts.OpenMP) {
1261     case 0:
1262       break;
1263     case 31:
1264       Builder.defineMacro("_OPENMP", "201107");
1265       break;
1266     case 40:
1267       Builder.defineMacro("_OPENMP", "201307");
1268       break;
1269     case 45:
1270       Builder.defineMacro("_OPENMP", "201511");
1271       break;
1272     case 50:
1273       Builder.defineMacro("_OPENMP", "201811");
1274       break;
1275     case 52:
1276       Builder.defineMacro("_OPENMP", "202111");
1277       break;
1278     default: // case 51:
1279       // Default version is OpenMP 5.1
1280       Builder.defineMacro("_OPENMP", "202011");
1281       break;
1282     }
1283   }
1284 
1285   // CUDA device path compilaton
1286   if (LangOpts.CUDAIsDevice && !LangOpts.HIP) {
1287     // The CUDA_ARCH value is set for the GPU target specified in the NVPTX
1288     // backend's target defines.
1289     Builder.defineMacro("__CUDA_ARCH__");
1290   }
1291 
1292   // We need to communicate this to our CUDA header wrapper, which in turn
1293   // informs the proper CUDA headers of this choice.
1294   if (LangOpts.CUDADeviceApproxTranscendentals || LangOpts.FastMath) {
1295     Builder.defineMacro("__CLANG_CUDA_APPROX_TRANSCENDENTALS__");
1296   }
1297 
1298   // Define a macro indicating that the source file is being compiled with a
1299   // SYCL device compiler which doesn't produce host binary.
1300   if (LangOpts.SYCLIsDevice) {
1301     Builder.defineMacro("__SYCL_DEVICE_ONLY__", "1");
1302   }
1303 
1304   // OpenCL definitions.
1305   if (LangOpts.OpenCL) {
1306     InitializeOpenCLFeatureTestMacros(TI, LangOpts, Builder);
1307 
1308     if (TI.getTriple().isSPIR() || TI.getTriple().isSPIRV())
1309       Builder.defineMacro("__IMAGE_SUPPORT__");
1310   }
1311 
1312   if (TI.hasInt128Type() && LangOpts.CPlusPlus && LangOpts.GNUMode) {
1313     // For each extended integer type, g++ defines a macro mapping the
1314     // index of the type (0 in this case) in some list of extended types
1315     // to the type.
1316     Builder.defineMacro("__GLIBCXX_TYPE_INT_N_0", "__int128");
1317     Builder.defineMacro("__GLIBCXX_BITSIZE_INT_N_0", "128");
1318   }
1319 
1320   // ELF targets define __ELF__
1321   if (TI.getTriple().isOSBinFormatELF())
1322     Builder.defineMacro("__ELF__");
1323 
1324   // Get other target #defines.
1325   TI.getTargetDefines(LangOpts, Builder);
1326 }
1327 
1328 /// InitializePreprocessor - Initialize the preprocessor getting it and the
1329 /// environment ready to process a single file.
1330 void clang::InitializePreprocessor(
1331     Preprocessor &PP, const PreprocessorOptions &InitOpts,
1332     const PCHContainerReader &PCHContainerRdr,
1333     const FrontendOptions &FEOpts) {
1334   const LangOptions &LangOpts = PP.getLangOpts();
1335   std::string PredefineBuffer;
1336   PredefineBuffer.reserve(4080);
1337   llvm::raw_string_ostream Predefines(PredefineBuffer);
1338   MacroBuilder Builder(Predefines);
1339 
1340   // Emit line markers for various builtin sections of the file. The 3 here
1341   // marks <built-in> as being a system header, which suppresses warnings when
1342   // the same macro is defined multiple times.
1343   Builder.append("# 1 \"<built-in>\" 3");
1344 
1345   // Install things like __POWERPC__, __GNUC__, etc into the macro table.
1346   if (InitOpts.UsePredefines) {
1347     // FIXME: This will create multiple definitions for most of the predefined
1348     // macros. This is not the right way to handle this.
1349     if ((LangOpts.CUDA || LangOpts.OpenMPIsTargetDevice ||
1350          LangOpts.SYCLIsDevice) &&
1351         PP.getAuxTargetInfo())
1352       InitializePredefinedMacros(*PP.getAuxTargetInfo(), LangOpts, FEOpts,
1353                                  PP.getPreprocessorOpts(), Builder);
1354 
1355     InitializePredefinedMacros(PP.getTargetInfo(), LangOpts, FEOpts,
1356                                PP.getPreprocessorOpts(), Builder);
1357 
1358     // Install definitions to make Objective-C++ ARC work well with various
1359     // C++ Standard Library implementations.
1360     if (LangOpts.ObjC && LangOpts.CPlusPlus &&
1361         (LangOpts.ObjCAutoRefCount || LangOpts.ObjCWeak)) {
1362       switch (InitOpts.ObjCXXARCStandardLibrary) {
1363       case ARCXX_nolib:
1364       case ARCXX_libcxx:
1365         break;
1366 
1367       case ARCXX_libstdcxx:
1368         AddObjCXXARCLibstdcxxDefines(LangOpts, Builder);
1369         break;
1370       }
1371     }
1372   }
1373 
1374   // Even with predefines off, some macros are still predefined.
1375   // These should all be defined in the preprocessor according to the
1376   // current language configuration.
1377   InitializeStandardPredefinedMacros(PP.getTargetInfo(), PP.getLangOpts(),
1378                                      FEOpts, Builder);
1379 
1380   // Add on the predefines from the driver.  Wrap in a #line directive to report
1381   // that they come from the command line.
1382   Builder.append("# 1 \"<command line>\" 1");
1383 
1384   // Process #define's and #undef's in the order they are given.
1385   for (unsigned i = 0, e = InitOpts.Macros.size(); i != e; ++i) {
1386     if (InitOpts.Macros[i].second)  // isUndef
1387       Builder.undefineMacro(InitOpts.Macros[i].first);
1388     else
1389       DefineBuiltinMacro(Builder, InitOpts.Macros[i].first,
1390                          PP.getDiagnostics());
1391   }
1392 
1393   // Exit the command line and go back to <built-in> (2 is LC_LEAVE).
1394   Builder.append("# 1 \"<built-in>\" 2");
1395 
1396   // If -imacros are specified, include them now.  These are processed before
1397   // any -include directives.
1398   for (unsigned i = 0, e = InitOpts.MacroIncludes.size(); i != e; ++i)
1399     AddImplicitIncludeMacros(Builder, InitOpts.MacroIncludes[i]);
1400 
1401   // Process -include-pch/-include-pth directives.
1402   if (!InitOpts.ImplicitPCHInclude.empty())
1403     AddImplicitIncludePCH(Builder, PP, PCHContainerRdr,
1404                           InitOpts.ImplicitPCHInclude);
1405 
1406   // Process -include directives.
1407   for (unsigned i = 0, e = InitOpts.Includes.size(); i != e; ++i) {
1408     const std::string &Path = InitOpts.Includes[i];
1409     AddImplicitInclude(Builder, Path);
1410   }
1411 
1412   // Instruct the preprocessor to skip the preamble.
1413   PP.setSkipMainFilePreamble(InitOpts.PrecompiledPreambleBytes.first,
1414                              InitOpts.PrecompiledPreambleBytes.second);
1415 
1416   // Copy PredefinedBuffer into the Preprocessor.
1417   PP.setPredefines(std::move(PredefineBuffer));
1418 }
1419