ASTContext.h revision 8e6ac1d80055fa37b9b84029c7e751624ba7f84c
15f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer//===--- ASTContext.h - Context to hold long-lived AST nodes ----*- C++ -*-===// 25f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer// 35f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer// The LLVM Compiler Infrastructure 45f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer// 50bc735ffcfb223c0186419547abaa5c84482663eChris Lattner// This file is distributed under the University of Illinois Open Source 60bc735ffcfb223c0186419547abaa5c84482663eChris Lattner// License. See LICENSE.TXT for details. 75f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer// 85f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer//===----------------------------------------------------------------------===// 95f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer// 105f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer// This file defines the ASTContext interface. 115f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer// 125f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer//===----------------------------------------------------------------------===// 135f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 145f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer#ifndef LLVM_CLANG_AST_ASTCONTEXT_H 155f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer#define LLVM_CLANG_AST_ASTCONTEXT_H 165f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 172e1cd4264d363ca869bf37ef160902f211d21b8cDouglas Gregor#include "clang/Basic/IdentifierTable.h" 18e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek#include "clang/Basic/LangOptions.h" 199f9bf258f8ebae30bfb70feb9d797d6eb67b0460Douglas Gregor#include "clang/AST/Attr.h" 205f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer#include "clang/AST/Builtins.h" 21ad75653f81dece1c806e9c28dd7e7582c9929a27Ted Kremenek#include "clang/AST/Decl.h" 22ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor#include "clang/AST/NestedNameSpecifier.h" 23d249e1d1f1498b81314459ceda19d6ff25c278adDouglas Gregor#include "clang/AST/PrettyPrinter.h" 247532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor#include "clang/AST/TemplateName.h" 25464175bba1318bef7905122e9fda20cff926df78Chris Lattner#include "clang/AST/Type.h" 26e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar#include "clang/Basic/SourceLocation.h" 27464175bba1318bef7905122e9fda20cff926df78Chris Lattner#include "llvm/ADT/DenseMap.h" 2868d331a78e655d97294e94fcfa63f92cc1f40578Steve Naroff#include "llvm/ADT/FoldingSet.h" 292cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor#include "llvm/ADT/OwningPtr.h" 306c2b6eb8d836da19007f7540709e16d5e39a1cbaChris Lattner#include "llvm/Support/Allocator.h" 315f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer#include <vector> 325f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 33b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattnernamespace llvm { 34b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner struct fltSemantics; 35b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner} 36b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner 375f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencernamespace clang { 38a9376d470ccb0eac74fe09a6b2a18a890f1d17c4Chris Lattner class FileManager; 39e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class ASTRecordLayout; 40e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class Expr; 412cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor class ExternalASTSource; 42c7229c338c21ef26b01ef3ecf9eec4fd373fa9ecChris Lattner class IdentifierTable; 43e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class SelectorTable; 44e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class SourceManager; 45d934112e6170b0fd940d8e40db6936cea2cdcf62Douglas Gregor class TargetInfo; 46e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar // Decls 47e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class Decl; 48c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar class ObjCPropertyDecl; 49e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class RecordDecl; 50e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class TagDecl; 51e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class TranslationUnitDecl; 52e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class TypeDecl; 53e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class TypedefDecl; 5472c3f314d92d65c050ee1c07b7753623c044d6c7Douglas Gregor class TemplateTypeParmDecl; 55efc4c4bdbd8fee90b93deb3b5cfaeb044ae22557Fariborz Jahanian class FieldDecl; 56efc4c4bdbd8fee90b93deb3b5cfaeb044ae22557Fariborz Jahanian class ObjCIvarRefExpr; 57efc4c4bdbd8fee90b93deb3b5cfaeb044ae22557Fariborz Jahanian class ObjCIvarDecl; 58efc4c4bdbd8fee90b93deb3b5cfaeb044ae22557Fariborz Jahanian 595f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer/// ASTContext - This class holds long-lived AST nodes (such as types and 605f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer/// decls) that can be referred to throughout the semantic analysis of a file. 612bd24ba6d10f8c811c8e2a57c8397e07082ba497Ted Kremenekclass ASTContext { 625f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer std::vector<Type*> Types; 63f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian llvm::FoldingSet<ExtQualType> ExtQualTypes; 645f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer llvm::FoldingSet<ComplexType> ComplexTypes; 655f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer llvm::FoldingSet<PointerType> PointerTypes; 665618bd4a52c45fbbb605e3ba885663b2164db8a3Steve Naroff llvm::FoldingSet<BlockPointerType> BlockPointerTypes; 677c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl llvm::FoldingSet<LValueReferenceType> LValueReferenceTypes; 687c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl llvm::FoldingSet<RValueReferenceType> RValueReferenceTypes; 69f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl llvm::FoldingSet<MemberPointerType> MemberPointerTypes; 707192f8e9592729882a09d84d77838db26e39ebd4Ted Kremenek llvm::FoldingSet<ConstantArrayType> ConstantArrayTypes; 71c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman llvm::FoldingSet<IncompleteArrayType> IncompleteArrayTypes; 72c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman std::vector<VariableArrayType*> VariableArrayTypes; 73898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor std::vector<DependentSizedArrayType*> DependentSizedArrayTypes; 745f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer llvm::FoldingSet<VectorType> VectorTypes; 7572564e73277e29f6db3305d1f27ba408abb7ed88Douglas Gregor llvm::FoldingSet<FunctionNoProtoType> FunctionNoProtoTypes; 7672564e73277e29f6db3305d1f27ba408abb7ed88Douglas Gregor llvm::FoldingSet<FunctionProtoType> FunctionProtoTypes; 77fab9d67cebb87be968e7ae31a3b549a5279b5d51Douglas Gregor llvm::FoldingSet<TemplateTypeParmType> TemplateTypeParmTypes; 787532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor llvm::FoldingSet<TemplateSpecializationType> TemplateSpecializationTypes; 79e4e5b054b4917f0ee493bb2fda5b1ec749bfb9a1Douglas Gregor llvm::FoldingSet<QualifiedNameType> QualifiedNameTypes; 80d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor llvm::FoldingSet<TypenameType> TypenameTypes; 81a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek llvm::FoldingSet<ObjCQualifiedInterfaceType> ObjCQualifiedInterfaceTypes; 82a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek llvm::FoldingSet<ObjCQualifiedIdType> ObjCQualifiedIdTypes; 83ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor 847532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor llvm::FoldingSet<QualifiedTemplateName> QualifiedTemplateNames; 857532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor llvm::FoldingSet<DependentTemplateName> DependentTemplateNames; 867532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor 87ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor /// \brief The set of nested name specifiers. 88ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor /// 89ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor /// This set is managed by the NestedNameSpecifier class. 90ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor llvm::FoldingSet<NestedNameSpecifier> NestedNameSpecifiers; 91ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor NestedNameSpecifier *GlobalNestedNameSpecifier; 92ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor friend class NestedNameSpecifier; 93ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor 9488a981b47c7face1b1fdaa9074256245107b9ca9Devang Patel /// ASTRecordLayouts - A cache mapping from RecordDecls to ASTRecordLayouts. 95a9a4a24592a2164114a8a36717650e6341eb67a4Ted Kremenek /// This is lazily created. This is intentionally not serialized. 9688a981b47c7face1b1fdaa9074256245107b9ca9Devang Patel llvm::DenseMap<const RecordDecl*, const ASTRecordLayout*> ASTRecordLayouts; 97b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar llvm::DenseMap<const ObjCContainerDecl*, const ASTRecordLayout*> ObjCLayouts; 98f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman 99f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman llvm::DenseMap<unsigned, FixedWidthIntType*> SignedFixedWidthIntTypes; 100f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman llvm::DenseMap<unsigned, FixedWidthIntType*> UnsignedFixedWidthIntTypes; 101a769c004a2874504c17ea8afccbc4ad35fc33c9fFariborz Jahanian 102b2cf3573d7351094f6247fcca94703ce88eb9ee0Anders Carlsson /// BuiltinVaListType - built-in va list type. 103b2cf3573d7351094f6247fcca94703ce88eb9ee0Anders Carlsson /// This is initially null and set by Sema::LazilyCreateBuiltin when 104b2cf3573d7351094f6247fcca94703ce88eb9ee0Anders Carlsson /// a builtin that takes a valist is encountered. 105b2cf3573d7351094f6247fcca94703ce88eb9ee0Anders Carlsson QualType BuiltinVaListType; 1067e219e47de26346885d667131977bd9ca2d7662aSteve Naroff 1076083ea3723ec3996ae3bdf8d1b352b0c3b3922c8Ted Kremenek /// ObjCIdType - a pseudo built-in typedef type (set by Sema). 108a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType ObjCIdType; 1097e219e47de26346885d667131977bd9ca2d7662aSteve Naroff const RecordType *IdStructType; 1102198891824c38d45b2279de5d5e3ef9394eb457cSteve Naroff 1116083ea3723ec3996ae3bdf8d1b352b0c3b3922c8Ted Kremenek /// ObjCSelType - another pseudo built-in typedef type (set by Sema). 112a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType ObjCSelType; 113b62f6813406a03bf8a371c4e46c9fad51d102121Fariborz Jahanian const RecordType *SelStructType; 114b62f6813406a03bf8a371c4e46c9fad51d102121Fariborz Jahanian 1156083ea3723ec3996ae3bdf8d1b352b0c3b3922c8Ted Kremenek /// ObjCProtoType - another pseudo built-in typedef type (set by Sema). 116a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType ObjCProtoType; 117390d50a725497e99247dc104a7d2c2a255d3af14Fariborz Jahanian const RecordType *ProtoStructType; 1188baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson 1196083ea3723ec3996ae3bdf8d1b352b0c3b3922c8Ted Kremenek /// ObjCClassType - another pseudo built-in typedef type (set by Sema). 120a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType ObjCClassType; 1218baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson const RecordType *ClassStructType; 122390d50a725497e99247dc104a7d2c2a255d3af14Fariborz Jahanian 123a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType ObjCConstantStringType; 1242198891824c38d45b2279de5d5e3ef9394eb457cSteve Naroff RecordDecl *CFConstantStringTypeDecl; 1257a9d49fd2bfac00e905b361ba76d26ab5b6c3b09Ted Kremenek 126bd4c1ada2e8668f43a865dc2c662085cf61940c4Anders Carlsson RecordDecl *ObjCFastEnumerationStateTypeDecl; 127bd4c1ada2e8668f43a865dc2c662085cf61940c4Anders Carlsson 128ef177820100ab583b08fd3056e2a5a52ee4b1629Argyrios Kyrtzidis TranslationUnitDecl *TUDecl; 129ef177820100ab583b08fd3056e2a5a52ee4b1629Argyrios Kyrtzidis 130e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek /// SourceMgr - The associated SourceManager object. 131b800dc2d5e27ec60f567567b623cdc61152b8fb8Chris Lattner SourceManager &SourceMgr; 132e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek 133e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek /// LangOpts - The language options used to create the AST associated with 134e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek /// this ASTContext object. 135e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek LangOptions LangOpts; 136e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek 137c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff /// MallocAlloc/BumpAlloc - The allocator objects used to create AST objects. 138c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff bool FreeMemory; 139c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff llvm::MallocAllocator MallocAlloc; 140c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff llvm::BumpPtrAllocator BumpAlloc; 1416ab3524f72a6e64aa04973fa9433b5559abb3525Douglas Gregorpublic: 1425f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer TargetInfo &Target; 14371993dd85eed9cc42c6b2fa61ee5c53026b74817Anders Carlsson IdentifierTable &Idents; 14429238a0bf7cbf5b396efb451a0adb5fe4aa037caSteve Naroff SelectorTable &Selectors; 1452e1cd4264d363ca869bf37ef160902f211d21b8cDouglas Gregor DeclarationNameTable DeclarationNames; 1462cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor llvm::OwningPtr<ExternalASTSource> ExternalSource; 147d249e1d1f1498b81314459ceda19d6ff25c278adDouglas Gregor clang::PrintingPolicy PrintingPolicy; 1482e1cd4264d363ca869bf37ef160902f211d21b8cDouglas Gregor 1497a9d49fd2bfac00e905b361ba76d26ab5b6c3b09Ted Kremenek SourceManager& getSourceManager() { return SourceMgr; } 150a9376d470ccb0eac74fe09a6b2a18a890f1d17c4Chris Lattner const SourceManager& getSourceManager() const { return SourceMgr; } 151c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff void *Allocate(unsigned Size, unsigned Align = 8) { 152c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff return FreeMemory ? MallocAlloc.Allocate(Size, Align) : 153c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff BumpAlloc.Allocate(Size, Align); 154c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff } 155c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff void Deallocate(void *Ptr) { 156c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff if (FreeMemory) 157c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff MallocAlloc.Deallocate(Ptr); 158c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff } 159e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek const LangOptions& getLangOptions() const { return LangOpts; } 1606c2b6eb8d836da19007f7540709e16d5e39a1cbaChris Lattner 1619c728dc4d8da89c73fcae74c9e72d7a83ffd7b6dTed Kremenek FullSourceLoc getFullLoc(SourceLocation Loc) const { 1629c728dc4d8da89c73fcae74c9e72d7a83ffd7b6dTed Kremenek return FullSourceLoc(Loc,SourceMgr); 1639c728dc4d8da89c73fcae74c9e72d7a83ffd7b6dTed Kremenek } 164ef177820100ab583b08fd3056e2a5a52ee4b1629Argyrios Kyrtzidis 165ef177820100ab583b08fd3056e2a5a52ee4b1629Argyrios Kyrtzidis TranslationUnitDecl *getTranslationUnitDecl() const { return TUDecl; } 166ef177820100ab583b08fd3056e2a5a52ee4b1629Argyrios Kyrtzidis 1675f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer Builtin::Context BuiltinInfo; 1685f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 1695f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer // Builtin Types. 1705f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType VoidTy; 1715f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType BoolTy; 1725f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType CharTy; 1733a2503227c3db04a3619735127483263c1075ef7Chris Lattner QualType WCharTy; // [C++ 3.9.1p5], integer type in C99. 1742df9ced9fd1e8c7d7b38443db07e0e811de22571Chris Lattner QualType SignedCharTy, ShortTy, IntTy, LongTy, LongLongTy, Int128Ty; 1755f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType UnsignedCharTy, UnsignedShortTy, UnsignedIntTy, UnsignedLongTy; 1762df9ced9fd1e8c7d7b38443db07e0e811de22571Chris Lattner QualType UnsignedLongLongTy, UnsignedInt128Ty; 1775f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType FloatTy, DoubleTy, LongDoubleTy; 1785f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType FloatComplexTy, DoubleComplexTy, LongDoubleComplexTy; 1796e8ed16ffef02b82995a90bdcf10ffff7d63839aSebastian Redl QualType VoidPtrTy, NullPtrTy; 1808e9bebdea69c590dedfbf27374114cb76fe12fbdDouglas Gregor QualType OverloadTy; 181898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor QualType DependentTy; 1828e9bebdea69c590dedfbf27374114cb76fe12fbdDouglas Gregor 183e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek ASTContext(const LangOptions& LOpts, SourceManager &SM, TargetInfo &t, 184c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff IdentifierTable &idents, SelectorTable &sels, 1852deaea37a637dd01221d0cced343702a39d8132cDouglas Gregor bool FreeMemory = true, unsigned size_reserve=0, 1862deaea37a637dd01221d0cced343702a39d8132cDouglas Gregor bool InitializeBuiltins = true); 187fee0452973f28691a61aab0fb074468ce3e34b9bTed Kremenek 1885f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer ~ASTContext(); 1896ab3524f72a6e64aa04973fa9433b5559abb3525Douglas Gregor 1902deaea37a637dd01221d0cced343702a39d8132cDouglas Gregor /// \brief Initialize builtins. 1912deaea37a637dd01221d0cced343702a39d8132cDouglas Gregor /// 1922deaea37a637dd01221d0cced343702a39d8132cDouglas Gregor /// Typically, this routine will be called automatically by the 1932deaea37a637dd01221d0cced343702a39d8132cDouglas Gregor /// constructor. However, in certain cases (e.g., when there is a 1942deaea37a637dd01221d0cced343702a39d8132cDouglas Gregor /// PCH file to be loaded), the constructor does not perform 1952deaea37a637dd01221d0cced343702a39d8132cDouglas Gregor /// initialization for builtins. This routine can be called to 1962deaea37a637dd01221d0cced343702a39d8132cDouglas Gregor /// perform the initialization. 1972deaea37a637dd01221d0cced343702a39d8132cDouglas Gregor void InitializeBuiltins(IdentifierTable &idents); 1982deaea37a637dd01221d0cced343702a39d8132cDouglas Gregor 1992cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// \brief Attach an external AST source to the AST context. 2002cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// 2012cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// The external AST source provides the ability to load parts of 2022cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// the abstract syntax tree as needed from some external storage, 2032cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// e.g., a precompiled header. 2042cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor void setExternalSource(llvm::OwningPtr<ExternalASTSource> &Source); 2052cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor 2062cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// \brief Retrieve a pointer to the external AST source associated 2072cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// with this AST context, if any. 2082cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor ExternalASTSource *getExternalSource() const { return ExternalSource.get(); } 2092cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor 2105f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer void PrintStats() const; 21103ed44061df258e74a40383bda849e14b892a8c6Ted Kremenek const std::vector<Type*>& getTypes() const { return Types; } 212d249e1d1f1498b81314459ceda19d6ff25c278adDouglas Gregor 213464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 214464175bba1318bef7905122e9fda20cff926df78Chris Lattner // Type Constructors 215464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 216d2d2a11a91d7ddf468bfb70f66362d24806ed601Chris Lattner 217f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian /// getAddSpaceQualType - Return the uniqued reference to the type for an 218f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian /// address space qualified type with the specified type and address space. 219f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian /// The resulting type has a union of the qualifiers from T and the address 220f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian /// space. If T already has an address space specifier, it is silently 221f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian /// replaced. 222f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian QualType getAddrSpaceQualType(QualType T, unsigned AddressSpace); 223ebb97e98c03f8d7034bd3748a10e35f39a95c289Christopher Lamb 224d33d9c0cc0cfdcd0b10f35a6acdfb25da4a64f19Fariborz Jahanian /// getObjCGCQualType - Returns the uniqued reference to the type for an 225d33d9c0cc0cfdcd0b10f35a6acdfb25da4a64f19Fariborz Jahanian /// objc gc qualified type. The retulting type has a union of the qualifiers 226d33d9c0cc0cfdcd0b10f35a6acdfb25da4a64f19Fariborz Jahanian /// from T and the gc attribute. 227d33d9c0cc0cfdcd0b10f35a6acdfb25da4a64f19Fariborz Jahanian QualType getObjCGCQualType(QualType T, QualType::GCAttrTypes gcAttr); 228d33d9c0cc0cfdcd0b10f35a6acdfb25da4a64f19Fariborz Jahanian 2295f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getComplexType - Return the uniqued reference to the type for a complex 2305f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// number with the specified element type. 2315f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getComplexType(QualType T); 2325f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 2335f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getPointerType - Return the uniqued reference to the type for a pointer to 2345f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// the specified type. 2355f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getPointerType(QualType T); 2365618bd4a52c45fbbb605e3ba885663b2164db8a3Steve Naroff 2375618bd4a52c45fbbb605e3ba885663b2164db8a3Steve Naroff /// getBlockPointerType - Return the uniqued reference to the type for a block 2385618bd4a52c45fbbb605e3ba885663b2164db8a3Steve Naroff /// of the specified type. 2395618bd4a52c45fbbb605e3ba885663b2164db8a3Steve Naroff QualType getBlockPointerType(QualType T); 240f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl 2417c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl /// getLValueReferenceType - Return the uniqued reference to the type for an 2427c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl /// lvalue reference to the specified type. 2437c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl QualType getLValueReferenceType(QualType T); 2447c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl 2457c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl /// getRValueReferenceType - Return the uniqued reference to the type for an 2467c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl /// rvalue reference to the specified type. 2477c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl QualType getRValueReferenceType(QualType T); 248f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl 249f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl /// getMemberPointerType - Return the uniqued reference to the type for a 250f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl /// member pointer to the specified type in the specified class. The class 251f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl /// is a Type because it could be a dependent name. 252f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl QualType getMemberPointerType(QualType T, const Type *Cls); 253f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl 254bdbf7b030a3e0ddb95240076683830e6f78c79a5Steve Naroff /// getVariableArrayType - Returns a non-unique reference to the type for a 255bdbf7b030a3e0ddb95240076683830e6f78c79a5Steve Naroff /// variable array of the specified element type. 256c9406125e2cac9208098655ac8058c095c2c3a65Steve Naroff QualType getVariableArrayType(QualType EltTy, Expr *NumElts, 257c9406125e2cac9208098655ac8058c095c2c3a65Steve Naroff ArrayType::ArraySizeModifier ASM, 258c9406125e2cac9208098655ac8058c095c2c3a65Steve Naroff unsigned EltTypeQuals); 259898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor 260898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor /// getDependentSizedArrayType - Returns a non-unique reference to 261898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor /// the type for a dependently-sized array of the specified element 262898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor /// type. FIXME: We will need these to be uniqued, or at least 263898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor /// comparable, at some point. 264898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor QualType getDependentSizedArrayType(QualType EltTy, Expr *NumElts, 265fea8685bf3036b199c573e70b03affde2583fc44Nate Begeman ArrayType::ArraySizeModifier ASM, 266fea8685bf3036b199c573e70b03affde2583fc44Nate Begeman unsigned EltTypeQuals); 267fb22d96692c5240fb8d611290dbf7eeed3759c73Steve Naroff 268c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman /// getIncompleteArrayType - Returns a unique reference to the type for a 269c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman /// incomplete array of the specified element type. 270c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman QualType getIncompleteArrayType(QualType EltTy, 271c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman ArrayType::ArraySizeModifier ASM, 272c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman unsigned EltTypeQuals); 273c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman 274bdbf7b030a3e0ddb95240076683830e6f78c79a5Steve Naroff /// getConstantArrayType - Return the unique reference to the type for a 275bdbf7b030a3e0ddb95240076683830e6f78c79a5Steve Naroff /// constant array of the specified element type. 276c9406125e2cac9208098655ac8058c095c2c3a65Steve Naroff QualType getConstantArrayType(QualType EltTy, const llvm::APInt &ArySize, 277c9406125e2cac9208098655ac8058c095c2c3a65Steve Naroff ArrayType::ArraySizeModifier ASM, 278c9406125e2cac9208098655ac8058c095c2c3a65Steve Naroff unsigned EltTypeQuals); 2795f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 28073322924127c873c13101b705dd823f5539ffa5fSteve Naroff /// getVectorType - Return the unique reference to a vector type of 28173322924127c873c13101b705dd823f5539ffa5fSteve Naroff /// the specified element type and size. VectorType must be a built-in type. 28273322924127c873c13101b705dd823f5539ffa5fSteve Naroff QualType getVectorType(QualType VectorType, unsigned NumElts); 28373322924127c873c13101b705dd823f5539ffa5fSteve Naroff 284213541a68a3e137d11d2cefb612c6cdb410d7e8eNate Begeman /// getExtVectorType - Return the unique reference to an extended vector type 285213541a68a3e137d11d2cefb612c6cdb410d7e8eNate Begeman /// of the specified element type and size. VectorType must be a built-in 286213541a68a3e137d11d2cefb612c6cdb410d7e8eNate Begeman /// type. 287213541a68a3e137d11d2cefb612c6cdb410d7e8eNate Begeman QualType getExtVectorType(QualType VectorType, unsigned NumElts); 2885f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 28972564e73277e29f6db3305d1f27ba408abb7ed88Douglas Gregor /// getFunctionNoProtoType - Return a K&R style C function type like 'int()'. 2905f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// 29172564e73277e29f6db3305d1f27ba408abb7ed88Douglas Gregor QualType getFunctionNoProtoType(QualType ResultTy); 292465226e23a3008bd68973513dda1f9e3cd27dbddSebastian Redl 2935f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getFunctionType - Return a normal function type with a typed argument 2945f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// list. isVariadic indicates whether the argument list includes '...'. 29586da77fdaf4c0237eafb9670f54eee20b08635bfEli Friedman QualType getFunctionType(QualType ResultTy, const QualType *ArgArray, 296971c4fae6092976338b755af1d47dac07c8f16e3Argyrios Kyrtzidis unsigned NumArgs, bool isVariadic, 297465226e23a3008bd68973513dda1f9e3cd27dbddSebastian Redl unsigned TypeQuals, bool hasExceptionSpec = false, 298465226e23a3008bd68973513dda1f9e3cd27dbddSebastian Redl bool hasAnyExceptionSpec = false, 299465226e23a3008bd68973513dda1f9e3cd27dbddSebastian Redl unsigned NumExs = 0, const QualType *ExArray = 0); 3002ce52f3fb95bf544db6bd3d91a72bce7d9cceb6cDouglas Gregor 3012ce52f3fb95bf544db6bd3d91a72bce7d9cceb6cDouglas Gregor /// getTypeDeclType - Return the unique reference to the type for 3022ce52f3fb95bf544db6bd3d91a72bce7d9cceb6cDouglas Gregor /// the specified type declaration. 3034b7c98378ae0c1a3635f0b7756848b4a9923f8bcTed Kremenek QualType getTypeDeclType(TypeDecl *Decl, TypeDecl* PrevDecl=0); 3042ce52f3fb95bf544db6bd3d91a72bce7d9cceb6cDouglas Gregor 3055f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getTypedefType - Return the unique reference to the type for the 3065f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// specified typename decl. 3075f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getTypedefType(TypedefDecl *Decl); 3083b3a45858c6b2a45114e91902c3bf3c4b7f5f302Daniel Dunbar QualType getObjCInterfaceType(const ObjCInterfaceDecl *Decl); 309fab9d67cebb87be968e7ae31a3b549a5279b5d51Douglas Gregor 310fab9d67cebb87be968e7ae31a3b549a5279b5d51Douglas Gregor QualType getTemplateTypeParmType(unsigned Depth, unsigned Index, 311fab9d67cebb87be968e7ae31a3b549a5279b5d51Douglas Gregor IdentifierInfo *Name = 0); 312fab9d67cebb87be968e7ae31a3b549a5279b5d51Douglas Gregor 3137532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor QualType getTemplateSpecializationType(TemplateName T, 3147532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor const TemplateArgument *Args, 3157532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor unsigned NumArgs, 3167532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor QualType Canon = QualType()); 31755f6b14230c94272efbbcdd89a92224c8db9f225Douglas Gregor 318ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor QualType getQualifiedNameType(NestedNameSpecifier *NNS, 319e4e5b054b4917f0ee493bb2fda5b1ec749bfb9a1Douglas Gregor QualType NamedType); 320d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor QualType getTypenameType(NestedNameSpecifier *NNS, 321d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor const IdentifierInfo *Name, 322d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor QualType Canon = QualType()); 3231734317845d60307d474b5da8a8d33adbaf5e723Douglas Gregor QualType getTypenameType(NestedNameSpecifier *NNS, 3241734317845d60307d474b5da8a8d33adbaf5e723Douglas Gregor const TemplateSpecializationType *TemplateId, 3251734317845d60307d474b5da8a8d33adbaf5e723Douglas Gregor QualType Canon = QualType()); 326e4e5b054b4917f0ee493bb2fda5b1ec749bfb9a1Douglas Gregor 327a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek /// getObjCQualifiedInterfaceType - Return a 328a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek /// ObjCQualifiedInterfaceType type for the given interface decl and 3294b6c9051c6522894978c9ba6a819a659d102db36Fariborz Jahanian /// the conforming protocol list. 330a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType getObjCQualifiedInterfaceType(ObjCInterfaceDecl *Decl, 33192dd386e3f05d176b45a638199d51f536bd9d1c4Chris Lattner ObjCProtocolDecl **ProtocolList, 33292dd386e3f05d176b45a638199d51f536bd9d1c4Chris Lattner unsigned NumProtocols); 333c569249ca0ab755ac79d8cbbfcb2bcae19743624Fariborz Jahanian 334a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek /// getObjCQualifiedIdType - Return an ObjCQualifiedIdType for a 335c569249ca0ab755ac79d8cbbfcb2bcae19743624Fariborz Jahanian /// given 'id' and conforming protocol list. 33662f5f7ffad57e0c2af2b308af3735351505937cbChris Lattner QualType getObjCQualifiedIdType(ObjCProtocolDecl **ProtocolList, 337c569249ca0ab755ac79d8cbbfcb2bcae19743624Fariborz Jahanian unsigned NumProtocols); 338c569249ca0ab755ac79d8cbbfcb2bcae19743624Fariborz Jahanian 3395f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 340d1861fd633d5096a00777c918eb8575ea7162fe7Steve Naroff /// getTypeOfType - GCC extension. 34172564e73277e29f6db3305d1f27ba408abb7ed88Douglas Gregor QualType getTypeOfExprType(Expr *e); 342d1861fd633d5096a00777c918eb8575ea7162fe7Steve Naroff QualType getTypeOfType(QualType t); 343d1861fd633d5096a00777c918eb8575ea7162fe7Steve Naroff 3445f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getTagDeclType - Return the unique reference to the type for the 3455f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// specified TagDecl (struct/union/class/enum) decl. 3465f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getTagDeclType(TagDecl *Decl); 3475f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 3485f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getSizeType - Return the unique type for "size_t" (C99 7.17), defined 3495f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// in <stddef.h>. The sizeof operator requires this (C99 6.5.3.4p4). 3505f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getSizeType() const; 351fd888a581d6d329f5b447c8ff4d37cf396315993Eli Friedman 3523a2503227c3db04a3619735127483263c1075ef7Chris Lattner /// getWCharType - In C++, this returns the unique wchar_t type. In C99, this 3533a2503227c3db04a3619735127483263c1075ef7Chris Lattner /// returns a type compatible with the type defined in <stddef.h> as defined 3543a2503227c3db04a3619735127483263c1075ef7Chris Lattner /// by the target. 3553a2503227c3db04a3619735127483263c1075ef7Chris Lattner QualType getWCharType() const { return WCharTy; } 35664c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis 35764c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis /// getSignedWCharType - Return the type of "signed wchar_t". 35864c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis /// Used when in C++, as a GCC extension. 35964c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis QualType getSignedWCharType() const; 36064c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis 36164c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis /// getUnsignedWCharType - Return the type of "unsigned wchar_t". 36264c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis /// Used when in C++, as a GCC extension. 36364c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis QualType getUnsignedWCharType() const; 3645f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 3658b9023ba35a86838789e2c9034a6128728c547aaChris Lattner /// getPointerDiffType - Return the unique type for "ptrdiff_t" (ref?) 3668b9023ba35a86838789e2c9034a6128728c547aaChris Lattner /// defined in <stddef.h>. Pointer - pointer requires this (C99 6.5.6p9). 3678b9023ba35a86838789e2c9034a6128728c547aaChris Lattner QualType getPointerDiffType() const; 3688b9023ba35a86838789e2c9034a6128728c547aaChris Lattner 369beaf299a2701c5559a4e5d76b0c40f805afb8e6aSteve Naroff // getCFConstantStringType - Return the C structure type used to represent 370beaf299a2701c5559a4e5d76b0c40f805afb8e6aSteve Naroff // constant CFStrings. 37171993dd85eed9cc42c6b2fa61ee5c53026b74817Anders Carlsson QualType getCFConstantStringType(); 37271993dd85eed9cc42c6b2fa61ee5c53026b74817Anders Carlsson 373319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor /// Get the structure type used to representation CFStrings, or NULL 374319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor /// if it hasn't yet been built. 375319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor QualType getRawCFConstantStringType() { 376319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor if (CFConstantStringTypeDecl) 377319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor return getTagDeclType(CFConstantStringTypeDecl); 378319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor return QualType(); 379319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor } 380319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor void setCFConstantStringType(QualType T); 381319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor 382983df5b2280980e59b0b062bcc2882230465a61eSteve Naroff // This setter/getter represents the ObjC type for an NSConstantString. 383a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek void setObjCConstantStringInterface(ObjCInterfaceDecl *Decl); 384a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType getObjCConstantStringInterface() const { 385a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek return ObjCConstantStringType; 3862198891824c38d45b2279de5d5e3ef9394eb457cSteve Naroff } 387b62f6813406a03bf8a371c4e46c9fad51d102121Fariborz Jahanian 388bd4c1ada2e8668f43a865dc2c662085cf61940c4Anders Carlsson //// This gets the struct used to keep track of fast enumerations. 389bd4c1ada2e8668f43a865dc2c662085cf61940c4Anders Carlsson QualType getObjCFastEnumerationStateType(); 390bd4c1ada2e8668f43a865dc2c662085cf61940c4Anders Carlsson 391319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor /// Get the ObjCFastEnumerationState type, or NULL if it hasn't yet 392319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor /// been built. 393319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor QualType getRawObjCFastEnumerationStateType() { 394319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor if (ObjCFastEnumerationStateTypeDecl) 395319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor return getTagDeclType(ObjCFastEnumerationStateTypeDecl); 396319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor return QualType(); 397319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor } 398319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor 399319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor void setObjCFastEnumerationStateType(QualType T); 400319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor 401d96b35bc6becf8db00d140c11e3d0e53f27567a1Daniel Dunbar /// getObjCEncodingForType - Emit the ObjC type encoding for the 402d96b35bc6becf8db00d140c11e3d0e53f27567a1Daniel Dunbar /// given type into \arg S. If \arg NameFields is specified then 403d96b35bc6becf8db00d140c11e3d0e53f27567a1Daniel Dunbar /// record field names are also encoded. 4047d6b46d9a9d75dea8ef9f6973dd50633c1f37963Fariborz Jahanian void getObjCEncodingForType(QualType t, std::string &S, 405153bfe5795e2c1a5a738e73d3784964e082237fcDaniel Dunbar const FieldDecl *Field=0); 406a1c033e9514865f3a7b0d8b3b20e6de926cfec6cFariborz Jahanian 407a1c033e9514865f3a7b0d8b3b20e6de926cfec6cFariborz Jahanian void getLegacyIntegralTypeEncoding(QualType &t) const; 40833e1d64ab5cd5d27f8530ccd056191fe2c9f3f2eFariborz Jahanian 409ecb01e666665efabd2aa76a76f6080e2a78965faFariborz Jahanian // Put the string version of type qualifiers into S. 410a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek void getObjCEncodingForTypeQualifier(Decl::ObjCDeclQualifier QT, 411ecb01e666665efabd2aa76a76f6080e2a78965faFariborz Jahanian std::string &S) const; 412ecb01e666665efabd2aa76a76f6080e2a78965faFariborz Jahanian 413a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek /// getObjCEncodingForMethodDecl - Return the encoded type for this method 41433e1d64ab5cd5d27f8530ccd056191fe2c9f3f2eFariborz Jahanian /// declaration. 415c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar void getObjCEncodingForMethodDecl(const ObjCMethodDecl *Decl, std::string &S); 416c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar 417c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar /// getObjCEncodingForPropertyDecl - Return the encoded type for 418c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar /// this method declaration. If non-NULL, Container must be either 419c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar /// an ObjCCategoryImplDecl or ObjCImplementationDecl; it should 420c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar /// only be NULL when getting encodings for protocol properties. 42177a49f6b1e5741f6bda71eb7837b43343925027bArgyrios Kyrtzidis void getObjCEncodingForPropertyDecl(const ObjCPropertyDecl *PD, 422c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar const Decl *Container, 423c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar std::string &S); 42433e1d64ab5cd5d27f8530ccd056191fe2c9f3f2eFariborz Jahanian 425a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek /// getObjCEncodingTypeSize returns size of type for objective-c encoding 42633e1d64ab5cd5d27f8530ccd056191fe2c9f3f2eFariborz Jahanian /// purpose. 427a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek int getObjCEncodingTypeSize(QualType t); 42885f9bceab1542aafff012d4d28e998f4ba16e362Anders Carlsson 429d85376aa66bc16488539f6bb11f97d0170b1fe6bChris Lattner /// This setter/getter represents the ObjC 'id' type. It is setup lazily, by 430d85376aa66bc16488539f6bb11f97d0170b1fe6bChris Lattner /// Sema. id is always a (typedef for a) pointer type, a pointer to a struct. 431a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType getObjCIdType() const { return ObjCIdType; } 432319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor void setObjCIdType(QualType T); 433b62f6813406a03bf8a371c4e46c9fad51d102121Fariborz Jahanian 434319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor void setObjCSelType(QualType T); 435a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType getObjCSelType() const { return ObjCSelType; } 436b62f6813406a03bf8a371c4e46c9fad51d102121Fariborz Jahanian 437a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek void setObjCProtoType(QualType QT); 438a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType getObjCProtoType() const { return ObjCProtoType; } 439390d50a725497e99247dc104a7d2c2a255d3af14Fariborz Jahanian 440d85376aa66bc16488539f6bb11f97d0170b1fe6bChris Lattner /// This setter/getter repreents the ObjC 'Class' type. It is setup lazily, by 441d85376aa66bc16488539f6bb11f97d0170b1fe6bChris Lattner /// Sema. 'Class' is always a (typedef for a) pointer type, a pointer to a 442d85376aa66bc16488539f6bb11f97d0170b1fe6bChris Lattner /// struct. 443a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType getObjCClassType() const { return ObjCClassType; } 444319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor void setObjCClassType(QualType T); 4458baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson 446b2cf3573d7351094f6247fcca94703ce88eb9ee0Anders Carlsson void setBuiltinVaListType(QualType T); 447b2cf3573d7351094f6247fcca94703ce88eb9ee0Anders Carlsson QualType getBuiltinVaListType() const { return BuiltinVaListType; } 448f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman 449f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman QualType getFixedWidthIntType(unsigned Width, bool Signed); 450f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman 4517532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor TemplateName getQualifiedTemplateName(NestedNameSpecifier *NNS, 4527532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor bool TemplateKeyword, 4537532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor TemplateDecl *Template); 4547532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor 4557532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor TemplateName getDependentTemplateName(NestedNameSpecifier *NNS, 4567532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor const IdentifierInfo *Name); 4577532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor 458d934112e6170b0fd940d8e40db6936cea2cdcf62Douglas Gregorprivate: 459d934112e6170b0fd940d8e40db6936cea2cdcf62Douglas Gregor QualType getFromTargetType(unsigned Type) const; 460b4e66d5259f90e9aae4d40fc5de801e046c7df94Douglas Gregor 461464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 462b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek // Type Predicates. 463b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek //===--------------------------------------------------------------------===// 464d934112e6170b0fd940d8e40db6936cea2cdcf62Douglas Gregor 465d934112e6170b0fd940d8e40db6936cea2cdcf62Douglas Gregorpublic: 466b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek /// isObjCObjectPointerType - Returns true if type is an Objective-C pointer 467b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek /// to an object type. This includes "id" and "Class" (two 'special' pointers 468b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek /// to struct), Interface* (pointer to ObjCInterfaceType) and id<P> (qualified 469b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek /// ID type). 470b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek bool isObjCObjectPointerType(QualType Ty) const; 4714fd83ea566f4a0c083001c84b75da6cc8c99c1d6Fariborz Jahanian 4724fd83ea566f4a0c083001c84b75da6cc8c99c1d6Fariborz Jahanian /// getObjCGCAttr - Returns one of GCNone, Weak or Strong objc's 4734fd83ea566f4a0c083001c84b75da6cc8c99c1d6Fariborz Jahanian /// garbage collection attribute. 4744fd83ea566f4a0c083001c84b75da6cc8c99c1d6Fariborz Jahanian /// 4754fd83ea566f4a0c083001c84b75da6cc8c99c1d6Fariborz Jahanian QualType::GCAttrTypes getObjCGCAttrKind(const QualType &Ty) const; 476fa23c1d9adc99c662c1c0e192817185809d95614Fariborz Jahanian 477fa23c1d9adc99c662c1c0e192817185809d95614Fariborz Jahanian /// isObjCNSObjectType - Return true if this is an NSObject object with 478fa23c1d9adc99c662c1c0e192817185809d95614Fariborz Jahanian /// its NSObject attribute set. 479fa23c1d9adc99c662c1c0e192817185809d95614Fariborz Jahanian bool isObjCNSObjectType(QualType Ty) const; 480b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek 481b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek //===--------------------------------------------------------------------===// 482464175bba1318bef7905122e9fda20cff926df78Chris Lattner // Type Sizing and Analysis 483464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 484464175bba1318bef7905122e9fda20cff926df78Chris Lattner 485b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner /// getFloatTypeSemantics - Return the APFloat 'semantics' for the specified 486b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner /// scalar floating point type. 487b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner const llvm::fltSemantics &getFloatTypeSemantics(QualType T) const; 488b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner 489464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// getTypeInfo - Get the size and alignment of the specified complete type in 490464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// bits. 4911d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar std::pair<uint64_t, unsigned> getTypeInfo(const Type *T); 4921d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar std::pair<uint64_t, unsigned> getTypeInfo(QualType T) { 4931d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar return getTypeInfo(T.getTypePtr()); 4941d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar } 495464175bba1318bef7905122e9fda20cff926df78Chris Lattner 496464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// getTypeSize - Return the size of the specified type, in bits. This method 497464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// does not work on incomplete types. 49898be4943e8dc4f3905629a7102668960873cf863Chris Lattner uint64_t getTypeSize(QualType T) { 49998be4943e8dc4f3905629a7102668960873cf863Chris Lattner return getTypeInfo(T).first; 500464175bba1318bef7905122e9fda20cff926df78Chris Lattner } 5011d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar uint64_t getTypeSize(const Type *T) { 5021d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar return getTypeInfo(T).first; 5031d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar } 504464175bba1318bef7905122e9fda20cff926df78Chris Lattner 50534ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// getTypeAlign - Return the ABI-specified alignment of a type, in bits. 50634ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// This method does not work on incomplete types. 50798be4943e8dc4f3905629a7102668960873cf863Chris Lattner unsigned getTypeAlign(QualType T) { 50898be4943e8dc4f3905629a7102668960873cf863Chris Lattner return getTypeInfo(T).second; 509464175bba1318bef7905122e9fda20cff926df78Chris Lattner } 5101d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar unsigned getTypeAlign(const Type *T) { 5111d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar return getTypeInfo(T).second; 5121d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar } 513464175bba1318bef7905122e9fda20cff926df78Chris Lattner 51434ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// getPreferredTypeAlign - Return the "preferred" alignment of the specified 51534ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// type for the current target in bits. This can be different than the ABI 51634ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// alignment in cases where it is beneficial for performance to overalign 51734ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// a data type. 51834ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner unsigned getPreferredTypeAlign(const Type *T); 51934ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner 520b7d0844c887a72064b624dc6df12cbe1441f69d0Daniel Dunbar /// getDeclAlignInBytes - Return the alignment of the specified decl 521b7d0844c887a72064b624dc6df12cbe1441f69d0Daniel Dunbar /// that should be returned by __alignof(). Note that bitfields do 522b7d0844c887a72064b624dc6df12cbe1441f69d0Daniel Dunbar /// not have a valid alignment, so this method will assert on them. 523b7d0844c887a72064b624dc6df12cbe1441f69d0Daniel Dunbar unsigned getDeclAlignInBytes(const Decl *D); 524af707ab8fbb9451e8febb8d766f6c043628125c4Chris Lattner 52588a981b47c7face1b1fdaa9074256245107b9ca9Devang Patel /// getASTRecordLayout - Get or compute information about the layout of the 526464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// specified record (struct/union/class), which indicates its size and field 527464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// position information. 52898be4943e8dc4f3905629a7102668960873cf863Chris Lattner const ASTRecordLayout &getASTRecordLayout(const RecordDecl *D); 529464175bba1318bef7905122e9fda20cff926df78Chris Lattner 530b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar /// getASTObjCInterfaceLayout - Get or compute information about the 531b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar /// layout of the specified Objective-C interface. 53244a3dded8080c5c9cfdad208ade8f8f7850d9a4fDevang Patel const ASTRecordLayout &getASTObjCInterfaceLayout(const ObjCInterfaceDecl *D); 533b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar 534b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar /// getASTObjCImplementationLayout - Get or compute information about 535b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar /// the layout of the specified Objective-C implementation. This may 536b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar /// differ from the interface if synthesized ivars are present. 537b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar const ASTRecordLayout & 538b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar getASTObjCImplementationLayout(const ObjCImplementationDecl *D); 539b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar 54088e469cf4240d4b898eacc0ad092019b022e0e50Fariborz Jahanian void CollectObjCIvars(const ObjCInterfaceDecl *OI, 5416ab3524f72a6e64aa04973fa9433b5559abb3525Douglas Gregor llvm::SmallVectorImpl<FieldDecl*> &Fields); 5428e6ac1d80055fa37b9b84029c7e751624ba7f84cFariborz Jahanian 5438e6ac1d80055fa37b9b84029c7e751624ba7f84cFariborz Jahanian void ShallowCollectObjCIvars(const ObjCInterfaceDecl *OI, 5448e6ac1d80055fa37b9b84029c7e751624ba7f84cFariborz Jahanian llvm::SmallVectorImpl<ObjCIvarDecl*> &Ivars, 5458e6ac1d80055fa37b9b84029c7e751624ba7f84cFariborz Jahanian bool CollectSynthesized = true); 5469820074dd47d37681085e964cd3392ac0b3e67b9Fariborz Jahanian void CollectSynthesizedIvars(const ObjCInterfaceDecl *OI, 5479820074dd47d37681085e964cd3392ac0b3e67b9Fariborz Jahanian llvm::SmallVectorImpl<ObjCIvarDecl*> &Ivars); 5489820074dd47d37681085e964cd3392ac0b3e67b9Fariborz Jahanian void CollectProtocolSynthesizedIvars(const ObjCProtocolDecl *PD, 5499820074dd47d37681085e964cd3392ac0b3e67b9Fariborz Jahanian llvm::SmallVectorImpl<ObjCIvarDecl*> &Ivars); 5508e6ac1d80055fa37b9b84029c7e751624ba7f84cFariborz Jahanian unsigned CountSynthesizedIvars(const ObjCInterfaceDecl *OI); 5518e6ac1d80055fa37b9b84029c7e751624ba7f84cFariborz Jahanian unsigned CountProtocolSynthesizedIvars(const ObjCProtocolDecl *PD); 552525c9b7baeeff022127cd1b167579f3bda73b3edDaniel Dunbar 553464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 554464175bba1318bef7905122e9fda20cff926df78Chris Lattner // Type Operators 555464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 556464175bba1318bef7905122e9fda20cff926df78Chris Lattner 55777c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// getCanonicalType - Return the canonical (structural) type corresponding to 55877c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// the specified potentially non-canonical type. The non-canonical version 55977c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// of a type may have many "decorated" versions of types. Decorators can 56077c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// include typedefs, 'typeof' operators, etc. The returned type is guaranteed 56177c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// to be free of any of these, allowing two canonical types to be compared 56277c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// for exact equality with a simple pointer comparison. 56377c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner QualType getCanonicalType(QualType T); 5641d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar const Type *getCanonicalType(const Type *T) { 5651d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar return T->getCanonicalTypeInternal().getTypePtr(); 5661d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar } 5672a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor 5688e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor /// \brief Determine whether the given types are equivalent. 5698e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor bool hasSameType(QualType T1, QualType T2) { 5708e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor return getCanonicalType(T1) == getCanonicalType(T2); 5718e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor } 5728e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor 5738e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor /// \brief Determine whether the given types are equivalent after 5748e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor /// cvr-qualifiers have been removed. 5758e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor bool hasSameUnqualifiedType(QualType T1, QualType T2) { 5768e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor T1 = getCanonicalType(T1); 5778e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor T2 = getCanonicalType(T2); 5788e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor return T1.getUnqualifiedType() == T2.getUnqualifiedType(); 5798e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor } 5808e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor 5817da97d0f31e1ec16998d3de2cfd2e88fe3736673Douglas Gregor /// \brief Retrieves the "canonical" declaration of the given declaration. 5827da97d0f31e1ec16998d3de2cfd2e88fe3736673Douglas Gregor Decl *getCanonicalDecl(Decl *D); 5837da97d0f31e1ec16998d3de2cfd2e88fe3736673Douglas Gregor 5842a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor /// \brief Retrieves the "canonical" declaration of the given tag 5852a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor /// declaration. 5862a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor /// 5872a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor /// The canonical declaration for the given tag declaration is 5882a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor /// either the definition of the tag (if it is a complete type) or 5892a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor /// the first declaration of that tag. 5902a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor TagDecl *getCanonicalDecl(TagDecl *Tag) { 5917da97d0f31e1ec16998d3de2cfd2e88fe3736673Douglas Gregor return cast<TagDecl>(getCanonicalDecl((Decl *)Tag)); 5922a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor } 5932a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor 5947da97d0f31e1ec16998d3de2cfd2e88fe3736673Douglas Gregor /// \brief Retrieves the "canonical" declaration of 5957da97d0f31e1ec16998d3de2cfd2e88fe3736673Douglas Gregor 596d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// \brief Retrieves the "canonical" nested name specifier for a 597d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// given nested name specifier. 598d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// 599d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// The canonical nested name specifier is a nested name specifier 600d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// that uniquely identifies a type or namespace within the type 601d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// system. For example, given: 602d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// 603d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// \code 604d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// namespace N { 605d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// struct S { 606d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// template<typename T> struct X { typename T* type; }; 607d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// }; 608d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// } 609d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// 610d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// template<typename T> struct Y { 611d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// typename N::S::X<T>::type member; 612d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// }; 613d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// \endcode 614d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// 615d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// Here, the nested-name-specifier for N::S::X<T>:: will be 616d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// S::X<template-param-0-0>, since 'S' and 'X' are uniquely defined 617d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// by declarations in the type system and the canonical type for 618d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// the template type parameter 'T' is template-param-0-0. 619d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor NestedNameSpecifier * 620d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor getCanonicalNestedNameSpecifier(NestedNameSpecifier *NNS); 621d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor 62225a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// \brief Retrieves the "canonical" template name that refers to a 62325a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// given template. 62425a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// 62525a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// The canonical template name is the simplest expression that can 62625a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// be used to refer to a given template. For most templates, this 62725a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// expression is just the template declaration itself. For example, 62825a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// the template std::vector can be referred to via a variety of 62925a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// names---std::vector, ::std::vector, vector (if vector is in 63025a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// scope), etc.---but all of these names map down to the same 63125a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// TemplateDecl, which is used to form the canonical template name. 63225a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// 63325a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// Dependent template names are more interesting. Here, the 63425a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// template name could be something like T::template apply or 63525a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// std::allocator<T>::template rebind, where the nested name 63625a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// specifier itself is dependent. In this case, the canonical 63725a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// template name uses the shortest form of the dependent 63825a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// nested-name-specifier, which itself contains all canonical 63925a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// types, values, and templates. 64025a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor TemplateName getCanonicalTemplateName(TemplateName Name); 64125a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor 642c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner /// Type Query functions. If the type is an instance of the specified class, 643c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner /// return the Type pointer for the underlying maximally pretty type. This 644c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner /// is a member of ASTContext because this may need to do some amount of 645c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner /// canonicalization, e.g. to move type qualifiers into the element type. 646c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner const ArrayType *getAsArrayType(QualType T); 647c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner const ConstantArrayType *getAsConstantArrayType(QualType T) { 648c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner return dyn_cast_or_null<ConstantArrayType>(getAsArrayType(T)); 649c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner } 650c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner const VariableArrayType *getAsVariableArrayType(QualType T) { 651c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner return dyn_cast_or_null<VariableArrayType>(getAsArrayType(T)); 652c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner } 653c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner const IncompleteArrayType *getAsIncompleteArrayType(QualType T) { 654c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner return dyn_cast_or_null<IncompleteArrayType>(getAsArrayType(T)); 655c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner } 6566183a99b064b397d98297904fbd6cf00fe1f453dAnders Carlsson 6576183a99b064b397d98297904fbd6cf00fe1f453dAnders Carlsson /// getBaseElementType - Returns the innermost element type of a variable 6586183a99b064b397d98297904fbd6cf00fe1f453dAnders Carlsson /// length array type. For example, will return "int" for int[m][n] 6596183a99b064b397d98297904fbd6cf00fe1f453dAnders Carlsson QualType getBaseElementType(const VariableArrayType *VAT); 660c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner 661e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// getArrayDecayedType - Return the properly qualified result of decaying the 662e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// specified array type to a pointer. This operation is non-trivial when 663e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// handling typedefs etc. The canonical type of "T" must be an array type, 664e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// this returns a pointer to a properly qualified element of the array. 665e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// 666e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// See C99 6.7.5.3p7 and C99 6.3.2.1p3. 667e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner QualType getArrayDecayedType(QualType T); 668e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner 6697cfeb08f2466d6263ec6ff1402298f93f6d6991fChris Lattner /// getIntegerTypeOrder - Returns the highest ranked integer type: 6707cfeb08f2466d6263ec6ff1402298f93f6d6991fChris Lattner /// C99 6.3.1.8p1. If LHS > RHS, return 1. If LHS == RHS, return 0. If 6717cfeb08f2466d6263ec6ff1402298f93f6d6991fChris Lattner /// LHS < RHS, return -1. 6727cfeb08f2466d6263ec6ff1402298f93f6d6991fChris Lattner int getIntegerTypeOrder(QualType LHS, QualType RHS); 673a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner 674a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner /// getFloatingTypeOrder - Compare the rank of the two specified floating 675a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner /// point types, ignoring the domain of the type (i.e. 'double' == 676a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner /// '_Complex double'). If LHS > RHS, return 1. If LHS == RHS, return 0. If 677a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner /// LHS < RHS, return -1. 678a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner int getFloatingTypeOrder(QualType LHS, QualType RHS); 6795f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 680716c7304ff5d27a95e1e7823acd1d09d5ec3e37fSteve Naroff /// getFloatingTypeOfSizeWithinDomain - Returns a real floating 681716c7304ff5d27a95e1e7823acd1d09d5ec3e37fSteve Naroff /// point or a complex type (based on typeDomain/typeSize). 682716c7304ff5d27a95e1e7823acd1d09d5ec3e37fSteve Naroff /// 'typeDomain' is a real floating point or complex type. 683716c7304ff5d27a95e1e7823acd1d09d5ec3e37fSteve Naroff /// 'typeSize' is a real floating point or complex type. 684f1448a0e4a1e868ff873a8530a61a09cb68666ccSteve Naroff QualType getFloatingTypeOfSizeWithinDomain(QualType typeSize, 685f1448a0e4a1e868ff873a8530a61a09cb68666ccSteve Naroff QualType typeDomain) const; 686ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff 687f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedmanprivate: 688f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman // Helper for integer ordering 689f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman unsigned getIntegerRank(Type* T); 690f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman 691f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedmanpublic: 692f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman 693ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff //===--------------------------------------------------------------------===// 694ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff // Type Compatibility Predicates 695ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff //===--------------------------------------------------------------------===// 696ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff 697ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff /// Compatibility predicates used to check assignment expressions. 698ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff bool typesAreCompatible(QualType, QualType); // C99 6.2.7p1 6991c7d067550c2d9bca8997d0e67ee6b280d493202Steve Naroff bool typesAreBlockCompatible(QualType lhs, QualType rhs); 700ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff 701a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek bool isObjCIdType(QualType T) const { 702389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff return T == ObjCIdType; 703389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff } 704389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff bool isObjCIdStructType(QualType T) const { 70545ecd5daa36385b7e0b2f657357805e01f5d8cbfSteve Naroff if (!IdStructType) // ObjC isn't enabled 70645ecd5daa36385b7e0b2f657357805e01f5d8cbfSteve Naroff return false; 707ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff return T->getAsStructureType() == IdStructType; 708ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff } 709a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek bool isObjCClassType(QualType T) const { 710389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff return T == ObjCClassType; 711389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff } 712389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff bool isObjCClassStructType(QualType T) const { 71345ecd5daa36385b7e0b2f657357805e01f5d8cbfSteve Naroff if (!ClassStructType) // ObjC isn't enabled 71445ecd5daa36385b7e0b2f657357805e01f5d8cbfSteve Naroff return false; 7158baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson return T->getAsStructureType() == ClassStructType; 7168baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson } 717a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek bool isObjCSelType(QualType T) const { 718a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek assert(SelStructType && "isObjCSelType used before 'SEL' type is built"); 7198baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson return T->getAsStructureType() == SelStructType; 7208baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson } 7218baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson 7223d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman // Check the safety of assignment from LHS to RHS 7233d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman bool canAssignObjCInterfaces(const ObjCInterfaceType *LHS, 7243d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman const ObjCInterfaceType *RHS); 725389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff bool areComparableObjCPointerTypes(QualType LHS, QualType RHS); 7263d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman 7273d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman // Functions for calculating composite types 7283d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman QualType mergeTypes(QualType, QualType); 7293d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman QualType mergeFunctionTypes(QualType, QualType); 7303d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman 731368eefa081d12f0a265ee90ee8ec61b54168d57dChris Lattner //===--------------------------------------------------------------------===// 732ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // Integer Predicates 733ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman //===--------------------------------------------------------------------===// 734ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman 735ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // The width of an integer, as defined in C99 6.2.6.2. This is the number 736ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // of bits in an integer type excluding any padding bits. 737ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman unsigned getIntWidth(QualType T); 738ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman 739ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // Per C99 6.2.5p6, for every signed integer type, there is a corresponding 740ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // unsigned integer type. This method takes a signed type, and returns the 741ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // corresponding unsigned integer type. 742ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman QualType getCorrespondingUnsignedType(QualType T); 743ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman 744ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman //===--------------------------------------------------------------------===// 745e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek // Type Iterators. 746e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek //===--------------------------------------------------------------------===// 747e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek 748e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek typedef std::vector<Type*>::iterator type_iterator; 749e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek typedef std::vector<Type*>::const_iterator const_type_iterator; 750e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek 751e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek type_iterator types_begin() { return Types.begin(); } 752e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek type_iterator types_end() { return Types.end(); } 753e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek const_type_iterator types_begin() const { return Types.begin(); } 754e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek const_type_iterator types_end() const { return Types.end(); } 755e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek 756e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek //===--------------------------------------------------------------------===// 7570cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar // Integer Values 7580cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar //===--------------------------------------------------------------------===// 7590cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar 7600cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar /// MakeIntValue - Make an APSInt of the appropriate width and 7610cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar /// signedness for the given \arg Value and integer \arg Type. 7620cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar llvm::APSInt MakeIntValue(uint64_t Value, QualType Type) { 7630cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar llvm::APSInt Res(getIntWidth(Type), !Type->isSignedIntegerType()); 7640cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar Res = Value; 7650cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar return Res; 7660cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar } 7670cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar 7685f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencerprivate: 7695f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer ASTContext(const ASTContext&); // DO NOT IMPLEMENT 7705f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer void operator=(const ASTContext&); // DO NOT IMPLEMENT 7715f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 7725f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer void InitBuiltinTypes(); 7735f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer void InitBuiltinType(QualType &R, BuiltinType::Kind K); 7744b7c98378ae0c1a3635f0b7756848b4a9923f8bcTed Kremenek 77582a6cfbc421cc99c5b7313271f399f7ef95056ecDaniel Dunbar // Return the ObjC type encoding for a given type. 77682a6cfbc421cc99c5b7313271f399f7ef95056ecDaniel Dunbar void getObjCEncodingForTypeImpl(QualType t, std::string &S, 77782a6cfbc421cc99c5b7313271f399f7ef95056ecDaniel Dunbar bool ExpandPointedToStructures, 77882a6cfbc421cc99c5b7313271f399f7ef95056ecDaniel Dunbar bool ExpandStructures, 779153bfe5795e2c1a5a738e73d3784964e082237fcDaniel Dunbar const FieldDecl *Field, 780090b3f71702c5626d8520f9608d77c6f26dcfa15Fariborz Jahanian bool OutermostType = false, 7816ab3524f72a6e64aa04973fa9433b5559abb3525Douglas Gregor bool EncodingProperty = false); 782b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar 783b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar const ASTRecordLayout &getObjCLayout(const ObjCInterfaceDecl *D, 784b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar const ObjCImplementationDecl *Impl); 7855f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer}; 786e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl 7875f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer} // end namespace clang 7885f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 789e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl// operator new and delete aren't allowed inside namespaces. 790e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl// The throw specifications are mandated by the standard. 791e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @brief Placement new for using the ASTContext's allocator. 792e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// 793e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// This placement form of operator new uses the ASTContext's allocator for 794e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// obtaining memory. It is a non-throwing new, which means that it returns 795e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// null on error. (If that is what the allocator does. The current does, so if 796e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// this ever changes, this operator will have to be changed, too.) 797e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// Usage looks like this (assuming there's an ASTContext 'Context' in scope): 798e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @code 799e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// // Default alignment (16) 800e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// IntegerLiteral *Ex = new (Context) IntegerLiteral(arguments); 801e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// // Specific alignment 802e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// IntegerLiteral *Ex2 = new (Context, 8) IntegerLiteral(arguments); 803e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @endcode 804e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// Please note that you cannot use delete on the pointer; it must be 805e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// deallocated using an explicit destructor call followed by 8064398a78095cd05a3be702fbab25bfe324a5d7946Ted Kremenek/// @c Context.Deallocate(Ptr). 807e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// 808e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @param Bytes The number of bytes to allocate. Calculated by the compiler. 809e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @param C The ASTContext that provides the allocator. 81042542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @param Alignment The alignment of the allocated memory (if the underlying 81142542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// allocator supports it). 812e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @return The allocated memory. Could be NULL. 813e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redlinline void *operator new(size_t Bytes, clang::ASTContext &C, 8149f9bf258f8ebae30bfb70feb9d797d6eb67b0460Douglas Gregor size_t Alignment) throw () { 815c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff return C.Allocate(Bytes, Alignment); 816e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl} 817e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @brief Placement delete companion to the new above. 818e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// 819e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// This operator is just a companion to the new above. There is no way of 820e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// invoking it directly; see the new operator for more details. This operator 821e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// is called implicitly by the compiler if a placement new expression using 822e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// the ASTContext throws in the object constructor. 823fb523e16dd1f860ff02a3ae03e5e3e25327a5860Chris Lattnerinline void operator delete(void *Ptr, clang::ASTContext &C, size_t) 824e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl throw () { 825c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff C.Deallocate(Ptr); 826e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl} 827e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl 82842542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// This placement form of operator new[] uses the ASTContext's allocator for 82942542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// obtaining memory. It is a non-throwing new[], which means that it returns 83042542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// null on error. 83142542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// Usage looks like this (assuming there's an ASTContext 'Context' in scope): 83242542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @code 83342542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// // Default alignment (16) 83442542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// char *data = new (Context) char[10]; 83542542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// // Specific alignment 83642542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// char *data = new (Context, 8) char[10]; 83742542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @endcode 83842542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// Please note that you cannot use delete on the pointer; it must be 83942542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// deallocated using an explicit destructor call followed by 8404398a78095cd05a3be702fbab25bfe324a5d7946Ted Kremenek/// @c Context.Deallocate(Ptr). 84142542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// 84242542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @param Bytes The number of bytes to allocate. Calculated by the compiler. 84342542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @param C The ASTContext that provides the allocator. 84442542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @param Alignment The alignment of the allocated memory (if the underlying 84542542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// allocator supports it). 84642542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @return The allocated memory. Could be NULL. 84742542c6a4b3c60f63820e6177a8938443831492cTed Kremenekinline void *operator new[](size_t Bytes, clang::ASTContext& C, 84842542c6a4b3c60f63820e6177a8938443831492cTed Kremenek size_t Alignment = 16) throw () { 84942542c6a4b3c60f63820e6177a8938443831492cTed Kremenek return C.Allocate(Bytes, Alignment); 85042542c6a4b3c60f63820e6177a8938443831492cTed Kremenek} 85142542c6a4b3c60f63820e6177a8938443831492cTed Kremenek 85242542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @brief Placement delete[] companion to the new[] above. 85342542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// 85442542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// This operator is just a companion to the new[] above. There is no way of 85542542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// invoking it directly; see the new[] operator for more details. This operator 85642542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// is called implicitly by the compiler if a placement new[] expression using 85742542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// the ASTContext throws in the object constructor. 85842542c6a4b3c60f63820e6177a8938443831492cTed Kremenekinline void operator delete[](void *Ptr, clang::ASTContext &C) throw () { 85942542c6a4b3c60f63820e6177a8938443831492cTed Kremenek C.Deallocate(Ptr); 86042542c6a4b3c60f63820e6177a8938443831492cTed Kremenek} 86142542c6a4b3c60f63820e6177a8938443831492cTed Kremenek 8625f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer#endif 863