ASTContext.h revision 1b63e4f732dbc73d90abf886b4d21f8e3a165f6d
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" 20ad75653f81dece1c806e9c28dd7e7582c9929a27Ted Kremenek#include "clang/AST/Decl.h" 21ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor#include "clang/AST/NestedNameSpecifier.h" 22d249e1d1f1498b81314459ceda19d6ff25c278adDouglas Gregor#include "clang/AST/PrettyPrinter.h" 237532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor#include "clang/AST/TemplateName.h" 24464175bba1318bef7905122e9fda20cff926df78Chris Lattner#include "clang/AST/Type.h" 25464175bba1318bef7905122e9fda20cff926df78Chris Lattner#include "llvm/ADT/DenseMap.h" 2668d331a78e655d97294e94fcfa63f92cc1f40578Steve Naroff#include "llvm/ADT/FoldingSet.h" 272cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor#include "llvm/ADT/OwningPtr.h" 286c2b6eb8d836da19007f7540709e16d5e39a1cbaChris Lattner#include "llvm/Support/Allocator.h" 295f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer#include <vector> 305f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 31b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattnernamespace llvm { 32b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner struct fltSemantics; 33b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner} 34b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner 355f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencernamespace clang { 36a9376d470ccb0eac74fe09a6b2a18a890f1d17c4Chris Lattner class FileManager; 37e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class ASTRecordLayout; 38e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class Expr; 392cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor class ExternalASTSource; 40c7229c338c21ef26b01ef3ecf9eec4fd373fa9ecChris Lattner class IdentifierTable; 41e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class SelectorTable; 42e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class SourceManager; 43d934112e6170b0fd940d8e40db6936cea2cdcf62Douglas Gregor class TargetInfo; 44e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar // Decls 45e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class Decl; 46c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar class ObjCPropertyDecl; 47e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class RecordDecl; 48e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class TagDecl; 49e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class TranslationUnitDecl; 50e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class TypeDecl; 51e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class TypedefDecl; 5272c3f314d92d65c050ee1c07b7753623c044d6c7Douglas Gregor class TemplateTypeParmDecl; 53efc4c4bdbd8fee90b93deb3b5cfaeb044ae22557Fariborz Jahanian class FieldDecl; 54efc4c4bdbd8fee90b93deb3b5cfaeb044ae22557Fariborz Jahanian class ObjCIvarRefExpr; 55efc4c4bdbd8fee90b93deb3b5cfaeb044ae22557Fariborz Jahanian class ObjCIvarDecl; 56efc4c4bdbd8fee90b93deb3b5cfaeb044ae22557Fariborz Jahanian 571b63e4f732dbc73d90abf886b4d21f8e3a165f6dChris Lattner namespace Builtin { class Context; } 581b63e4f732dbc73d90abf886b4d21f8e3a165f6dChris Lattner 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; 1451b63e4f732dbc73d90abf886b4d21f8e3a165f6dChris Lattner Builtin::Context &BuiltinInfo; 1462e1cd4264d363ca869bf37ef160902f211d21b8cDouglas Gregor DeclarationNameTable DeclarationNames; 1472cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor llvm::OwningPtr<ExternalASTSource> ExternalSource; 148d249e1d1f1498b81314459ceda19d6ff25c278adDouglas Gregor clang::PrintingPolicy PrintingPolicy; 1492e1cd4264d363ca869bf37ef160902f211d21b8cDouglas Gregor 1507a9d49fd2bfac00e905b361ba76d26ab5b6c3b09Ted Kremenek SourceManager& getSourceManager() { return SourceMgr; } 151a9376d470ccb0eac74fe09a6b2a18a890f1d17c4Chris Lattner const SourceManager& getSourceManager() const { return SourceMgr; } 152c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff void *Allocate(unsigned Size, unsigned Align = 8) { 153c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff return FreeMemory ? MallocAlloc.Allocate(Size, Align) : 154c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff BumpAlloc.Allocate(Size, Align); 155c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff } 156c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff void Deallocate(void *Ptr) { 157c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff if (FreeMemory) 158c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff MallocAlloc.Deallocate(Ptr); 159c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff } 160e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek const LangOptions& getLangOptions() const { return LangOpts; } 1616c2b6eb8d836da19007f7540709e16d5e39a1cbaChris Lattner 1629c728dc4d8da89c73fcae74c9e72d7a83ffd7b6dTed Kremenek FullSourceLoc getFullLoc(SourceLocation Loc) const { 1639c728dc4d8da89c73fcae74c9e72d7a83ffd7b6dTed Kremenek return FullSourceLoc(Loc,SourceMgr); 1649c728dc4d8da89c73fcae74c9e72d7a83ffd7b6dTed Kremenek } 165ef177820100ab583b08fd3056e2a5a52ee4b1629Argyrios Kyrtzidis 166ef177820100ab583b08fd3056e2a5a52ee4b1629Argyrios Kyrtzidis TranslationUnitDecl *getTranslationUnitDecl() const { return TUDecl; } 167ef177820100ab583b08fd3056e2a5a52ee4b1629Argyrios Kyrtzidis 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, 1841b63e4f732dbc73d90abf886b4d21f8e3a165f6dChris Lattner IdentifierTable &idents, SelectorTable &sels, 1851b63e4f732dbc73d90abf886b4d21f8e3a165f6dChris Lattner Builtin::Context &builtins, 1861b63e4f732dbc73d90abf886b4d21f8e3a165f6dChris Lattner bool FreeMemory = true, unsigned size_reserve=0); 187fee0452973f28691a61aab0fb074468ce3e34b9bTed Kremenek 1885f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer ~ASTContext(); 1896ab3524f72a6e64aa04973fa9433b5559abb3525Douglas Gregor 1902cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// \brief Attach an external AST source to the AST context. 1912cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// 1922cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// The external AST source provides the ability to load parts of 1932cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// the abstract syntax tree as needed from some external storage, 1942cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// e.g., a precompiled header. 1952cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor void setExternalSource(llvm::OwningPtr<ExternalASTSource> &Source); 1962cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor 1972cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// \brief Retrieve a pointer to the external AST source associated 1982cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// with this AST context, if any. 1992cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor ExternalASTSource *getExternalSource() const { return ExternalSource.get(); } 2002cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor 2015f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer void PrintStats() const; 20203ed44061df258e74a40383bda849e14b892a8c6Ted Kremenek const std::vector<Type*>& getTypes() const { return Types; } 203d249e1d1f1498b81314459ceda19d6ff25c278adDouglas Gregor 204464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 205464175bba1318bef7905122e9fda20cff926df78Chris Lattner // Type Constructors 206464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 207d2d2a11a91d7ddf468bfb70f66362d24806ed601Chris Lattner 208f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian /// getAddSpaceQualType - Return the uniqued reference to the type for an 209f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian /// address space qualified type with the specified type and address space. 210f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian /// The resulting type has a union of the qualifiers from T and the address 211f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian /// space. If T already has an address space specifier, it is silently 212f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian /// replaced. 213f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian QualType getAddrSpaceQualType(QualType T, unsigned AddressSpace); 214ebb97e98c03f8d7034bd3748a10e35f39a95c289Christopher Lamb 215d33d9c0cc0cfdcd0b10f35a6acdfb25da4a64f19Fariborz Jahanian /// getObjCGCQualType - Returns the uniqued reference to the type for an 216d33d9c0cc0cfdcd0b10f35a6acdfb25da4a64f19Fariborz Jahanian /// objc gc qualified type. The retulting type has a union of the qualifiers 217d33d9c0cc0cfdcd0b10f35a6acdfb25da4a64f19Fariborz Jahanian /// from T and the gc attribute. 218d33d9c0cc0cfdcd0b10f35a6acdfb25da4a64f19Fariborz Jahanian QualType getObjCGCQualType(QualType T, QualType::GCAttrTypes gcAttr); 219d33d9c0cc0cfdcd0b10f35a6acdfb25da4a64f19Fariborz Jahanian 2205f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getComplexType - Return the uniqued reference to the type for a complex 2215f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// number with the specified element type. 2225f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getComplexType(QualType T); 2235f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 2245f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getPointerType - Return the uniqued reference to the type for a pointer to 2255f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// the specified type. 2265f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getPointerType(QualType T); 2275618bd4a52c45fbbb605e3ba885663b2164db8a3Steve Naroff 2285618bd4a52c45fbbb605e3ba885663b2164db8a3Steve Naroff /// getBlockPointerType - Return the uniqued reference to the type for a block 2295618bd4a52c45fbbb605e3ba885663b2164db8a3Steve Naroff /// of the specified type. 2305618bd4a52c45fbbb605e3ba885663b2164db8a3Steve Naroff QualType getBlockPointerType(QualType T); 231f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl 2327c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl /// getLValueReferenceType - Return the uniqued reference to the type for an 2337c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl /// lvalue reference to the specified type. 2347c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl QualType getLValueReferenceType(QualType T); 2357c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl 2367c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl /// getRValueReferenceType - Return the uniqued reference to the type for an 2377c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl /// rvalue reference to the specified type. 2387c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl QualType getRValueReferenceType(QualType T); 239f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl 240f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl /// getMemberPointerType - Return the uniqued reference to the type for a 241f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl /// member pointer to the specified type in the specified class. The class 242f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl /// is a Type because it could be a dependent name. 243f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl QualType getMemberPointerType(QualType T, const Type *Cls); 244f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl 245bdbf7b030a3e0ddb95240076683830e6f78c79a5Steve Naroff /// getVariableArrayType - Returns a non-unique reference to the type for a 246bdbf7b030a3e0ddb95240076683830e6f78c79a5Steve Naroff /// variable array of the specified element type. 247c9406125e2cac9208098655ac8058c095c2c3a65Steve Naroff QualType getVariableArrayType(QualType EltTy, Expr *NumElts, 248c9406125e2cac9208098655ac8058c095c2c3a65Steve Naroff ArrayType::ArraySizeModifier ASM, 249c9406125e2cac9208098655ac8058c095c2c3a65Steve Naroff unsigned EltTypeQuals); 250898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor 251898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor /// getDependentSizedArrayType - Returns a non-unique reference to 252898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor /// the type for a dependently-sized array of the specified element 253898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor /// type. FIXME: We will need these to be uniqued, or at least 254898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor /// comparable, at some point. 255898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor QualType getDependentSizedArrayType(QualType EltTy, Expr *NumElts, 256fea8685bf3036b199c573e70b03affde2583fc44Nate Begeman ArrayType::ArraySizeModifier ASM, 257fea8685bf3036b199c573e70b03affde2583fc44Nate Begeman unsigned EltTypeQuals); 258fb22d96692c5240fb8d611290dbf7eeed3759c73Steve Naroff 259c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman /// getIncompleteArrayType - Returns a unique reference to the type for a 260c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman /// incomplete array of the specified element type. 261c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman QualType getIncompleteArrayType(QualType EltTy, 262c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman ArrayType::ArraySizeModifier ASM, 263c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman unsigned EltTypeQuals); 264c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman 265bdbf7b030a3e0ddb95240076683830e6f78c79a5Steve Naroff /// getConstantArrayType - Return the unique reference to the type for a 266bdbf7b030a3e0ddb95240076683830e6f78c79a5Steve Naroff /// constant array of the specified element type. 267c9406125e2cac9208098655ac8058c095c2c3a65Steve Naroff QualType getConstantArrayType(QualType EltTy, const llvm::APInt &ArySize, 268c9406125e2cac9208098655ac8058c095c2c3a65Steve Naroff ArrayType::ArraySizeModifier ASM, 269c9406125e2cac9208098655ac8058c095c2c3a65Steve Naroff unsigned EltTypeQuals); 2705f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 27173322924127c873c13101b705dd823f5539ffa5fSteve Naroff /// getVectorType - Return the unique reference to a vector type of 27273322924127c873c13101b705dd823f5539ffa5fSteve Naroff /// the specified element type and size. VectorType must be a built-in type. 27373322924127c873c13101b705dd823f5539ffa5fSteve Naroff QualType getVectorType(QualType VectorType, unsigned NumElts); 27473322924127c873c13101b705dd823f5539ffa5fSteve Naroff 275213541a68a3e137d11d2cefb612c6cdb410d7e8eNate Begeman /// getExtVectorType - Return the unique reference to an extended vector type 276213541a68a3e137d11d2cefb612c6cdb410d7e8eNate Begeman /// of the specified element type and size. VectorType must be a built-in 277213541a68a3e137d11d2cefb612c6cdb410d7e8eNate Begeman /// type. 278213541a68a3e137d11d2cefb612c6cdb410d7e8eNate Begeman QualType getExtVectorType(QualType VectorType, unsigned NumElts); 2795f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 28072564e73277e29f6db3305d1f27ba408abb7ed88Douglas Gregor /// getFunctionNoProtoType - Return a K&R style C function type like 'int()'. 2815f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// 28272564e73277e29f6db3305d1f27ba408abb7ed88Douglas Gregor QualType getFunctionNoProtoType(QualType ResultTy); 283465226e23a3008bd68973513dda1f9e3cd27dbddSebastian Redl 2845f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getFunctionType - Return a normal function type with a typed argument 2855f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// list. isVariadic indicates whether the argument list includes '...'. 28686da77fdaf4c0237eafb9670f54eee20b08635bfEli Friedman QualType getFunctionType(QualType ResultTy, const QualType *ArgArray, 287971c4fae6092976338b755af1d47dac07c8f16e3Argyrios Kyrtzidis unsigned NumArgs, bool isVariadic, 288465226e23a3008bd68973513dda1f9e3cd27dbddSebastian Redl unsigned TypeQuals, bool hasExceptionSpec = false, 289465226e23a3008bd68973513dda1f9e3cd27dbddSebastian Redl bool hasAnyExceptionSpec = false, 290465226e23a3008bd68973513dda1f9e3cd27dbddSebastian Redl unsigned NumExs = 0, const QualType *ExArray = 0); 2912ce52f3fb95bf544db6bd3d91a72bce7d9cceb6cDouglas Gregor 2922ce52f3fb95bf544db6bd3d91a72bce7d9cceb6cDouglas Gregor /// getTypeDeclType - Return the unique reference to the type for 2932ce52f3fb95bf544db6bd3d91a72bce7d9cceb6cDouglas Gregor /// the specified type declaration. 2944b7c98378ae0c1a3635f0b7756848b4a9923f8bcTed Kremenek QualType getTypeDeclType(TypeDecl *Decl, TypeDecl* PrevDecl=0); 2952ce52f3fb95bf544db6bd3d91a72bce7d9cceb6cDouglas Gregor 2965f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getTypedefType - Return the unique reference to the type for the 2975f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// specified typename decl. 2985f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getTypedefType(TypedefDecl *Decl); 2993b3a45858c6b2a45114e91902c3bf3c4b7f5f302Daniel Dunbar QualType getObjCInterfaceType(const ObjCInterfaceDecl *Decl); 300fab9d67cebb87be968e7ae31a3b549a5279b5d51Douglas Gregor 301fab9d67cebb87be968e7ae31a3b549a5279b5d51Douglas Gregor QualType getTemplateTypeParmType(unsigned Depth, unsigned Index, 302fab9d67cebb87be968e7ae31a3b549a5279b5d51Douglas Gregor IdentifierInfo *Name = 0); 303fab9d67cebb87be968e7ae31a3b549a5279b5d51Douglas Gregor 3047532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor QualType getTemplateSpecializationType(TemplateName T, 3057532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor const TemplateArgument *Args, 3067532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor unsigned NumArgs, 3077532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor QualType Canon = QualType()); 30855f6b14230c94272efbbcdd89a92224c8db9f225Douglas Gregor 309ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor QualType getQualifiedNameType(NestedNameSpecifier *NNS, 310e4e5b054b4917f0ee493bb2fda5b1ec749bfb9a1Douglas Gregor QualType NamedType); 311d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor QualType getTypenameType(NestedNameSpecifier *NNS, 312d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor const IdentifierInfo *Name, 313d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor QualType Canon = QualType()); 3141734317845d60307d474b5da8a8d33adbaf5e723Douglas Gregor QualType getTypenameType(NestedNameSpecifier *NNS, 3151734317845d60307d474b5da8a8d33adbaf5e723Douglas Gregor const TemplateSpecializationType *TemplateId, 3161734317845d60307d474b5da8a8d33adbaf5e723Douglas Gregor QualType Canon = QualType()); 317e4e5b054b4917f0ee493bb2fda5b1ec749bfb9a1Douglas Gregor 318a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek /// getObjCQualifiedInterfaceType - Return a 319a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek /// ObjCQualifiedInterfaceType type for the given interface decl and 3204b6c9051c6522894978c9ba6a819a659d102db36Fariborz Jahanian /// the conforming protocol list. 321a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType getObjCQualifiedInterfaceType(ObjCInterfaceDecl *Decl, 32292dd386e3f05d176b45a638199d51f536bd9d1c4Chris Lattner ObjCProtocolDecl **ProtocolList, 32392dd386e3f05d176b45a638199d51f536bd9d1c4Chris Lattner unsigned NumProtocols); 324c569249ca0ab755ac79d8cbbfcb2bcae19743624Fariborz Jahanian 325a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek /// getObjCQualifiedIdType - Return an ObjCQualifiedIdType for a 326c569249ca0ab755ac79d8cbbfcb2bcae19743624Fariborz Jahanian /// given 'id' and conforming protocol list. 32762f5f7ffad57e0c2af2b308af3735351505937cbChris Lattner QualType getObjCQualifiedIdType(ObjCProtocolDecl **ProtocolList, 328c569249ca0ab755ac79d8cbbfcb2bcae19743624Fariborz Jahanian unsigned NumProtocols); 329c569249ca0ab755ac79d8cbbfcb2bcae19743624Fariborz Jahanian 3305f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 331d1861fd633d5096a00777c918eb8575ea7162fe7Steve Naroff /// getTypeOfType - GCC extension. 33272564e73277e29f6db3305d1f27ba408abb7ed88Douglas Gregor QualType getTypeOfExprType(Expr *e); 333d1861fd633d5096a00777c918eb8575ea7162fe7Steve Naroff QualType getTypeOfType(QualType t); 334d1861fd633d5096a00777c918eb8575ea7162fe7Steve Naroff 3355f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getTagDeclType - Return the unique reference to the type for the 3365f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// specified TagDecl (struct/union/class/enum) decl. 3375f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getTagDeclType(TagDecl *Decl); 3385f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 3395f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getSizeType - Return the unique type for "size_t" (C99 7.17), defined 3405f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// in <stddef.h>. The sizeof operator requires this (C99 6.5.3.4p4). 3415f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getSizeType() const; 342fd888a581d6d329f5b447c8ff4d37cf396315993Eli Friedman 3433a2503227c3db04a3619735127483263c1075ef7Chris Lattner /// getWCharType - In C++, this returns the unique wchar_t type. In C99, this 3443a2503227c3db04a3619735127483263c1075ef7Chris Lattner /// returns a type compatible with the type defined in <stddef.h> as defined 3453a2503227c3db04a3619735127483263c1075ef7Chris Lattner /// by the target. 3463a2503227c3db04a3619735127483263c1075ef7Chris Lattner QualType getWCharType() const { return WCharTy; } 34764c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis 34864c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis /// getSignedWCharType - Return the type of "signed wchar_t". 34964c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis /// Used when in C++, as a GCC extension. 35064c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis QualType getSignedWCharType() const; 35164c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis 35264c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis /// getUnsignedWCharType - Return the type of "unsigned wchar_t". 35364c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis /// Used when in C++, as a GCC extension. 35464c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis QualType getUnsignedWCharType() const; 3555f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 3568b9023ba35a86838789e2c9034a6128728c547aaChris Lattner /// getPointerDiffType - Return the unique type for "ptrdiff_t" (ref?) 3578b9023ba35a86838789e2c9034a6128728c547aaChris Lattner /// defined in <stddef.h>. Pointer - pointer requires this (C99 6.5.6p9). 3588b9023ba35a86838789e2c9034a6128728c547aaChris Lattner QualType getPointerDiffType() const; 3598b9023ba35a86838789e2c9034a6128728c547aaChris Lattner 360beaf299a2701c5559a4e5d76b0c40f805afb8e6aSteve Naroff // getCFConstantStringType - Return the C structure type used to represent 361beaf299a2701c5559a4e5d76b0c40f805afb8e6aSteve Naroff // constant CFStrings. 36271993dd85eed9cc42c6b2fa61ee5c53026b74817Anders Carlsson QualType getCFConstantStringType(); 36371993dd85eed9cc42c6b2fa61ee5c53026b74817Anders Carlsson 364319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor /// Get the structure type used to representation CFStrings, or NULL 365319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor /// if it hasn't yet been built. 366319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor QualType getRawCFConstantStringType() { 367319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor if (CFConstantStringTypeDecl) 368319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor return getTagDeclType(CFConstantStringTypeDecl); 369319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor return QualType(); 370319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor } 371319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor void setCFConstantStringType(QualType T); 372319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor 373983df5b2280980e59b0b062bcc2882230465a61eSteve Naroff // This setter/getter represents the ObjC type for an NSConstantString. 374a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek void setObjCConstantStringInterface(ObjCInterfaceDecl *Decl); 375a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType getObjCConstantStringInterface() const { 376a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek return ObjCConstantStringType; 3772198891824c38d45b2279de5d5e3ef9394eb457cSteve Naroff } 378b62f6813406a03bf8a371c4e46c9fad51d102121Fariborz Jahanian 379bd4c1ada2e8668f43a865dc2c662085cf61940c4Anders Carlsson //// This gets the struct used to keep track of fast enumerations. 380bd4c1ada2e8668f43a865dc2c662085cf61940c4Anders Carlsson QualType getObjCFastEnumerationStateType(); 381bd4c1ada2e8668f43a865dc2c662085cf61940c4Anders Carlsson 382319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor /// Get the ObjCFastEnumerationState type, or NULL if it hasn't yet 383319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor /// been built. 384319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor QualType getRawObjCFastEnumerationStateType() { 385319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor if (ObjCFastEnumerationStateTypeDecl) 386319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor return getTagDeclType(ObjCFastEnumerationStateTypeDecl); 387319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor return QualType(); 388319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor } 389319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor 390319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor void setObjCFastEnumerationStateType(QualType T); 391319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor 392d96b35bc6becf8db00d140c11e3d0e53f27567a1Daniel Dunbar /// getObjCEncodingForType - Emit the ObjC type encoding for the 393d96b35bc6becf8db00d140c11e3d0e53f27567a1Daniel Dunbar /// given type into \arg S. If \arg NameFields is specified then 394d96b35bc6becf8db00d140c11e3d0e53f27567a1Daniel Dunbar /// record field names are also encoded. 3957d6b46d9a9d75dea8ef9f6973dd50633c1f37963Fariborz Jahanian void getObjCEncodingForType(QualType t, std::string &S, 396153bfe5795e2c1a5a738e73d3784964e082237fcDaniel Dunbar const FieldDecl *Field=0); 397a1c033e9514865f3a7b0d8b3b20e6de926cfec6cFariborz Jahanian 398a1c033e9514865f3a7b0d8b3b20e6de926cfec6cFariborz Jahanian void getLegacyIntegralTypeEncoding(QualType &t) const; 39933e1d64ab5cd5d27f8530ccd056191fe2c9f3f2eFariborz Jahanian 400ecb01e666665efabd2aa76a76f6080e2a78965faFariborz Jahanian // Put the string version of type qualifiers into S. 401a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek void getObjCEncodingForTypeQualifier(Decl::ObjCDeclQualifier QT, 402ecb01e666665efabd2aa76a76f6080e2a78965faFariborz Jahanian std::string &S) const; 403ecb01e666665efabd2aa76a76f6080e2a78965faFariborz Jahanian 404a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek /// getObjCEncodingForMethodDecl - Return the encoded type for this method 40533e1d64ab5cd5d27f8530ccd056191fe2c9f3f2eFariborz Jahanian /// declaration. 406c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar void getObjCEncodingForMethodDecl(const ObjCMethodDecl *Decl, std::string &S); 407c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar 408c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar /// getObjCEncodingForPropertyDecl - Return the encoded type for 409c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar /// this method declaration. If non-NULL, Container must be either 410c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar /// an ObjCCategoryImplDecl or ObjCImplementationDecl; it should 411c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar /// only be NULL when getting encodings for protocol properties. 41277a49f6b1e5741f6bda71eb7837b43343925027bArgyrios Kyrtzidis void getObjCEncodingForPropertyDecl(const ObjCPropertyDecl *PD, 413c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar const Decl *Container, 414c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar std::string &S); 41533e1d64ab5cd5d27f8530ccd056191fe2c9f3f2eFariborz Jahanian 416a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek /// getObjCEncodingTypeSize returns size of type for objective-c encoding 41733e1d64ab5cd5d27f8530ccd056191fe2c9f3f2eFariborz Jahanian /// purpose. 418a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek int getObjCEncodingTypeSize(QualType t); 41985f9bceab1542aafff012d4d28e998f4ba16e362Anders Carlsson 420d85376aa66bc16488539f6bb11f97d0170b1fe6bChris Lattner /// This setter/getter represents the ObjC 'id' type. It is setup lazily, by 421d85376aa66bc16488539f6bb11f97d0170b1fe6bChris Lattner /// Sema. id is always a (typedef for a) pointer type, a pointer to a struct. 422a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType getObjCIdType() const { return ObjCIdType; } 423319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor void setObjCIdType(QualType T); 424b62f6813406a03bf8a371c4e46c9fad51d102121Fariborz Jahanian 425319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor void setObjCSelType(QualType T); 426a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType getObjCSelType() const { return ObjCSelType; } 427b62f6813406a03bf8a371c4e46c9fad51d102121Fariborz Jahanian 428a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek void setObjCProtoType(QualType QT); 429a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType getObjCProtoType() const { return ObjCProtoType; } 430390d50a725497e99247dc104a7d2c2a255d3af14Fariborz Jahanian 431d85376aa66bc16488539f6bb11f97d0170b1fe6bChris Lattner /// This setter/getter repreents the ObjC 'Class' type. It is setup lazily, by 432d85376aa66bc16488539f6bb11f97d0170b1fe6bChris Lattner /// Sema. 'Class' is always a (typedef for a) pointer type, a pointer to a 433d85376aa66bc16488539f6bb11f97d0170b1fe6bChris Lattner /// struct. 434a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType getObjCClassType() const { return ObjCClassType; } 435319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor void setObjCClassType(QualType T); 4368baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson 437b2cf3573d7351094f6247fcca94703ce88eb9ee0Anders Carlsson void setBuiltinVaListType(QualType T); 438b2cf3573d7351094f6247fcca94703ce88eb9ee0Anders Carlsson QualType getBuiltinVaListType() const { return BuiltinVaListType; } 439f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman 440f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman QualType getFixedWidthIntType(unsigned Width, bool Signed); 441f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman 4427532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor TemplateName getQualifiedTemplateName(NestedNameSpecifier *NNS, 4437532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor bool TemplateKeyword, 4447532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor TemplateDecl *Template); 4457532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor 4467532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor TemplateName getDependentTemplateName(NestedNameSpecifier *NNS, 4477532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor const IdentifierInfo *Name); 4487532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor 44986df27bbdbb98c39ec2184695c0561209f91beddChris Lattner enum GetBuiltinTypeError { 45086df27bbdbb98c39ec2184695c0561209f91beddChris Lattner GE_None, //< No error 45186df27bbdbb98c39ec2184695c0561209f91beddChris Lattner GE_Missing_FILE //< Missing the FILE type from <stdio.h> 45286df27bbdbb98c39ec2184695c0561209f91beddChris Lattner }; 45386df27bbdbb98c39ec2184695c0561209f91beddChris Lattner 45486df27bbdbb98c39ec2184695c0561209f91beddChris Lattner /// GetBuiltinType - Return the type for the specified builtin. 45586df27bbdbb98c39ec2184695c0561209f91beddChris Lattner QualType GetBuiltinType(unsigned ID, GetBuiltinTypeError &Error); 45686df27bbdbb98c39ec2184695c0561209f91beddChris Lattner 457d934112e6170b0fd940d8e40db6936cea2cdcf62Douglas Gregorprivate: 458d934112e6170b0fd940d8e40db6936cea2cdcf62Douglas Gregor QualType getFromTargetType(unsigned Type) const; 459b4e66d5259f90e9aae4d40fc5de801e046c7df94Douglas Gregor 460464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 461b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek // Type Predicates. 462b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek //===--------------------------------------------------------------------===// 463d934112e6170b0fd940d8e40db6936cea2cdcf62Douglas Gregor 464d934112e6170b0fd940d8e40db6936cea2cdcf62Douglas Gregorpublic: 465b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek /// isObjCObjectPointerType - Returns true if type is an Objective-C pointer 466b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek /// to an object type. This includes "id" and "Class" (two 'special' pointers 467b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek /// to struct), Interface* (pointer to ObjCInterfaceType) and id<P> (qualified 468b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek /// ID type). 469b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek bool isObjCObjectPointerType(QualType Ty) const; 4704fd83ea566f4a0c083001c84b75da6cc8c99c1d6Fariborz Jahanian 4714fd83ea566f4a0c083001c84b75da6cc8c99c1d6Fariborz Jahanian /// getObjCGCAttr - Returns one of GCNone, Weak or Strong objc's 4724fd83ea566f4a0c083001c84b75da6cc8c99c1d6Fariborz Jahanian /// garbage collection attribute. 4734fd83ea566f4a0c083001c84b75da6cc8c99c1d6Fariborz Jahanian /// 4744fd83ea566f4a0c083001c84b75da6cc8c99c1d6Fariborz Jahanian QualType::GCAttrTypes getObjCGCAttrKind(const QualType &Ty) const; 475fa23c1d9adc99c662c1c0e192817185809d95614Fariborz Jahanian 476fa23c1d9adc99c662c1c0e192817185809d95614Fariborz Jahanian /// isObjCNSObjectType - Return true if this is an NSObject object with 477fa23c1d9adc99c662c1c0e192817185809d95614Fariborz Jahanian /// its NSObject attribute set. 478fa23c1d9adc99c662c1c0e192817185809d95614Fariborz Jahanian bool isObjCNSObjectType(QualType Ty) const; 479b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek 480b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek //===--------------------------------------------------------------------===// 481464175bba1318bef7905122e9fda20cff926df78Chris Lattner // Type Sizing and Analysis 482464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 483464175bba1318bef7905122e9fda20cff926df78Chris Lattner 484b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner /// getFloatTypeSemantics - Return the APFloat 'semantics' for the specified 485b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner /// scalar floating point type. 486b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner const llvm::fltSemantics &getFloatTypeSemantics(QualType T) const; 487b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner 488464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// getTypeInfo - Get the size and alignment of the specified complete type in 489464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// bits. 4901d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar std::pair<uint64_t, unsigned> getTypeInfo(const Type *T); 4911d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar std::pair<uint64_t, unsigned> getTypeInfo(QualType T) { 4921d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar return getTypeInfo(T.getTypePtr()); 4931d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar } 494464175bba1318bef7905122e9fda20cff926df78Chris Lattner 495464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// getTypeSize - Return the size of the specified type, in bits. This method 496464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// does not work on incomplete types. 49798be4943e8dc4f3905629a7102668960873cf863Chris Lattner uint64_t getTypeSize(QualType T) { 49898be4943e8dc4f3905629a7102668960873cf863Chris Lattner return getTypeInfo(T).first; 499464175bba1318bef7905122e9fda20cff926df78Chris Lattner } 5001d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar uint64_t getTypeSize(const Type *T) { 5011d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar return getTypeInfo(T).first; 5021d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar } 503464175bba1318bef7905122e9fda20cff926df78Chris Lattner 50434ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// getTypeAlign - Return the ABI-specified alignment of a type, in bits. 50534ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// This method does not work on incomplete types. 50698be4943e8dc4f3905629a7102668960873cf863Chris Lattner unsigned getTypeAlign(QualType T) { 50798be4943e8dc4f3905629a7102668960873cf863Chris Lattner return getTypeInfo(T).second; 508464175bba1318bef7905122e9fda20cff926df78Chris Lattner } 5091d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar unsigned getTypeAlign(const Type *T) { 5101d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar return getTypeInfo(T).second; 5111d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar } 512464175bba1318bef7905122e9fda20cff926df78Chris Lattner 51334ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// getPreferredTypeAlign - Return the "preferred" alignment of the specified 51434ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// type for the current target in bits. This can be different than the ABI 51534ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// alignment in cases where it is beneficial for performance to overalign 51634ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// a data type. 51734ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner unsigned getPreferredTypeAlign(const Type *T); 51834ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner 519b7d0844c887a72064b624dc6df12cbe1441f69d0Daniel Dunbar /// getDeclAlignInBytes - Return the alignment of the specified decl 520b7d0844c887a72064b624dc6df12cbe1441f69d0Daniel Dunbar /// that should be returned by __alignof(). Note that bitfields do 521b7d0844c887a72064b624dc6df12cbe1441f69d0Daniel Dunbar /// not have a valid alignment, so this method will assert on them. 522b7d0844c887a72064b624dc6df12cbe1441f69d0Daniel Dunbar unsigned getDeclAlignInBytes(const Decl *D); 523af707ab8fbb9451e8febb8d766f6c043628125c4Chris Lattner 52488a981b47c7face1b1fdaa9074256245107b9ca9Devang Patel /// getASTRecordLayout - Get or compute information about the layout of the 525464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// specified record (struct/union/class), which indicates its size and field 526464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// position information. 52798be4943e8dc4f3905629a7102668960873cf863Chris Lattner const ASTRecordLayout &getASTRecordLayout(const RecordDecl *D); 528464175bba1318bef7905122e9fda20cff926df78Chris Lattner 529b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar /// getASTObjCInterfaceLayout - Get or compute information about the 530b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar /// layout of the specified Objective-C interface. 53144a3dded8080c5c9cfdad208ade8f8f7850d9a4fDevang Patel const ASTRecordLayout &getASTObjCInterfaceLayout(const ObjCInterfaceDecl *D); 532b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar 533b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar /// getASTObjCImplementationLayout - Get or compute information about 534b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar /// the layout of the specified Objective-C implementation. This may 535b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar /// differ from the interface if synthesized ivars are present. 536b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar const ASTRecordLayout & 537b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar getASTObjCImplementationLayout(const ObjCImplementationDecl *D); 538b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar 53988e469cf4240d4b898eacc0ad092019b022e0e50Fariborz Jahanian void CollectObjCIvars(const ObjCInterfaceDecl *OI, 5406ab3524f72a6e64aa04973fa9433b5559abb3525Douglas Gregor llvm::SmallVectorImpl<FieldDecl*> &Fields); 5418e6ac1d80055fa37b9b84029c7e751624ba7f84cFariborz Jahanian 5428e6ac1d80055fa37b9b84029c7e751624ba7f84cFariborz Jahanian void ShallowCollectObjCIvars(const ObjCInterfaceDecl *OI, 5438e6ac1d80055fa37b9b84029c7e751624ba7f84cFariborz Jahanian llvm::SmallVectorImpl<ObjCIvarDecl*> &Ivars, 5448e6ac1d80055fa37b9b84029c7e751624ba7f84cFariborz Jahanian bool CollectSynthesized = true); 5459820074dd47d37681085e964cd3392ac0b3e67b9Fariborz Jahanian void CollectSynthesizedIvars(const ObjCInterfaceDecl *OI, 5469820074dd47d37681085e964cd3392ac0b3e67b9Fariborz Jahanian llvm::SmallVectorImpl<ObjCIvarDecl*> &Ivars); 5479820074dd47d37681085e964cd3392ac0b3e67b9Fariborz Jahanian void CollectProtocolSynthesizedIvars(const ObjCProtocolDecl *PD, 5489820074dd47d37681085e964cd3392ac0b3e67b9Fariborz Jahanian llvm::SmallVectorImpl<ObjCIvarDecl*> &Ivars); 5498e6ac1d80055fa37b9b84029c7e751624ba7f84cFariborz Jahanian unsigned CountSynthesizedIvars(const ObjCInterfaceDecl *OI); 5508e6ac1d80055fa37b9b84029c7e751624ba7f84cFariborz Jahanian unsigned CountProtocolSynthesizedIvars(const ObjCProtocolDecl *PD); 551525c9b7baeeff022127cd1b167579f3bda73b3edDaniel Dunbar 552464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 553464175bba1318bef7905122e9fda20cff926df78Chris Lattner // Type Operators 554464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 555464175bba1318bef7905122e9fda20cff926df78Chris Lattner 55677c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// getCanonicalType - Return the canonical (structural) type corresponding to 55777c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// the specified potentially non-canonical type. The non-canonical version 55877c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// of a type may have many "decorated" versions of types. Decorators can 55977c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// include typedefs, 'typeof' operators, etc. The returned type is guaranteed 56077c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// to be free of any of these, allowing two canonical types to be compared 56177c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// for exact equality with a simple pointer comparison. 56277c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner QualType getCanonicalType(QualType T); 5631d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar const Type *getCanonicalType(const Type *T) { 5641d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar return T->getCanonicalTypeInternal().getTypePtr(); 5651d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar } 5662a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor 5678e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor /// \brief Determine whether the given types are equivalent. 5688e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor bool hasSameType(QualType T1, QualType T2) { 5698e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor return getCanonicalType(T1) == getCanonicalType(T2); 5708e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor } 5718e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor 5728e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor /// \brief Determine whether the given types are equivalent after 5738e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor /// cvr-qualifiers have been removed. 5748e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor bool hasSameUnqualifiedType(QualType T1, QualType T2) { 5758e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor T1 = getCanonicalType(T1); 5768e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor T2 = getCanonicalType(T2); 5778e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor return T1.getUnqualifiedType() == T2.getUnqualifiedType(); 5788e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor } 5798e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor 5807da97d0f31e1ec16998d3de2cfd2e88fe3736673Douglas Gregor /// \brief Retrieves the "canonical" declaration of the given declaration. 5817da97d0f31e1ec16998d3de2cfd2e88fe3736673Douglas Gregor Decl *getCanonicalDecl(Decl *D); 5827da97d0f31e1ec16998d3de2cfd2e88fe3736673Douglas Gregor 5832a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor /// \brief Retrieves the "canonical" declaration of the given tag 5842a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor /// declaration. 5852a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor /// 5862a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor /// The canonical declaration for the given tag declaration is 5872a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor /// either the definition of the tag (if it is a complete type) or 5882a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor /// the first declaration of that tag. 5892a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor TagDecl *getCanonicalDecl(TagDecl *Tag) { 5907da97d0f31e1ec16998d3de2cfd2e88fe3736673Douglas Gregor return cast<TagDecl>(getCanonicalDecl((Decl *)Tag)); 5912a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor } 5922a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor 5937da97d0f31e1ec16998d3de2cfd2e88fe3736673Douglas Gregor /// \brief Retrieves the "canonical" declaration of 5947da97d0f31e1ec16998d3de2cfd2e88fe3736673Douglas Gregor 595d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// \brief Retrieves the "canonical" nested name specifier for a 596d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// given nested name specifier. 597d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// 598d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// The canonical nested name specifier is a nested name specifier 599d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// that uniquely identifies a type or namespace within the type 600d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// system. For example, given: 601d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// 602d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// \code 603d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// namespace N { 604d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// struct S { 605d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// template<typename T> struct X { typename T* type; }; 606d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// }; 607d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// } 608d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// 609d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// template<typename T> struct Y { 610d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// typename N::S::X<T>::type member; 611d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// }; 612d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// \endcode 613d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// 614d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// Here, the nested-name-specifier for N::S::X<T>:: will be 615d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// S::X<template-param-0-0>, since 'S' and 'X' are uniquely defined 616d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// by declarations in the type system and the canonical type for 617d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// the template type parameter 'T' is template-param-0-0. 618d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor NestedNameSpecifier * 619d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor getCanonicalNestedNameSpecifier(NestedNameSpecifier *NNS); 620d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor 62125a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// \brief Retrieves the "canonical" template name that refers to a 62225a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// given template. 62325a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// 62425a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// The canonical template name is the simplest expression that can 62525a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// be used to refer to a given template. For most templates, this 62625a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// expression is just the template declaration itself. For example, 62725a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// the template std::vector can be referred to via a variety of 62825a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// names---std::vector, ::std::vector, vector (if vector is in 62925a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// scope), etc.---but all of these names map down to the same 63025a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// TemplateDecl, which is used to form the canonical template name. 63125a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// 63225a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// Dependent template names are more interesting. Here, the 63325a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// template name could be something like T::template apply or 63425a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// std::allocator<T>::template rebind, where the nested name 63525a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// specifier itself is dependent. In this case, the canonical 63625a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// template name uses the shortest form of the dependent 63725a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// nested-name-specifier, which itself contains all canonical 63825a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// types, values, and templates. 63925a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor TemplateName getCanonicalTemplateName(TemplateName Name); 64025a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor 641c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner /// Type Query functions. If the type is an instance of the specified class, 642c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner /// return the Type pointer for the underlying maximally pretty type. This 643c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner /// is a member of ASTContext because this may need to do some amount of 644c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner /// canonicalization, e.g. to move type qualifiers into the element type. 645c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner const ArrayType *getAsArrayType(QualType T); 646c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner const ConstantArrayType *getAsConstantArrayType(QualType T) { 647c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner return dyn_cast_or_null<ConstantArrayType>(getAsArrayType(T)); 648c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner } 649c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner const VariableArrayType *getAsVariableArrayType(QualType T) { 650c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner return dyn_cast_or_null<VariableArrayType>(getAsArrayType(T)); 651c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner } 652c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner const IncompleteArrayType *getAsIncompleteArrayType(QualType T) { 653c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner return dyn_cast_or_null<IncompleteArrayType>(getAsArrayType(T)); 654c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner } 6556183a99b064b397d98297904fbd6cf00fe1f453dAnders Carlsson 6566183a99b064b397d98297904fbd6cf00fe1f453dAnders Carlsson /// getBaseElementType - Returns the innermost element type of a variable 6576183a99b064b397d98297904fbd6cf00fe1f453dAnders Carlsson /// length array type. For example, will return "int" for int[m][n] 6586183a99b064b397d98297904fbd6cf00fe1f453dAnders Carlsson QualType getBaseElementType(const VariableArrayType *VAT); 659c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner 660e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// getArrayDecayedType - Return the properly qualified result of decaying the 661e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// specified array type to a pointer. This operation is non-trivial when 662e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// handling typedefs etc. The canonical type of "T" must be an array type, 663e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// this returns a pointer to a properly qualified element of the array. 664e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// 665e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// See C99 6.7.5.3p7 and C99 6.3.2.1p3. 666e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner QualType getArrayDecayedType(QualType T); 667e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner 6687cfeb08f2466d6263ec6ff1402298f93f6d6991fChris Lattner /// getIntegerTypeOrder - Returns the highest ranked integer type: 6697cfeb08f2466d6263ec6ff1402298f93f6d6991fChris Lattner /// C99 6.3.1.8p1. If LHS > RHS, return 1. If LHS == RHS, return 0. If 6707cfeb08f2466d6263ec6ff1402298f93f6d6991fChris Lattner /// LHS < RHS, return -1. 6717cfeb08f2466d6263ec6ff1402298f93f6d6991fChris Lattner int getIntegerTypeOrder(QualType LHS, QualType RHS); 672a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner 673a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner /// getFloatingTypeOrder - Compare the rank of the two specified floating 674a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner /// point types, ignoring the domain of the type (i.e. 'double' == 675a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner /// '_Complex double'). If LHS > RHS, return 1. If LHS == RHS, return 0. If 676a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner /// LHS < RHS, return -1. 677a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner int getFloatingTypeOrder(QualType LHS, QualType RHS); 6785f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 679716c7304ff5d27a95e1e7823acd1d09d5ec3e37fSteve Naroff /// getFloatingTypeOfSizeWithinDomain - Returns a real floating 680716c7304ff5d27a95e1e7823acd1d09d5ec3e37fSteve Naroff /// point or a complex type (based on typeDomain/typeSize). 681716c7304ff5d27a95e1e7823acd1d09d5ec3e37fSteve Naroff /// 'typeDomain' is a real floating point or complex type. 682716c7304ff5d27a95e1e7823acd1d09d5ec3e37fSteve Naroff /// 'typeSize' is a real floating point or complex type. 683f1448a0e4a1e868ff873a8530a61a09cb68666ccSteve Naroff QualType getFloatingTypeOfSizeWithinDomain(QualType typeSize, 684f1448a0e4a1e868ff873a8530a61a09cb68666ccSteve Naroff QualType typeDomain) const; 685ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff 686f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedmanprivate: 687f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman // Helper for integer ordering 688f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman unsigned getIntegerRank(Type* T); 689f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman 690f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedmanpublic: 691f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman 692ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff //===--------------------------------------------------------------------===// 693ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff // Type Compatibility Predicates 694ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff //===--------------------------------------------------------------------===// 695ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff 696ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff /// Compatibility predicates used to check assignment expressions. 697ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff bool typesAreCompatible(QualType, QualType); // C99 6.2.7p1 698ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff 699a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek bool isObjCIdType(QualType T) const { 700389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff return T == ObjCIdType; 701389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff } 702389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff bool isObjCIdStructType(QualType T) const { 70345ecd5daa36385b7e0b2f657357805e01f5d8cbfSteve Naroff if (!IdStructType) // ObjC isn't enabled 70445ecd5daa36385b7e0b2f657357805e01f5d8cbfSteve Naroff return false; 705ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff return T->getAsStructureType() == IdStructType; 706ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff } 707a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek bool isObjCClassType(QualType T) const { 708389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff return T == ObjCClassType; 709389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff } 710389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff bool isObjCClassStructType(QualType T) const { 71145ecd5daa36385b7e0b2f657357805e01f5d8cbfSteve Naroff if (!ClassStructType) // ObjC isn't enabled 71245ecd5daa36385b7e0b2f657357805e01f5d8cbfSteve Naroff return false; 7138baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson return T->getAsStructureType() == ClassStructType; 7148baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson } 715a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek bool isObjCSelType(QualType T) const { 716a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek assert(SelStructType && "isObjCSelType used before 'SEL' type is built"); 7178baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson return T->getAsStructureType() == SelStructType; 7188baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson } 7198baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson 7203d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman // Check the safety of assignment from LHS to RHS 7213d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman bool canAssignObjCInterfaces(const ObjCInterfaceType *LHS, 7223d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman const ObjCInterfaceType *RHS); 723389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff bool areComparableObjCPointerTypes(QualType LHS, QualType RHS); 7243d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman 7253d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman // Functions for calculating composite types 7263d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman QualType mergeTypes(QualType, QualType); 7273d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman QualType mergeFunctionTypes(QualType, QualType); 7283d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman 729368eefa081d12f0a265ee90ee8ec61b54168d57dChris Lattner //===--------------------------------------------------------------------===// 730ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // Integer Predicates 731ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman //===--------------------------------------------------------------------===// 732ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman 733ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // The width of an integer, as defined in C99 6.2.6.2. This is the number 734ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // of bits in an integer type excluding any padding bits. 735ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman unsigned getIntWidth(QualType T); 736ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman 737ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // Per C99 6.2.5p6, for every signed integer type, there is a corresponding 738ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // unsigned integer type. This method takes a signed type, and returns the 739ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // corresponding unsigned integer type. 740ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman QualType getCorrespondingUnsignedType(QualType T); 741ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman 742ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman //===--------------------------------------------------------------------===// 743e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek // Type Iterators. 744e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek //===--------------------------------------------------------------------===// 745e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek 746e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek typedef std::vector<Type*>::iterator type_iterator; 747e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek typedef std::vector<Type*>::const_iterator const_type_iterator; 748e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek 749e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek type_iterator types_begin() { return Types.begin(); } 750e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek type_iterator types_end() { return Types.end(); } 751e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek const_type_iterator types_begin() const { return Types.begin(); } 752e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek const_type_iterator types_end() const { return Types.end(); } 753e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek 754e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek //===--------------------------------------------------------------------===// 7550cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar // Integer Values 7560cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar //===--------------------------------------------------------------------===// 7570cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar 7580cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar /// MakeIntValue - Make an APSInt of the appropriate width and 7590cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar /// signedness for the given \arg Value and integer \arg Type. 7600cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar llvm::APSInt MakeIntValue(uint64_t Value, QualType Type) { 7610cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar llvm::APSInt Res(getIntWidth(Type), !Type->isSignedIntegerType()); 7620cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar Res = Value; 7630cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar return Res; 7640cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar } 7650cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar 7665f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencerprivate: 7675f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer ASTContext(const ASTContext&); // DO NOT IMPLEMENT 7685f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer void operator=(const ASTContext&); // DO NOT IMPLEMENT 7695f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 7705f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer void InitBuiltinTypes(); 7715f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer void InitBuiltinType(QualType &R, BuiltinType::Kind K); 7724b7c98378ae0c1a3635f0b7756848b4a9923f8bcTed Kremenek 77382a6cfbc421cc99c5b7313271f399f7ef95056ecDaniel Dunbar // Return the ObjC type encoding for a given type. 77482a6cfbc421cc99c5b7313271f399f7ef95056ecDaniel Dunbar void getObjCEncodingForTypeImpl(QualType t, std::string &S, 77582a6cfbc421cc99c5b7313271f399f7ef95056ecDaniel Dunbar bool ExpandPointedToStructures, 77682a6cfbc421cc99c5b7313271f399f7ef95056ecDaniel Dunbar bool ExpandStructures, 777153bfe5795e2c1a5a738e73d3784964e082237fcDaniel Dunbar const FieldDecl *Field, 778090b3f71702c5626d8520f9608d77c6f26dcfa15Fariborz Jahanian bool OutermostType = false, 7796ab3524f72a6e64aa04973fa9433b5559abb3525Douglas Gregor bool EncodingProperty = false); 780b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar 781b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar const ASTRecordLayout &getObjCLayout(const ObjCInterfaceDecl *D, 782b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar const ObjCImplementationDecl *Impl); 7835f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer}; 784e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl 7855f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer} // end namespace clang 7865f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 787e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl// operator new and delete aren't allowed inside namespaces. 788e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl// The throw specifications are mandated by the standard. 789e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @brief Placement new for using the ASTContext's allocator. 790e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// 791e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// This placement form of operator new uses the ASTContext's allocator for 792e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// obtaining memory. It is a non-throwing new, which means that it returns 793e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// null on error. (If that is what the allocator does. The current does, so if 794e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// this ever changes, this operator will have to be changed, too.) 795e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// Usage looks like this (assuming there's an ASTContext 'Context' in scope): 796e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @code 797e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// // Default alignment (16) 798e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// IntegerLiteral *Ex = new (Context) IntegerLiteral(arguments); 799e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// // Specific alignment 800e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// IntegerLiteral *Ex2 = new (Context, 8) IntegerLiteral(arguments); 801e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @endcode 802e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// Please note that you cannot use delete on the pointer; it must be 803e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// deallocated using an explicit destructor call followed by 8044398a78095cd05a3be702fbab25bfe324a5d7946Ted Kremenek/// @c Context.Deallocate(Ptr). 805e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// 806e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @param Bytes The number of bytes to allocate. Calculated by the compiler. 807e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @param C The ASTContext that provides the allocator. 80842542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @param Alignment The alignment of the allocated memory (if the underlying 80942542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// allocator supports it). 810e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @return The allocated memory. Could be NULL. 811e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redlinline void *operator new(size_t Bytes, clang::ASTContext &C, 8129f9bf258f8ebae30bfb70feb9d797d6eb67b0460Douglas Gregor size_t Alignment) throw () { 813c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff return C.Allocate(Bytes, Alignment); 814e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl} 815e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @brief Placement delete companion to the new above. 816e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// 817e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// This operator is just a companion to the new above. There is no way of 818e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// invoking it directly; see the new operator for more details. This operator 819e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// is called implicitly by the compiler if a placement new expression using 820e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// the ASTContext throws in the object constructor. 821fb523e16dd1f860ff02a3ae03e5e3e25327a5860Chris Lattnerinline void operator delete(void *Ptr, clang::ASTContext &C, size_t) 822e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl throw () { 823c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff C.Deallocate(Ptr); 824e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl} 825e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl 82642542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// This placement form of operator new[] uses the ASTContext's allocator for 82742542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// obtaining memory. It is a non-throwing new[], which means that it returns 82842542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// null on error. 82942542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// Usage looks like this (assuming there's an ASTContext 'Context' in scope): 83042542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @code 83142542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// // Default alignment (16) 83242542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// char *data = new (Context) char[10]; 83342542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// // Specific alignment 83442542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// char *data = new (Context, 8) char[10]; 83542542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @endcode 83642542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// Please note that you cannot use delete on the pointer; it must be 83742542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// deallocated using an explicit destructor call followed by 8384398a78095cd05a3be702fbab25bfe324a5d7946Ted Kremenek/// @c Context.Deallocate(Ptr). 83942542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// 84042542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @param Bytes The number of bytes to allocate. Calculated by the compiler. 84142542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @param C The ASTContext that provides the allocator. 84242542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @param Alignment The alignment of the allocated memory (if the underlying 84342542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// allocator supports it). 84442542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @return The allocated memory. Could be NULL. 84542542c6a4b3c60f63820e6177a8938443831492cTed Kremenekinline void *operator new[](size_t Bytes, clang::ASTContext& C, 84642542c6a4b3c60f63820e6177a8938443831492cTed Kremenek size_t Alignment = 16) throw () { 84742542c6a4b3c60f63820e6177a8938443831492cTed Kremenek return C.Allocate(Bytes, Alignment); 84842542c6a4b3c60f63820e6177a8938443831492cTed Kremenek} 84942542c6a4b3c60f63820e6177a8938443831492cTed Kremenek 85042542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @brief Placement delete[] companion to the new[] above. 85142542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// 85242542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// This operator is just a companion to the new[] above. There is no way of 85342542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// invoking it directly; see the new[] operator for more details. This operator 85442542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// is called implicitly by the compiler if a placement new[] expression using 85542542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// the ASTContext throws in the object constructor. 85642542c6a4b3c60f63820e6177a8938443831492cTed Kremenekinline void operator delete[](void *Ptr, clang::ASTContext &C) throw () { 85742542c6a4b3c60f63820e6177a8938443831492cTed Kremenek C.Deallocate(Ptr); 85842542c6a4b3c60f63820e6177a8938443831492cTed Kremenek} 85942542c6a4b3c60f63820e6177a8938443831492cTed Kremenek 8605f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer#endif 861