ASTContext.h revision 9820074dd47d37681085e964cd3392ac0b3e67b9
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" 237532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor#include "clang/AST/TemplateName.h" 24464175bba1318bef7905122e9fda20cff926df78Chris Lattner#include "clang/AST/Type.h" 25e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar#include "clang/Basic/SourceLocation.h" 26464175bba1318bef7905122e9fda20cff926df78Chris Lattner#include "llvm/ADT/DenseMap.h" 2768d331a78e655d97294e94fcfa63f92cc1f40578Steve Naroff#include "llvm/ADT/FoldingSet.h" 282cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor#include "llvm/ADT/OwningPtr.h" 296c2b6eb8d836da19007f7540709e16d5e39a1cbaChris Lattner#include "llvm/Support/Allocator.h" 305f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer#include <vector> 315f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 32b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattnernamespace llvm { 33b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner struct fltSemantics; 34b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner} 35b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner 365f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencernamespace clang { 37a9376d470ccb0eac74fe09a6b2a18a890f1d17c4Chris Lattner class FileManager; 38e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class ASTRecordLayout; 39e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class Expr; 402cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor class ExternalASTSource; 41c7229c338c21ef26b01ef3ecf9eec4fd373fa9ecChris Lattner class IdentifierTable; 42e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class SelectorTable; 43e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class SourceManager; 44d934112e6170b0fd940d8e40db6936cea2cdcf62Douglas Gregor class TargetInfo; 45e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar // Decls 46e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class Decl; 47c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar class ObjCPropertyDecl; 48e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class RecordDecl; 49e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class TagDecl; 50e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class TranslationUnitDecl; 51e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class TypeDecl; 52e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class TypedefDecl; 5372c3f314d92d65c050ee1c07b7753623c044d6c7Douglas Gregor class TemplateTypeParmDecl; 54efc4c4bdbd8fee90b93deb3b5cfaeb044ae22557Fariborz Jahanian class FieldDecl; 55efc4c4bdbd8fee90b93deb3b5cfaeb044ae22557Fariborz Jahanian class ObjCIvarRefExpr; 56efc4c4bdbd8fee90b93deb3b5cfaeb044ae22557Fariborz Jahanian class ObjCIvarDecl; 57efc4c4bdbd8fee90b93deb3b5cfaeb044ae22557Fariborz Jahanian 585f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer/// ASTContext - This class holds long-lived AST nodes (such as types and 595f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer/// decls) that can be referred to throughout the semantic analysis of a file. 602bd24ba6d10f8c811c8e2a57c8397e07082ba497Ted Kremenekclass ASTContext { 615f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer std::vector<Type*> Types; 62f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian llvm::FoldingSet<ExtQualType> ExtQualTypes; 635f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer llvm::FoldingSet<ComplexType> ComplexTypes; 645f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer llvm::FoldingSet<PointerType> PointerTypes; 655618bd4a52c45fbbb605e3ba885663b2164db8a3Steve Naroff llvm::FoldingSet<BlockPointerType> BlockPointerTypes; 667c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl llvm::FoldingSet<LValueReferenceType> LValueReferenceTypes; 677c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl llvm::FoldingSet<RValueReferenceType> RValueReferenceTypes; 68f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl llvm::FoldingSet<MemberPointerType> MemberPointerTypes; 697192f8e9592729882a09d84d77838db26e39ebd4Ted Kremenek llvm::FoldingSet<ConstantArrayType> ConstantArrayTypes; 70c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman llvm::FoldingSet<IncompleteArrayType> IncompleteArrayTypes; 71c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman std::vector<VariableArrayType*> VariableArrayTypes; 72898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor std::vector<DependentSizedArrayType*> DependentSizedArrayTypes; 735f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer llvm::FoldingSet<VectorType> VectorTypes; 7472564e73277e29f6db3305d1f27ba408abb7ed88Douglas Gregor llvm::FoldingSet<FunctionNoProtoType> FunctionNoProtoTypes; 7572564e73277e29f6db3305d1f27ba408abb7ed88Douglas Gregor llvm::FoldingSet<FunctionProtoType> FunctionProtoTypes; 76fab9d67cebb87be968e7ae31a3b549a5279b5d51Douglas Gregor llvm::FoldingSet<TemplateTypeParmType> TemplateTypeParmTypes; 777532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor llvm::FoldingSet<TemplateSpecializationType> TemplateSpecializationTypes; 78e4e5b054b4917f0ee493bb2fda5b1ec749bfb9a1Douglas Gregor llvm::FoldingSet<QualifiedNameType> QualifiedNameTypes; 79d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor llvm::FoldingSet<TypenameType> TypenameTypes; 80a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek llvm::FoldingSet<ObjCQualifiedInterfaceType> ObjCQualifiedInterfaceTypes; 81a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek llvm::FoldingSet<ObjCQualifiedIdType> ObjCQualifiedIdTypes; 82ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor 837532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor llvm::FoldingSet<QualifiedTemplateName> QualifiedTemplateNames; 847532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor llvm::FoldingSet<DependentTemplateName> DependentTemplateNames; 857532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor 86ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor /// \brief The set of nested name specifiers. 87ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor /// 88ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor /// This set is managed by the NestedNameSpecifier class. 89ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor llvm::FoldingSet<NestedNameSpecifier> NestedNameSpecifiers; 90ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor NestedNameSpecifier *GlobalNestedNameSpecifier; 91ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor friend class NestedNameSpecifier; 92ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor 9388a981b47c7face1b1fdaa9074256245107b9ca9Devang Patel /// ASTRecordLayouts - A cache mapping from RecordDecls to ASTRecordLayouts. 94a9a4a24592a2164114a8a36717650e6341eb67a4Ted Kremenek /// This is lazily created. This is intentionally not serialized. 9588a981b47c7face1b1fdaa9074256245107b9ca9Devang Patel llvm::DenseMap<const RecordDecl*, const ASTRecordLayout*> ASTRecordLayouts; 96b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar llvm::DenseMap<const ObjCContainerDecl*, const ASTRecordLayout*> ObjCLayouts; 97f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman 98f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman llvm::DenseMap<unsigned, FixedWidthIntType*> SignedFixedWidthIntTypes; 99f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman llvm::DenseMap<unsigned, FixedWidthIntType*> UnsignedFixedWidthIntTypes; 100a769c004a2874504c17ea8afccbc4ad35fc33c9fFariborz Jahanian 101b2cf3573d7351094f6247fcca94703ce88eb9ee0Anders Carlsson /// BuiltinVaListType - built-in va list type. 102b2cf3573d7351094f6247fcca94703ce88eb9ee0Anders Carlsson /// This is initially null and set by Sema::LazilyCreateBuiltin when 103b2cf3573d7351094f6247fcca94703ce88eb9ee0Anders Carlsson /// a builtin that takes a valist is encountered. 104b2cf3573d7351094f6247fcca94703ce88eb9ee0Anders Carlsson QualType BuiltinVaListType; 1057e219e47de26346885d667131977bd9ca2d7662aSteve Naroff 1066083ea3723ec3996ae3bdf8d1b352b0c3b3922c8Ted Kremenek /// ObjCIdType - a pseudo built-in typedef type (set by Sema). 107a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType ObjCIdType; 1087e219e47de26346885d667131977bd9ca2d7662aSteve Naroff const RecordType *IdStructType; 1092198891824c38d45b2279de5d5e3ef9394eb457cSteve Naroff 1106083ea3723ec3996ae3bdf8d1b352b0c3b3922c8Ted Kremenek /// ObjCSelType - another pseudo built-in typedef type (set by Sema). 111a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType ObjCSelType; 112b62f6813406a03bf8a371c4e46c9fad51d102121Fariborz Jahanian const RecordType *SelStructType; 113b62f6813406a03bf8a371c4e46c9fad51d102121Fariborz Jahanian 1146083ea3723ec3996ae3bdf8d1b352b0c3b3922c8Ted Kremenek /// ObjCProtoType - another pseudo built-in typedef type (set by Sema). 115a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType ObjCProtoType; 116390d50a725497e99247dc104a7d2c2a255d3af14Fariborz Jahanian const RecordType *ProtoStructType; 1178baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson 1186083ea3723ec3996ae3bdf8d1b352b0c3b3922c8Ted Kremenek /// ObjCClassType - another pseudo built-in typedef type (set by Sema). 119a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType ObjCClassType; 1208baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson const RecordType *ClassStructType; 121390d50a725497e99247dc104a7d2c2a255d3af14Fariborz Jahanian 122a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType ObjCConstantStringType; 1232198891824c38d45b2279de5d5e3ef9394eb457cSteve Naroff RecordDecl *CFConstantStringTypeDecl; 1247a9d49fd2bfac00e905b361ba76d26ab5b6c3b09Ted Kremenek 125bd4c1ada2e8668f43a865dc2c662085cf61940c4Anders Carlsson RecordDecl *ObjCFastEnumerationStateTypeDecl; 126bd4c1ada2e8668f43a865dc2c662085cf61940c4Anders Carlsson 127ef177820100ab583b08fd3056e2a5a52ee4b1629Argyrios Kyrtzidis TranslationUnitDecl *TUDecl; 128ef177820100ab583b08fd3056e2a5a52ee4b1629Argyrios Kyrtzidis 129e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek /// SourceMgr - The associated SourceManager object. 130b800dc2d5e27ec60f567567b623cdc61152b8fb8Chris Lattner SourceManager &SourceMgr; 131e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek 132e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek /// LangOpts - The language options used to create the AST associated with 133e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek /// this ASTContext object. 134e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek LangOptions LangOpts; 135e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek 136c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff /// MallocAlloc/BumpAlloc - The allocator objects used to create AST objects. 137c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff bool FreeMemory; 138c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff llvm::MallocAllocator MallocAlloc; 139c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff llvm::BumpPtrAllocator BumpAlloc; 1406ab3524f72a6e64aa04973fa9433b5559abb3525Douglas Gregorpublic: 1415f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer TargetInfo &Target; 14271993dd85eed9cc42c6b2fa61ee5c53026b74817Anders Carlsson IdentifierTable &Idents; 14329238a0bf7cbf5b396efb451a0adb5fe4aa037caSteve Naroff SelectorTable &Selectors; 1442e1cd4264d363ca869bf37ef160902f211d21b8cDouglas Gregor DeclarationNameTable DeclarationNames; 1452cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor llvm::OwningPtr<ExternalASTSource> ExternalSource; 1462e1cd4264d363ca869bf37ef160902f211d21b8cDouglas Gregor 1477a9d49fd2bfac00e905b361ba76d26ab5b6c3b09Ted Kremenek SourceManager& getSourceManager() { return SourceMgr; } 148a9376d470ccb0eac74fe09a6b2a18a890f1d17c4Chris Lattner const SourceManager& getSourceManager() const { return SourceMgr; } 149c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff void *Allocate(unsigned Size, unsigned Align = 8) { 150c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff return FreeMemory ? MallocAlloc.Allocate(Size, Align) : 151c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff BumpAlloc.Allocate(Size, Align); 152c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff } 153c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff void Deallocate(void *Ptr) { 154c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff if (FreeMemory) 155c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff MallocAlloc.Deallocate(Ptr); 156c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff } 157e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek const LangOptions& getLangOptions() const { return LangOpts; } 1586c2b6eb8d836da19007f7540709e16d5e39a1cbaChris Lattner 1599c728dc4d8da89c73fcae74c9e72d7a83ffd7b6dTed Kremenek FullSourceLoc getFullLoc(SourceLocation Loc) const { 1609c728dc4d8da89c73fcae74c9e72d7a83ffd7b6dTed Kremenek return FullSourceLoc(Loc,SourceMgr); 1619c728dc4d8da89c73fcae74c9e72d7a83ffd7b6dTed Kremenek } 162ef177820100ab583b08fd3056e2a5a52ee4b1629Argyrios Kyrtzidis 163ef177820100ab583b08fd3056e2a5a52ee4b1629Argyrios Kyrtzidis TranslationUnitDecl *getTranslationUnitDecl() const { return TUDecl; } 164ef177820100ab583b08fd3056e2a5a52ee4b1629Argyrios Kyrtzidis 1655f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer Builtin::Context BuiltinInfo; 1665f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 1675f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer // Builtin Types. 1685f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType VoidTy; 1695f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType BoolTy; 1705f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType CharTy; 1713a2503227c3db04a3619735127483263c1075ef7Chris Lattner QualType WCharTy; // [C++ 3.9.1p5], integer type in C99. 1722df9ced9fd1e8c7d7b38443db07e0e811de22571Chris Lattner QualType SignedCharTy, ShortTy, IntTy, LongTy, LongLongTy, Int128Ty; 1735f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType UnsignedCharTy, UnsignedShortTy, UnsignedIntTy, UnsignedLongTy; 1742df9ced9fd1e8c7d7b38443db07e0e811de22571Chris Lattner QualType UnsignedLongLongTy, UnsignedInt128Ty; 1755f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType FloatTy, DoubleTy, LongDoubleTy; 1765f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType FloatComplexTy, DoubleComplexTy, LongDoubleComplexTy; 1776e8ed16ffef02b82995a90bdcf10ffff7d63839aSebastian Redl QualType VoidPtrTy, NullPtrTy; 1788e9bebdea69c590dedfbf27374114cb76fe12fbdDouglas Gregor QualType OverloadTy; 179898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor QualType DependentTy; 1808e9bebdea69c590dedfbf27374114cb76fe12fbdDouglas Gregor 181e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek ASTContext(const LangOptions& LOpts, SourceManager &SM, TargetInfo &t, 182c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff IdentifierTable &idents, SelectorTable &sels, 1832deaea37a637dd01221d0cced343702a39d8132cDouglas Gregor bool FreeMemory = true, unsigned size_reserve=0, 1842deaea37a637dd01221d0cced343702a39d8132cDouglas Gregor bool InitializeBuiltins = true); 185fee0452973f28691a61aab0fb074468ce3e34b9bTed Kremenek 1865f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer ~ASTContext(); 1876ab3524f72a6e64aa04973fa9433b5559abb3525Douglas Gregor 1882deaea37a637dd01221d0cced343702a39d8132cDouglas Gregor /// \brief Initialize builtins. 1892deaea37a637dd01221d0cced343702a39d8132cDouglas Gregor /// 1902deaea37a637dd01221d0cced343702a39d8132cDouglas Gregor /// Typically, this routine will be called automatically by the 1912deaea37a637dd01221d0cced343702a39d8132cDouglas Gregor /// constructor. However, in certain cases (e.g., when there is a 1922deaea37a637dd01221d0cced343702a39d8132cDouglas Gregor /// PCH file to be loaded), the constructor does not perform 1932deaea37a637dd01221d0cced343702a39d8132cDouglas Gregor /// initialization for builtins. This routine can be called to 1942deaea37a637dd01221d0cced343702a39d8132cDouglas Gregor /// perform the initialization. 1952deaea37a637dd01221d0cced343702a39d8132cDouglas Gregor void InitializeBuiltins(IdentifierTable &idents); 1962deaea37a637dd01221d0cced343702a39d8132cDouglas Gregor 1972cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// \brief Attach an external AST source to the AST context. 1982cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// 1992cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// The external AST source provides the ability to load parts of 2002cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// the abstract syntax tree as needed from some external storage, 2012cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// e.g., a precompiled header. 2022cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor void setExternalSource(llvm::OwningPtr<ExternalASTSource> &Source); 2032cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor 2042cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// \brief Retrieve a pointer to the external AST source associated 2052cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// with this AST context, if any. 2062cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor ExternalASTSource *getExternalSource() const { return ExternalSource.get(); } 2072cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor 2085f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer void PrintStats() const; 20903ed44061df258e74a40383bda849e14b892a8c6Ted Kremenek const std::vector<Type*>& getTypes() const { return Types; } 21003ed44061df258e74a40383bda849e14b892a8c6Ted Kremenek 211464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 212464175bba1318bef7905122e9fda20cff926df78Chris Lattner // Type Constructors 213464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 214d2d2a11a91d7ddf468bfb70f66362d24806ed601Chris Lattner 215f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian /// getAddSpaceQualType - Return the uniqued reference to the type for an 216f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian /// address space qualified type with the specified type and address space. 217f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian /// The resulting type has a union of the qualifiers from T and the address 218f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian /// space. If T already has an address space specifier, it is silently 219f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian /// replaced. 220f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian QualType getAddrSpaceQualType(QualType T, unsigned AddressSpace); 221ebb97e98c03f8d7034bd3748a10e35f39a95c289Christopher Lamb 222d33d9c0cc0cfdcd0b10f35a6acdfb25da4a64f19Fariborz Jahanian /// getObjCGCQualType - Returns the uniqued reference to the type for an 223d33d9c0cc0cfdcd0b10f35a6acdfb25da4a64f19Fariborz Jahanian /// objc gc qualified type. The retulting type has a union of the qualifiers 224d33d9c0cc0cfdcd0b10f35a6acdfb25da4a64f19Fariborz Jahanian /// from T and the gc attribute. 225d33d9c0cc0cfdcd0b10f35a6acdfb25da4a64f19Fariborz Jahanian QualType getObjCGCQualType(QualType T, QualType::GCAttrTypes gcAttr); 226d33d9c0cc0cfdcd0b10f35a6acdfb25da4a64f19Fariborz Jahanian 2275f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getComplexType - Return the uniqued reference to the type for a complex 2285f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// number with the specified element type. 2295f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getComplexType(QualType T); 2305f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 2315f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getPointerType - Return the uniqued reference to the type for a pointer to 2325f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// the specified type. 2335f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getPointerType(QualType T); 2345618bd4a52c45fbbb605e3ba885663b2164db8a3Steve Naroff 2355618bd4a52c45fbbb605e3ba885663b2164db8a3Steve Naroff /// getBlockPointerType - Return the uniqued reference to the type for a block 2365618bd4a52c45fbbb605e3ba885663b2164db8a3Steve Naroff /// of the specified type. 2375618bd4a52c45fbbb605e3ba885663b2164db8a3Steve Naroff QualType getBlockPointerType(QualType T); 238f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl 2397c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl /// getLValueReferenceType - Return the uniqued reference to the type for an 2407c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl /// lvalue reference to the specified type. 2417c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl QualType getLValueReferenceType(QualType T); 2427c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl 2437c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl /// getRValueReferenceType - Return the uniqued reference to the type for an 2447c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl /// rvalue reference to the specified type. 2457c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl QualType getRValueReferenceType(QualType T); 246f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl 247f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl /// getMemberPointerType - Return the uniqued reference to the type for a 248f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl /// member pointer to the specified type in the specified class. The class 249f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl /// is a Type because it could be a dependent name. 250f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl QualType getMemberPointerType(QualType T, const Type *Cls); 251f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl 252bdbf7b030a3e0ddb95240076683830e6f78c79a5Steve Naroff /// getVariableArrayType - Returns a non-unique reference to the type for a 253bdbf7b030a3e0ddb95240076683830e6f78c79a5Steve Naroff /// variable array of the specified element type. 254c9406125e2cac9208098655ac8058c095c2c3a65Steve Naroff QualType getVariableArrayType(QualType EltTy, Expr *NumElts, 255c9406125e2cac9208098655ac8058c095c2c3a65Steve Naroff ArrayType::ArraySizeModifier ASM, 256c9406125e2cac9208098655ac8058c095c2c3a65Steve Naroff unsigned EltTypeQuals); 257898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor 258898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor /// getDependentSizedArrayType - Returns a non-unique reference to 259898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor /// the type for a dependently-sized array of the specified element 260898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor /// type. FIXME: We will need these to be uniqued, or at least 261898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor /// comparable, at some point. 262898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor QualType getDependentSizedArrayType(QualType EltTy, Expr *NumElts, 263fea8685bf3036b199c573e70b03affde2583fc44Nate Begeman ArrayType::ArraySizeModifier ASM, 264fea8685bf3036b199c573e70b03affde2583fc44Nate Begeman unsigned EltTypeQuals); 265fb22d96692c5240fb8d611290dbf7eeed3759c73Steve Naroff 266c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman /// getIncompleteArrayType - Returns a unique reference to the type for a 267c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman /// incomplete array of the specified element type. 268c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman QualType getIncompleteArrayType(QualType EltTy, 269c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman ArrayType::ArraySizeModifier ASM, 270c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman unsigned EltTypeQuals); 271c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman 272bdbf7b030a3e0ddb95240076683830e6f78c79a5Steve Naroff /// getConstantArrayType - Return the unique reference to the type for a 273bdbf7b030a3e0ddb95240076683830e6f78c79a5Steve Naroff /// constant array of the specified element type. 274c9406125e2cac9208098655ac8058c095c2c3a65Steve Naroff QualType getConstantArrayType(QualType EltTy, const llvm::APInt &ArySize, 275c9406125e2cac9208098655ac8058c095c2c3a65Steve Naroff ArrayType::ArraySizeModifier ASM, 276c9406125e2cac9208098655ac8058c095c2c3a65Steve Naroff unsigned EltTypeQuals); 2775f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 27873322924127c873c13101b705dd823f5539ffa5fSteve Naroff /// getVectorType - Return the unique reference to a vector type of 27973322924127c873c13101b705dd823f5539ffa5fSteve Naroff /// the specified element type and size. VectorType must be a built-in type. 28073322924127c873c13101b705dd823f5539ffa5fSteve Naroff QualType getVectorType(QualType VectorType, unsigned NumElts); 28173322924127c873c13101b705dd823f5539ffa5fSteve Naroff 282213541a68a3e137d11d2cefb612c6cdb410d7e8eNate Begeman /// getExtVectorType - Return the unique reference to an extended vector type 283213541a68a3e137d11d2cefb612c6cdb410d7e8eNate Begeman /// of the specified element type and size. VectorType must be a built-in 284213541a68a3e137d11d2cefb612c6cdb410d7e8eNate Begeman /// type. 285213541a68a3e137d11d2cefb612c6cdb410d7e8eNate Begeman QualType getExtVectorType(QualType VectorType, unsigned NumElts); 2865f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 28772564e73277e29f6db3305d1f27ba408abb7ed88Douglas Gregor /// getFunctionNoProtoType - Return a K&R style C function type like 'int()'. 2885f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// 28972564e73277e29f6db3305d1f27ba408abb7ed88Douglas Gregor QualType getFunctionNoProtoType(QualType ResultTy); 290bfa2fcba545fb270f31205d616846c2bfaf4e47eSebastian Redl 2915f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getFunctionType - Return a normal function type with a typed argument 2925f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// list. isVariadic indicates whether the argument list includes '...'. 29386da77fdaf4c0237eafb9670f54eee20b08635bfEli Friedman QualType getFunctionType(QualType ResultTy, const QualType *ArgArray, 294971c4fae6092976338b755af1d47dac07c8f16e3Argyrios Kyrtzidis unsigned NumArgs, bool isVariadic, 295bfa2fcba545fb270f31205d616846c2bfaf4e47eSebastian Redl unsigned TypeQuals); 2962ce52f3fb95bf544db6bd3d91a72bce7d9cceb6cDouglas Gregor 2972ce52f3fb95bf544db6bd3d91a72bce7d9cceb6cDouglas Gregor /// getTypeDeclType - Return the unique reference to the type for 2982ce52f3fb95bf544db6bd3d91a72bce7d9cceb6cDouglas Gregor /// the specified type declaration. 2994b7c98378ae0c1a3635f0b7756848b4a9923f8bcTed Kremenek QualType getTypeDeclType(TypeDecl *Decl, TypeDecl* PrevDecl=0); 3002ce52f3fb95bf544db6bd3d91a72bce7d9cceb6cDouglas Gregor 3015f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getTypedefType - Return the unique reference to the type for the 3025f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// specified typename decl. 3035f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getTypedefType(TypedefDecl *Decl); 3043b3a45858c6b2a45114e91902c3bf3c4b7f5f302Daniel Dunbar QualType getObjCInterfaceType(const ObjCInterfaceDecl *Decl); 305fab9d67cebb87be968e7ae31a3b549a5279b5d51Douglas Gregor 306fab9d67cebb87be968e7ae31a3b549a5279b5d51Douglas Gregor QualType getTemplateTypeParmType(unsigned Depth, unsigned Index, 307fab9d67cebb87be968e7ae31a3b549a5279b5d51Douglas Gregor IdentifierInfo *Name = 0); 308fab9d67cebb87be968e7ae31a3b549a5279b5d51Douglas Gregor 3097532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor QualType getTemplateSpecializationType(TemplateName T, 3107532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor const TemplateArgument *Args, 3117532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor unsigned NumArgs, 3127532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor QualType Canon = QualType()); 31355f6b14230c94272efbbcdd89a92224c8db9f225Douglas Gregor 314ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor QualType getQualifiedNameType(NestedNameSpecifier *NNS, 315e4e5b054b4917f0ee493bb2fda5b1ec749bfb9a1Douglas Gregor QualType NamedType); 316d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor QualType getTypenameType(NestedNameSpecifier *NNS, 317d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor const IdentifierInfo *Name, 318d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor QualType Canon = QualType()); 3191734317845d60307d474b5da8a8d33adbaf5e723Douglas Gregor QualType getTypenameType(NestedNameSpecifier *NNS, 3201734317845d60307d474b5da8a8d33adbaf5e723Douglas Gregor const TemplateSpecializationType *TemplateId, 3211734317845d60307d474b5da8a8d33adbaf5e723Douglas Gregor QualType Canon = QualType()); 322e4e5b054b4917f0ee493bb2fda5b1ec749bfb9a1Douglas Gregor 323a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek /// getObjCQualifiedInterfaceType - Return a 324a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek /// ObjCQualifiedInterfaceType type for the given interface decl and 3254b6c9051c6522894978c9ba6a819a659d102db36Fariborz Jahanian /// the conforming protocol list. 326a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType getObjCQualifiedInterfaceType(ObjCInterfaceDecl *Decl, 32792dd386e3f05d176b45a638199d51f536bd9d1c4Chris Lattner ObjCProtocolDecl **ProtocolList, 32892dd386e3f05d176b45a638199d51f536bd9d1c4Chris Lattner unsigned NumProtocols); 329c569249ca0ab755ac79d8cbbfcb2bcae19743624Fariborz Jahanian 330a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek /// getObjCQualifiedIdType - Return an ObjCQualifiedIdType for a 331c569249ca0ab755ac79d8cbbfcb2bcae19743624Fariborz Jahanian /// given 'id' and conforming protocol list. 33262f5f7ffad57e0c2af2b308af3735351505937cbChris Lattner QualType getObjCQualifiedIdType(ObjCProtocolDecl **ProtocolList, 333c569249ca0ab755ac79d8cbbfcb2bcae19743624Fariborz Jahanian unsigned NumProtocols); 334c569249ca0ab755ac79d8cbbfcb2bcae19743624Fariborz Jahanian 3355f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 336d1861fd633d5096a00777c918eb8575ea7162fe7Steve Naroff /// getTypeOfType - GCC extension. 33772564e73277e29f6db3305d1f27ba408abb7ed88Douglas Gregor QualType getTypeOfExprType(Expr *e); 338d1861fd633d5096a00777c918eb8575ea7162fe7Steve Naroff QualType getTypeOfType(QualType t); 339d1861fd633d5096a00777c918eb8575ea7162fe7Steve Naroff 3405f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getTagDeclType - Return the unique reference to the type for the 3415f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// specified TagDecl (struct/union/class/enum) decl. 3425f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getTagDeclType(TagDecl *Decl); 3435f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 3445f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getSizeType - Return the unique type for "size_t" (C99 7.17), defined 3455f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// in <stddef.h>. The sizeof operator requires this (C99 6.5.3.4p4). 3465f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getSizeType() const; 347fd888a581d6d329f5b447c8ff4d37cf396315993Eli Friedman 3483a2503227c3db04a3619735127483263c1075ef7Chris Lattner /// getWCharType - In C++, this returns the unique wchar_t type. In C99, this 3493a2503227c3db04a3619735127483263c1075ef7Chris Lattner /// returns a type compatible with the type defined in <stddef.h> as defined 3503a2503227c3db04a3619735127483263c1075ef7Chris Lattner /// by the target. 3513a2503227c3db04a3619735127483263c1075ef7Chris Lattner QualType getWCharType() const { return WCharTy; } 35264c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis 35364c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis /// getSignedWCharType - Return the type of "signed wchar_t". 35464c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis /// Used when in C++, as a GCC extension. 35564c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis QualType getSignedWCharType() const; 35664c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis 35764c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis /// getUnsignedWCharType - Return the type of "unsigned wchar_t". 35864c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis /// Used when in C++, as a GCC extension. 35964c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis QualType getUnsignedWCharType() const; 3605f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 3618b9023ba35a86838789e2c9034a6128728c547aaChris Lattner /// getPointerDiffType - Return the unique type for "ptrdiff_t" (ref?) 3628b9023ba35a86838789e2c9034a6128728c547aaChris Lattner /// defined in <stddef.h>. Pointer - pointer requires this (C99 6.5.6p9). 3638b9023ba35a86838789e2c9034a6128728c547aaChris Lattner QualType getPointerDiffType() const; 3648b9023ba35a86838789e2c9034a6128728c547aaChris Lattner 365beaf299a2701c5559a4e5d76b0c40f805afb8e6aSteve Naroff // getCFConstantStringType - Return the C structure type used to represent 366beaf299a2701c5559a4e5d76b0c40f805afb8e6aSteve Naroff // constant CFStrings. 36771993dd85eed9cc42c6b2fa61ee5c53026b74817Anders Carlsson QualType getCFConstantStringType(); 36871993dd85eed9cc42c6b2fa61ee5c53026b74817Anders Carlsson 369319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor /// Get the structure type used to representation CFStrings, or NULL 370319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor /// if it hasn't yet been built. 371319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor QualType getRawCFConstantStringType() { 372319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor if (CFConstantStringTypeDecl) 373319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor return getTagDeclType(CFConstantStringTypeDecl); 374319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor return QualType(); 375319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor } 376319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor void setCFConstantStringType(QualType T); 377319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor 378983df5b2280980e59b0b062bcc2882230465a61eSteve Naroff // This setter/getter represents the ObjC type for an NSConstantString. 379a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek void setObjCConstantStringInterface(ObjCInterfaceDecl *Decl); 380a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType getObjCConstantStringInterface() const { 381a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek return ObjCConstantStringType; 3822198891824c38d45b2279de5d5e3ef9394eb457cSteve Naroff } 383b62f6813406a03bf8a371c4e46c9fad51d102121Fariborz Jahanian 384bd4c1ada2e8668f43a865dc2c662085cf61940c4Anders Carlsson //// This gets the struct used to keep track of fast enumerations. 385bd4c1ada2e8668f43a865dc2c662085cf61940c4Anders Carlsson QualType getObjCFastEnumerationStateType(); 386bd4c1ada2e8668f43a865dc2c662085cf61940c4Anders Carlsson 387319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor /// Get the ObjCFastEnumerationState type, or NULL if it hasn't yet 388319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor /// been built. 389319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor QualType getRawObjCFastEnumerationStateType() { 390319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor if (ObjCFastEnumerationStateTypeDecl) 391319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor return getTagDeclType(ObjCFastEnumerationStateTypeDecl); 392319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor return QualType(); 393319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor } 394319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor 395319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor void setObjCFastEnumerationStateType(QualType T); 396319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor 397d96b35bc6becf8db00d140c11e3d0e53f27567a1Daniel Dunbar /// getObjCEncodingForType - Emit the ObjC type encoding for the 398d96b35bc6becf8db00d140c11e3d0e53f27567a1Daniel Dunbar /// given type into \arg S. If \arg NameFields is specified then 399d96b35bc6becf8db00d140c11e3d0e53f27567a1Daniel Dunbar /// record field names are also encoded. 4007d6b46d9a9d75dea8ef9f6973dd50633c1f37963Fariborz Jahanian void getObjCEncodingForType(QualType t, std::string &S, 401153bfe5795e2c1a5a738e73d3784964e082237fcDaniel Dunbar const FieldDecl *Field=0); 402a1c033e9514865f3a7b0d8b3b20e6de926cfec6cFariborz Jahanian 403a1c033e9514865f3a7b0d8b3b20e6de926cfec6cFariborz Jahanian void getLegacyIntegralTypeEncoding(QualType &t) const; 40433e1d64ab5cd5d27f8530ccd056191fe2c9f3f2eFariborz Jahanian 405ecb01e666665efabd2aa76a76f6080e2a78965faFariborz Jahanian // Put the string version of type qualifiers into S. 406a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek void getObjCEncodingForTypeQualifier(Decl::ObjCDeclQualifier QT, 407ecb01e666665efabd2aa76a76f6080e2a78965faFariborz Jahanian std::string &S) const; 408ecb01e666665efabd2aa76a76f6080e2a78965faFariborz Jahanian 409a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek /// getObjCEncodingForMethodDecl - Return the encoded type for this method 41033e1d64ab5cd5d27f8530ccd056191fe2c9f3f2eFariborz Jahanian /// declaration. 411c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar void getObjCEncodingForMethodDecl(const ObjCMethodDecl *Decl, std::string &S); 412c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar 413c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar /// getObjCEncodingForPropertyDecl - Return the encoded type for 414c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar /// this method declaration. If non-NULL, Container must be either 415c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar /// an ObjCCategoryImplDecl or ObjCImplementationDecl; it should 416c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar /// only be NULL when getting encodings for protocol properties. 41777a49f6b1e5741f6bda71eb7837b43343925027bArgyrios Kyrtzidis void getObjCEncodingForPropertyDecl(const ObjCPropertyDecl *PD, 418c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar const Decl *Container, 419c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar std::string &S); 42033e1d64ab5cd5d27f8530ccd056191fe2c9f3f2eFariborz Jahanian 421a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek /// getObjCEncodingTypeSize returns size of type for objective-c encoding 42233e1d64ab5cd5d27f8530ccd056191fe2c9f3f2eFariborz Jahanian /// purpose. 423a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek int getObjCEncodingTypeSize(QualType t); 42485f9bceab1542aafff012d4d28e998f4ba16e362Anders Carlsson 425d85376aa66bc16488539f6bb11f97d0170b1fe6bChris Lattner /// This setter/getter represents the ObjC 'id' type. It is setup lazily, by 426d85376aa66bc16488539f6bb11f97d0170b1fe6bChris Lattner /// Sema. id is always a (typedef for a) pointer type, a pointer to a struct. 427a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType getObjCIdType() const { return ObjCIdType; } 428319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor void setObjCIdType(QualType T); 429b62f6813406a03bf8a371c4e46c9fad51d102121Fariborz Jahanian 430319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor void setObjCSelType(QualType T); 431a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType getObjCSelType() const { return ObjCSelType; } 432b62f6813406a03bf8a371c4e46c9fad51d102121Fariborz Jahanian 433a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek void setObjCProtoType(QualType QT); 434a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType getObjCProtoType() const { return ObjCProtoType; } 435390d50a725497e99247dc104a7d2c2a255d3af14Fariborz Jahanian 436d85376aa66bc16488539f6bb11f97d0170b1fe6bChris Lattner /// This setter/getter repreents the ObjC 'Class' type. It is setup lazily, by 437d85376aa66bc16488539f6bb11f97d0170b1fe6bChris Lattner /// Sema. 'Class' is always a (typedef for a) pointer type, a pointer to a 438d85376aa66bc16488539f6bb11f97d0170b1fe6bChris Lattner /// struct. 439a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType getObjCClassType() const { return ObjCClassType; } 440319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor void setObjCClassType(QualType T); 4418baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson 442b2cf3573d7351094f6247fcca94703ce88eb9ee0Anders Carlsson void setBuiltinVaListType(QualType T); 443b2cf3573d7351094f6247fcca94703ce88eb9ee0Anders Carlsson QualType getBuiltinVaListType() const { return BuiltinVaListType; } 444f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman 445f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman QualType getFixedWidthIntType(unsigned Width, bool Signed); 446f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman 4477532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor TemplateName getQualifiedTemplateName(NestedNameSpecifier *NNS, 4487532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor bool TemplateKeyword, 4497532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor TemplateDecl *Template); 4507532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor 4517532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor TemplateName getDependentTemplateName(NestedNameSpecifier *NNS, 4527532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor const IdentifierInfo *Name); 4537532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor 454d934112e6170b0fd940d8e40db6936cea2cdcf62Douglas Gregorprivate: 455d934112e6170b0fd940d8e40db6936cea2cdcf62Douglas Gregor QualType getFromTargetType(unsigned Type) const; 456b4e66d5259f90e9aae4d40fc5de801e046c7df94Douglas Gregor 457464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 458b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek // Type Predicates. 459b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek //===--------------------------------------------------------------------===// 460d934112e6170b0fd940d8e40db6936cea2cdcf62Douglas Gregor 461d934112e6170b0fd940d8e40db6936cea2cdcf62Douglas Gregorpublic: 462b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek /// isObjCObjectPointerType - Returns true if type is an Objective-C pointer 463b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek /// to an object type. This includes "id" and "Class" (two 'special' pointers 464b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek /// to struct), Interface* (pointer to ObjCInterfaceType) and id<P> (qualified 465b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek /// ID type). 466b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek bool isObjCObjectPointerType(QualType Ty) const; 4674fd83ea566f4a0c083001c84b75da6cc8c99c1d6Fariborz Jahanian 4684fd83ea566f4a0c083001c84b75da6cc8c99c1d6Fariborz Jahanian /// getObjCGCAttr - Returns one of GCNone, Weak or Strong objc's 4694fd83ea566f4a0c083001c84b75da6cc8c99c1d6Fariborz Jahanian /// garbage collection attribute. 4704fd83ea566f4a0c083001c84b75da6cc8c99c1d6Fariborz Jahanian /// 4714fd83ea566f4a0c083001c84b75da6cc8c99c1d6Fariborz Jahanian QualType::GCAttrTypes getObjCGCAttrKind(const QualType &Ty) const; 472fa23c1d9adc99c662c1c0e192817185809d95614Fariborz Jahanian 473fa23c1d9adc99c662c1c0e192817185809d95614Fariborz Jahanian /// isObjCNSObjectType - Return true if this is an NSObject object with 474fa23c1d9adc99c662c1c0e192817185809d95614Fariborz Jahanian /// its NSObject attribute set. 475fa23c1d9adc99c662c1c0e192817185809d95614Fariborz Jahanian bool isObjCNSObjectType(QualType Ty) const; 476b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek 477b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek //===--------------------------------------------------------------------===// 478464175bba1318bef7905122e9fda20cff926df78Chris Lattner // Type Sizing and Analysis 479464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 480464175bba1318bef7905122e9fda20cff926df78Chris Lattner 481b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner /// getFloatTypeSemantics - Return the APFloat 'semantics' for the specified 482b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner /// scalar floating point type. 483b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner const llvm::fltSemantics &getFloatTypeSemantics(QualType T) const; 484b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner 485464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// getTypeInfo - Get the size and alignment of the specified complete type in 486464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// bits. 4871d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar std::pair<uint64_t, unsigned> getTypeInfo(const Type *T); 4881d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar std::pair<uint64_t, unsigned> getTypeInfo(QualType T) { 4891d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar return getTypeInfo(T.getTypePtr()); 4901d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar } 491464175bba1318bef7905122e9fda20cff926df78Chris Lattner 492464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// getTypeSize - Return the size of the specified type, in bits. This method 493464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// does not work on incomplete types. 49498be4943e8dc4f3905629a7102668960873cf863Chris Lattner uint64_t getTypeSize(QualType T) { 49598be4943e8dc4f3905629a7102668960873cf863Chris Lattner return getTypeInfo(T).first; 496464175bba1318bef7905122e9fda20cff926df78Chris Lattner } 4971d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar uint64_t getTypeSize(const Type *T) { 4981d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar return getTypeInfo(T).first; 4991d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar } 500464175bba1318bef7905122e9fda20cff926df78Chris Lattner 50134ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// getTypeAlign - Return the ABI-specified alignment of a type, in bits. 50234ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// This method does not work on incomplete types. 50398be4943e8dc4f3905629a7102668960873cf863Chris Lattner unsigned getTypeAlign(QualType T) { 50498be4943e8dc4f3905629a7102668960873cf863Chris Lattner return getTypeInfo(T).second; 505464175bba1318bef7905122e9fda20cff926df78Chris Lattner } 5061d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar unsigned getTypeAlign(const Type *T) { 5071d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar return getTypeInfo(T).second; 5081d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar } 509464175bba1318bef7905122e9fda20cff926df78Chris Lattner 51034ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// getPreferredTypeAlign - Return the "preferred" alignment of the specified 51134ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// type for the current target in bits. This can be different than the ABI 51234ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// alignment in cases where it is beneficial for performance to overalign 51334ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// a data type. 51434ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner unsigned getPreferredTypeAlign(const Type *T); 51534ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner 516b7d0844c887a72064b624dc6df12cbe1441f69d0Daniel Dunbar /// getDeclAlignInBytes - Return the alignment of the specified decl 517b7d0844c887a72064b624dc6df12cbe1441f69d0Daniel Dunbar /// that should be returned by __alignof(). Note that bitfields do 518b7d0844c887a72064b624dc6df12cbe1441f69d0Daniel Dunbar /// not have a valid alignment, so this method will assert on them. 519b7d0844c887a72064b624dc6df12cbe1441f69d0Daniel Dunbar unsigned getDeclAlignInBytes(const Decl *D); 520af707ab8fbb9451e8febb8d766f6c043628125c4Chris Lattner 52188a981b47c7face1b1fdaa9074256245107b9ca9Devang Patel /// getASTRecordLayout - Get or compute information about the layout of the 522464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// specified record (struct/union/class), which indicates its size and field 523464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// position information. 52498be4943e8dc4f3905629a7102668960873cf863Chris Lattner const ASTRecordLayout &getASTRecordLayout(const RecordDecl *D); 525464175bba1318bef7905122e9fda20cff926df78Chris Lattner 526b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar /// getASTObjCInterfaceLayout - Get or compute information about the 527b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar /// layout of the specified Objective-C interface. 52844a3dded8080c5c9cfdad208ade8f8f7850d9a4fDevang Patel const ASTRecordLayout &getASTObjCInterfaceLayout(const ObjCInterfaceDecl *D); 529b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar 530b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar /// getASTObjCImplementationLayout - Get or compute information about 531b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar /// the layout of the specified Objective-C implementation. This may 532b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar /// differ from the interface if synthesized ivars are present. 533b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar const ASTRecordLayout & 534b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar getASTObjCImplementationLayout(const ObjCImplementationDecl *D); 535b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar 53688e469cf4240d4b898eacc0ad092019b022e0e50Fariborz Jahanian void CollectObjCIvars(const ObjCInterfaceDecl *OI, 5376ab3524f72a6e64aa04973fa9433b5559abb3525Douglas Gregor llvm::SmallVectorImpl<FieldDecl*> &Fields); 5389820074dd47d37681085e964cd3392ac0b3e67b9Fariborz Jahanian 5399820074dd47d37681085e964cd3392ac0b3e67b9Fariborz Jahanian void CollectSynthesizedIvars(const ObjCInterfaceDecl *OI, 5409820074dd47d37681085e964cd3392ac0b3e67b9Fariborz Jahanian llvm::SmallVectorImpl<ObjCIvarDecl*> &Ivars); 5419820074dd47d37681085e964cd3392ac0b3e67b9Fariborz Jahanian void CollectProtocolSynthesizedIvars(const ObjCProtocolDecl *PD, 5429820074dd47d37681085e964cd3392ac0b3e67b9Fariborz Jahanian llvm::SmallVectorImpl<ObjCIvarDecl*> &Ivars); 543525c9b7baeeff022127cd1b167579f3bda73b3edDaniel Dunbar 544464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 545464175bba1318bef7905122e9fda20cff926df78Chris Lattner // Type Operators 546464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 547464175bba1318bef7905122e9fda20cff926df78Chris Lattner 54877c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// getCanonicalType - Return the canonical (structural) type corresponding to 54977c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// the specified potentially non-canonical type. The non-canonical version 55077c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// of a type may have many "decorated" versions of types. Decorators can 55177c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// include typedefs, 'typeof' operators, etc. The returned type is guaranteed 55277c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// to be free of any of these, allowing two canonical types to be compared 55377c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// for exact equality with a simple pointer comparison. 55477c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner QualType getCanonicalType(QualType T); 5551d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar const Type *getCanonicalType(const Type *T) { 5561d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar return T->getCanonicalTypeInternal().getTypePtr(); 5571d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar } 5582a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor 5598e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor /// \brief Determine whether the given types are equivalent. 5608e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor bool hasSameType(QualType T1, QualType T2) { 5618e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor return getCanonicalType(T1) == getCanonicalType(T2); 5628e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor } 5638e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor 5648e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor /// \brief Determine whether the given types are equivalent after 5658e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor /// cvr-qualifiers have been removed. 5668e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor bool hasSameUnqualifiedType(QualType T1, QualType T2) { 5678e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor T1 = getCanonicalType(T1); 5688e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor T2 = getCanonicalType(T2); 5698e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor return T1.getUnqualifiedType() == T2.getUnqualifiedType(); 5708e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor } 5718e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor 5727da97d0f31e1ec16998d3de2cfd2e88fe3736673Douglas Gregor /// \brief Retrieves the "canonical" declaration of the given declaration. 5737da97d0f31e1ec16998d3de2cfd2e88fe3736673Douglas Gregor Decl *getCanonicalDecl(Decl *D); 5747da97d0f31e1ec16998d3de2cfd2e88fe3736673Douglas Gregor 5752a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor /// \brief Retrieves the "canonical" declaration of the given tag 5762a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor /// declaration. 5772a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor /// 5782a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor /// The canonical declaration for the given tag declaration is 5792a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor /// either the definition of the tag (if it is a complete type) or 5802a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor /// the first declaration of that tag. 5812a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor TagDecl *getCanonicalDecl(TagDecl *Tag) { 5827da97d0f31e1ec16998d3de2cfd2e88fe3736673Douglas Gregor return cast<TagDecl>(getCanonicalDecl((Decl *)Tag)); 5832a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor } 5842a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor 5857da97d0f31e1ec16998d3de2cfd2e88fe3736673Douglas Gregor /// \brief Retrieves the "canonical" declaration of 5867da97d0f31e1ec16998d3de2cfd2e88fe3736673Douglas Gregor 587d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// \brief Retrieves the "canonical" nested name specifier for a 588d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// given nested name specifier. 589d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// 590d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// The canonical nested name specifier is a nested name specifier 591d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// that uniquely identifies a type or namespace within the type 592d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// system. For example, given: 593d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// 594d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// \code 595d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// namespace N { 596d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// struct S { 597d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// template<typename T> struct X { typename T* type; }; 598d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// }; 599d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// } 600d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// 601d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// template<typename T> struct Y { 602d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// typename N::S::X<T>::type member; 603d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// }; 604d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// \endcode 605d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// 606d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// Here, the nested-name-specifier for N::S::X<T>:: will be 607d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// S::X<template-param-0-0>, since 'S' and 'X' are uniquely defined 608d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// by declarations in the type system and the canonical type for 609d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// the template type parameter 'T' is template-param-0-0. 610d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor NestedNameSpecifier * 611d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor getCanonicalNestedNameSpecifier(NestedNameSpecifier *NNS); 612d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor 61325a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// \brief Retrieves the "canonical" template name that refers to a 61425a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// given template. 61525a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// 61625a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// The canonical template name is the simplest expression that can 61725a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// be used to refer to a given template. For most templates, this 61825a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// expression is just the template declaration itself. For example, 61925a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// the template std::vector can be referred to via a variety of 62025a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// names---std::vector, ::std::vector, vector (if vector is in 62125a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// scope), etc.---but all of these names map down to the same 62225a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// TemplateDecl, which is used to form the canonical template name. 62325a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// 62425a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// Dependent template names are more interesting. Here, the 62525a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// template name could be something like T::template apply or 62625a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// std::allocator<T>::template rebind, where the nested name 62725a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// specifier itself is dependent. In this case, the canonical 62825a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// template name uses the shortest form of the dependent 62925a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// nested-name-specifier, which itself contains all canonical 63025a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// types, values, and templates. 63125a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor TemplateName getCanonicalTemplateName(TemplateName Name); 63225a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor 633c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner /// Type Query functions. If the type is an instance of the specified class, 634c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner /// return the Type pointer for the underlying maximally pretty type. This 635c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner /// is a member of ASTContext because this may need to do some amount of 636c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner /// canonicalization, e.g. to move type qualifiers into the element type. 637c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner const ArrayType *getAsArrayType(QualType T); 638c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner const ConstantArrayType *getAsConstantArrayType(QualType T) { 639c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner return dyn_cast_or_null<ConstantArrayType>(getAsArrayType(T)); 640c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner } 641c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner const VariableArrayType *getAsVariableArrayType(QualType T) { 642c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner return dyn_cast_or_null<VariableArrayType>(getAsArrayType(T)); 643c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner } 644c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner const IncompleteArrayType *getAsIncompleteArrayType(QualType T) { 645c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner return dyn_cast_or_null<IncompleteArrayType>(getAsArrayType(T)); 646c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner } 6476183a99b064b397d98297904fbd6cf00fe1f453dAnders Carlsson 6486183a99b064b397d98297904fbd6cf00fe1f453dAnders Carlsson /// getBaseElementType - Returns the innermost element type of a variable 6496183a99b064b397d98297904fbd6cf00fe1f453dAnders Carlsson /// length array type. For example, will return "int" for int[m][n] 6506183a99b064b397d98297904fbd6cf00fe1f453dAnders Carlsson QualType getBaseElementType(const VariableArrayType *VAT); 651c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner 652e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// getArrayDecayedType - Return the properly qualified result of decaying the 653e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// specified array type to a pointer. This operation is non-trivial when 654e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// handling typedefs etc. The canonical type of "T" must be an array type, 655e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// this returns a pointer to a properly qualified element of the array. 656e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// 657e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// See C99 6.7.5.3p7 and C99 6.3.2.1p3. 658e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner QualType getArrayDecayedType(QualType T); 659e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner 6607cfeb08f2466d6263ec6ff1402298f93f6d6991fChris Lattner /// getIntegerTypeOrder - Returns the highest ranked integer type: 6617cfeb08f2466d6263ec6ff1402298f93f6d6991fChris Lattner /// C99 6.3.1.8p1. If LHS > RHS, return 1. If LHS == RHS, return 0. If 6627cfeb08f2466d6263ec6ff1402298f93f6d6991fChris Lattner /// LHS < RHS, return -1. 6637cfeb08f2466d6263ec6ff1402298f93f6d6991fChris Lattner int getIntegerTypeOrder(QualType LHS, QualType RHS); 664a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner 665a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner /// getFloatingTypeOrder - Compare the rank of the two specified floating 666a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner /// point types, ignoring the domain of the type (i.e. 'double' == 667a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner /// '_Complex double'). If LHS > RHS, return 1. If LHS == RHS, return 0. If 668a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner /// LHS < RHS, return -1. 669a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner int getFloatingTypeOrder(QualType LHS, QualType RHS); 6705f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 671716c7304ff5d27a95e1e7823acd1d09d5ec3e37fSteve Naroff /// getFloatingTypeOfSizeWithinDomain - Returns a real floating 672716c7304ff5d27a95e1e7823acd1d09d5ec3e37fSteve Naroff /// point or a complex type (based on typeDomain/typeSize). 673716c7304ff5d27a95e1e7823acd1d09d5ec3e37fSteve Naroff /// 'typeDomain' is a real floating point or complex type. 674716c7304ff5d27a95e1e7823acd1d09d5ec3e37fSteve Naroff /// 'typeSize' is a real floating point or complex type. 675f1448a0e4a1e868ff873a8530a61a09cb68666ccSteve Naroff QualType getFloatingTypeOfSizeWithinDomain(QualType typeSize, 676f1448a0e4a1e868ff873a8530a61a09cb68666ccSteve Naroff QualType typeDomain) const; 677ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff 678f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedmanprivate: 679f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman // Helper for integer ordering 680f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman unsigned getIntegerRank(Type* T); 681f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman 682f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedmanpublic: 683f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman 684ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff //===--------------------------------------------------------------------===// 685ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff // Type Compatibility Predicates 686ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff //===--------------------------------------------------------------------===// 687ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff 688ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff /// Compatibility predicates used to check assignment expressions. 689ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff bool typesAreCompatible(QualType, QualType); // C99 6.2.7p1 6901c7d067550c2d9bca8997d0e67ee6b280d493202Steve Naroff bool typesAreBlockCompatible(QualType lhs, QualType rhs); 691ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff 692a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek bool isObjCIdType(QualType T) const { 693389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff return T == ObjCIdType; 694389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff } 695389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff bool isObjCIdStructType(QualType T) const { 69645ecd5daa36385b7e0b2f657357805e01f5d8cbfSteve Naroff if (!IdStructType) // ObjC isn't enabled 69745ecd5daa36385b7e0b2f657357805e01f5d8cbfSteve Naroff return false; 698ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff return T->getAsStructureType() == IdStructType; 699ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff } 700a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek bool isObjCClassType(QualType T) const { 701389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff return T == ObjCClassType; 702389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff } 703389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff bool isObjCClassStructType(QualType T) const { 70445ecd5daa36385b7e0b2f657357805e01f5d8cbfSteve Naroff if (!ClassStructType) // ObjC isn't enabled 70545ecd5daa36385b7e0b2f657357805e01f5d8cbfSteve Naroff return false; 7068baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson return T->getAsStructureType() == ClassStructType; 7078baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson } 708a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek bool isObjCSelType(QualType T) const { 709a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek assert(SelStructType && "isObjCSelType used before 'SEL' type is built"); 7108baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson return T->getAsStructureType() == SelStructType; 7118baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson } 7128baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson 7133d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman // Check the safety of assignment from LHS to RHS 7143d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman bool canAssignObjCInterfaces(const ObjCInterfaceType *LHS, 7153d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman const ObjCInterfaceType *RHS); 716389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff bool areComparableObjCPointerTypes(QualType LHS, QualType RHS); 7173d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman 7183d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman // Functions for calculating composite types 7193d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman QualType mergeTypes(QualType, QualType); 7203d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman QualType mergeFunctionTypes(QualType, QualType); 7213d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman 722368eefa081d12f0a265ee90ee8ec61b54168d57dChris Lattner //===--------------------------------------------------------------------===// 723ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // Integer Predicates 724ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman //===--------------------------------------------------------------------===// 725ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman 726ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // The width of an integer, as defined in C99 6.2.6.2. This is the number 727ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // of bits in an integer type excluding any padding bits. 728ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman unsigned getIntWidth(QualType T); 729ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman 730ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // Per C99 6.2.5p6, for every signed integer type, there is a corresponding 731ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // unsigned integer type. This method takes a signed type, and returns the 732ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // corresponding unsigned integer type. 733ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman QualType getCorrespondingUnsignedType(QualType T); 734ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman 735ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman //===--------------------------------------------------------------------===// 736e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek // Type Iterators. 737e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek //===--------------------------------------------------------------------===// 738e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek 739e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek typedef std::vector<Type*>::iterator type_iterator; 740e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek typedef std::vector<Type*>::const_iterator const_type_iterator; 741e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek 742e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek type_iterator types_begin() { return Types.begin(); } 743e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek type_iterator types_end() { return Types.end(); } 744e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek const_type_iterator types_begin() const { return Types.begin(); } 745e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek const_type_iterator types_end() const { return Types.end(); } 746e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek 747e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek //===--------------------------------------------------------------------===// 7480cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar // Integer Values 7490cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar //===--------------------------------------------------------------------===// 7500cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar 7510cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar /// MakeIntValue - Make an APSInt of the appropriate width and 7520cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar /// signedness for the given \arg Value and integer \arg Type. 7530cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar llvm::APSInt MakeIntValue(uint64_t Value, QualType Type) { 7540cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar llvm::APSInt Res(getIntWidth(Type), !Type->isSignedIntegerType()); 7550cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar Res = Value; 7560cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar return Res; 7570cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar } 7580cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar 7595f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencerprivate: 7605f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer ASTContext(const ASTContext&); // DO NOT IMPLEMENT 7615f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer void operator=(const ASTContext&); // DO NOT IMPLEMENT 7625f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 7635f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer void InitBuiltinTypes(); 7645f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer void InitBuiltinType(QualType &R, BuiltinType::Kind K); 7654b7c98378ae0c1a3635f0b7756848b4a9923f8bcTed Kremenek 76682a6cfbc421cc99c5b7313271f399f7ef95056ecDaniel Dunbar // Return the ObjC type encoding for a given type. 76782a6cfbc421cc99c5b7313271f399f7ef95056ecDaniel Dunbar void getObjCEncodingForTypeImpl(QualType t, std::string &S, 76882a6cfbc421cc99c5b7313271f399f7ef95056ecDaniel Dunbar bool ExpandPointedToStructures, 76982a6cfbc421cc99c5b7313271f399f7ef95056ecDaniel Dunbar bool ExpandStructures, 770153bfe5795e2c1a5a738e73d3784964e082237fcDaniel Dunbar const FieldDecl *Field, 771090b3f71702c5626d8520f9608d77c6f26dcfa15Fariborz Jahanian bool OutermostType = false, 7726ab3524f72a6e64aa04973fa9433b5559abb3525Douglas Gregor bool EncodingProperty = false); 773b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar 774b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar const ASTRecordLayout &getObjCLayout(const ObjCInterfaceDecl *D, 775b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar const ObjCImplementationDecl *Impl); 7765f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer}; 777e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl 7785f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer} // end namespace clang 7795f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 780e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl// operator new and delete aren't allowed inside namespaces. 781e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl// The throw specifications are mandated by the standard. 782e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @brief Placement new for using the ASTContext's allocator. 783e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// 784e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// This placement form of operator new uses the ASTContext's allocator for 785e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// obtaining memory. It is a non-throwing new, which means that it returns 786e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// null on error. (If that is what the allocator does. The current does, so if 787e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// this ever changes, this operator will have to be changed, too.) 788e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// Usage looks like this (assuming there's an ASTContext 'Context' in scope): 789e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @code 790e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// // Default alignment (16) 791e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// IntegerLiteral *Ex = new (Context) IntegerLiteral(arguments); 792e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// // Specific alignment 793e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// IntegerLiteral *Ex2 = new (Context, 8) IntegerLiteral(arguments); 794e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @endcode 795e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// Please note that you cannot use delete on the pointer; it must be 796e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// deallocated using an explicit destructor call followed by 7974398a78095cd05a3be702fbab25bfe324a5d7946Ted Kremenek/// @c Context.Deallocate(Ptr). 798e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// 799e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @param Bytes The number of bytes to allocate. Calculated by the compiler. 800e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @param C The ASTContext that provides the allocator. 80142542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @param Alignment The alignment of the allocated memory (if the underlying 80242542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// allocator supports it). 803e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @return The allocated memory. Could be NULL. 804e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redlinline void *operator new(size_t Bytes, clang::ASTContext &C, 8059f9bf258f8ebae30bfb70feb9d797d6eb67b0460Douglas Gregor size_t Alignment) throw () { 806c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff return C.Allocate(Bytes, Alignment); 807e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl} 808e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @brief Placement delete companion to the new above. 809e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// 810e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// This operator is just a companion to the new above. There is no way of 811e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// invoking it directly; see the new operator for more details. This operator 812e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// is called implicitly by the compiler if a placement new expression using 813e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// the ASTContext throws in the object constructor. 814fb523e16dd1f860ff02a3ae03e5e3e25327a5860Chris Lattnerinline void operator delete(void *Ptr, clang::ASTContext &C, size_t) 815e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl throw () { 816c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff C.Deallocate(Ptr); 817e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl} 818e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl 81942542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// This placement form of operator new[] uses the ASTContext's allocator for 82042542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// obtaining memory. It is a non-throwing new[], which means that it returns 82142542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// null on error. 82242542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// Usage looks like this (assuming there's an ASTContext 'Context' in scope): 82342542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @code 82442542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// // Default alignment (16) 82542542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// char *data = new (Context) char[10]; 82642542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// // Specific alignment 82742542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// char *data = new (Context, 8) char[10]; 82842542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @endcode 82942542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// Please note that you cannot use delete on the pointer; it must be 83042542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// deallocated using an explicit destructor call followed by 8314398a78095cd05a3be702fbab25bfe324a5d7946Ted Kremenek/// @c Context.Deallocate(Ptr). 83242542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// 83342542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @param Bytes The number of bytes to allocate. Calculated by the compiler. 83442542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @param C The ASTContext that provides the allocator. 83542542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @param Alignment The alignment of the allocated memory (if the underlying 83642542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// allocator supports it). 83742542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @return The allocated memory. Could be NULL. 83842542c6a4b3c60f63820e6177a8938443831492cTed Kremenekinline void *operator new[](size_t Bytes, clang::ASTContext& C, 83942542c6a4b3c60f63820e6177a8938443831492cTed Kremenek size_t Alignment = 16) throw () { 84042542c6a4b3c60f63820e6177a8938443831492cTed Kremenek return C.Allocate(Bytes, Alignment); 84142542c6a4b3c60f63820e6177a8938443831492cTed Kremenek} 84242542c6a4b3c60f63820e6177a8938443831492cTed Kremenek 84342542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @brief Placement delete[] companion to the new[] above. 84442542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// 84542542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// This operator is just a companion to the new[] above. There is no way of 84642542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// invoking it directly; see the new[] operator for more details. This operator 84742542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// is called implicitly by the compiler if a placement new[] expression using 84842542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// the ASTContext throws in the object constructor. 84942542c6a4b3c60f63820e6177a8938443831492cTed Kremenekinline void operator delete[](void *Ptr, clang::ASTContext &C) throw () { 85042542c6a4b3c60f63820e6177a8938443831492cTed Kremenek C.Deallocate(Ptr); 85142542c6a4b3c60f63820e6177a8938443831492cTed Kremenek} 85242542c6a4b3c60f63820e6177a8938443831492cTed Kremenek 8535f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer#endif 854