ASTContext.h revision 0d8df780aef1acda5962347a32591efc629b6748
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" 2550d62d1b4a98adbc83de8f8cd1379ea1c25656f7Douglas Gregor#include "clang/AST/CanonicalType.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; 470d8df780aef1acda5962347a32591efc629b6748Anders Carlsson class FieldDecl; 480d8df780aef1acda5962347a32591efc629b6748Anders Carlsson class ObjCIvarDecl; 490d8df780aef1acda5962347a32591efc629b6748Anders Carlsson class ObjCIvarRefExpr; 50c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar class ObjCPropertyDecl; 51e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class RecordDecl; 52e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class TagDecl; 530d8df780aef1acda5962347a32591efc629b6748Anders Carlsson class TemplateTypeParmDecl; 54e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class TranslationUnitDecl; 55e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class TypeDecl; 56e91593ef084479340582b2ba177b44be50a717b7Daniel Dunbar class TypedefDecl; 570d8df780aef1acda5962347a32591efc629b6748Anders Carlsson class UnresolvedUsingDecl; 580d8df780aef1acda5962347a32591efc629b6748Anders Carlsson class UsingDecl; 59efc4c4bdbd8fee90b93deb3b5cfaeb044ae22557Fariborz Jahanian 601b63e4f732dbc73d90abf886b4d21f8e3a165f6dChris Lattner namespace Builtin { class Context; } 611b63e4f732dbc73d90abf886b4d21f8e3a165f6dChris Lattner 625f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer/// ASTContext - This class holds long-lived AST nodes (such as types and 635f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer/// decls) that can be referred to throughout the semantic analysis of a file. 642bd24ba6d10f8c811c8e2a57c8397e07082ba497Ted Kremenekclass ASTContext { 655f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer std::vector<Type*> Types; 66f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian llvm::FoldingSet<ExtQualType> ExtQualTypes; 675f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer llvm::FoldingSet<ComplexType> ComplexTypes; 685f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer llvm::FoldingSet<PointerType> PointerTypes; 695618bd4a52c45fbbb605e3ba885663b2164db8a3Steve Naroff llvm::FoldingSet<BlockPointerType> BlockPointerTypes; 707c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl llvm::FoldingSet<LValueReferenceType> LValueReferenceTypes; 717c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl llvm::FoldingSet<RValueReferenceType> RValueReferenceTypes; 72f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl llvm::FoldingSet<MemberPointerType> MemberPointerTypes; 737192f8e9592729882a09d84d77838db26e39ebd4Ted Kremenek llvm::FoldingSet<ConstantArrayType> ConstantArrayTypes; 74c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman llvm::FoldingSet<IncompleteArrayType> IncompleteArrayTypes; 75c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman std::vector<VariableArrayType*> VariableArrayTypes; 7604d4beee4b86af20a9e4457023d3925cab8f9908Douglas Gregor llvm::FoldingSet<DependentSizedArrayType> DependentSizedArrayTypes; 772ec09f1dc123e1942ed756e8ee4fef86451eac9eDouglas Gregor llvm::FoldingSet<DependentSizedExtVectorType> DependentSizedExtVectorTypes; 785f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer llvm::FoldingSet<VectorType> VectorTypes; 7972564e73277e29f6db3305d1f27ba408abb7ed88Douglas Gregor llvm::FoldingSet<FunctionNoProtoType> FunctionNoProtoTypes; 8072564e73277e29f6db3305d1f27ba408abb7ed88Douglas Gregor llvm::FoldingSet<FunctionProtoType> FunctionProtoTypes; 81b197572cf1cd70a817a1f546478cb2cb9112c48eDouglas Gregor llvm::FoldingSet<DependentTypeOfExprType> DependentTypeOfExprTypes; 829d702ae1cd5cfa19d884cbef77e1df99395138bbDouglas Gregor llvm::FoldingSet<DependentDecltypeType> DependentDecltypeTypes; 83fab9d67cebb87be968e7ae31a3b549a5279b5d51Douglas Gregor llvm::FoldingSet<TemplateTypeParmType> TemplateTypeParmTypes; 847532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor llvm::FoldingSet<TemplateSpecializationType> TemplateSpecializationTypes; 85e4e5b054b4917f0ee493bb2fda5b1ec749bfb9a1Douglas Gregor llvm::FoldingSet<QualifiedNameType> QualifiedNameTypes; 86d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor llvm::FoldingSet<TypenameType> TypenameTypes; 87c15cb2af27514ecc879daba9aa01389c5203685dSteve Naroff llvm::FoldingSet<ObjCInterfaceType> ObjCInterfaceTypes; 88d1b3c2dd5bc1f3103bee6137957aa7c5f8f2f0bcSteve Naroff llvm::FoldingSet<ObjCObjectPointerType> ObjCObjectPointerTypes; 899d702ae1cd5cfa19d884cbef77e1df99395138bbDouglas Gregor 907532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor llvm::FoldingSet<QualifiedTemplateName> QualifiedTemplateNames; 917532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor llvm::FoldingSet<DependentTemplateName> DependentTemplateNames; 927532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor 93ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor /// \brief The set of nested name specifiers. 94ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor /// 95ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor /// This set is managed by the NestedNameSpecifier class. 96ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor llvm::FoldingSet<NestedNameSpecifier> NestedNameSpecifiers; 97ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor NestedNameSpecifier *GlobalNestedNameSpecifier; 98ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor friend class NestedNameSpecifier; 99ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor 10088a981b47c7face1b1fdaa9074256245107b9ca9Devang Patel /// ASTRecordLayouts - A cache mapping from RecordDecls to ASTRecordLayouts. 101a9a4a24592a2164114a8a36717650e6341eb67a4Ted Kremenek /// This is lazily created. This is intentionally not serialized. 10288a981b47c7face1b1fdaa9074256245107b9ca9Devang Patel llvm::DenseMap<const RecordDecl*, const ASTRecordLayout*> ASTRecordLayouts; 103b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar llvm::DenseMap<const ObjCContainerDecl*, const ASTRecordLayout*> ObjCLayouts; 104f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman 1058a1d722f13df383600f36d77f842957c8adb5f1bArgyrios Kyrtzidis /// \brief Mapping from ObjCContainers to their ObjCImplementations. 1068a1d722f13df383600f36d77f842957c8adb5f1bArgyrios Kyrtzidis llvm::DenseMap<ObjCContainerDecl*, ObjCImplDecl*> ObjCImpls; 1078a1d722f13df383600f36d77f842957c8adb5f1bArgyrios Kyrtzidis 108f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman llvm::DenseMap<unsigned, FixedWidthIntType*> SignedFixedWidthIntTypes; 109f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman llvm::DenseMap<unsigned, FixedWidthIntType*> UnsignedFixedWidthIntTypes; 110a769c004a2874504c17ea8afccbc4ad35fc33c9fFariborz Jahanian 111b2cf3573d7351094f6247fcca94703ce88eb9ee0Anders Carlsson /// BuiltinVaListType - built-in va list type. 112b2cf3573d7351094f6247fcca94703ce88eb9ee0Anders Carlsson /// This is initially null and set by Sema::LazilyCreateBuiltin when 113b2cf3573d7351094f6247fcca94703ce88eb9ee0Anders Carlsson /// a builtin that takes a valist is encountered. 114b2cf3573d7351094f6247fcca94703ce88eb9ee0Anders Carlsson QualType BuiltinVaListType; 115d1b3c2dd5bc1f3103bee6137957aa7c5f8f2f0bcSteve Naroff 1166083ea3723ec3996ae3bdf8d1b352b0c3b3922c8Ted Kremenek /// ObjCIdType - a pseudo built-in typedef type (set by Sema). 117de2e22d33afec98324a66a358dfe0951b3c7259aSteve Naroff QualType ObjCIdTypedefType; 1182198891824c38d45b2279de5d5e3ef9394eb457cSteve Naroff 1196083ea3723ec3996ae3bdf8d1b352b0c3b3922c8Ted Kremenek /// ObjCSelType - another pseudo built-in typedef type (set by Sema). 120a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType ObjCSelType; 121b62f6813406a03bf8a371c4e46c9fad51d102121Fariborz Jahanian const RecordType *SelStructType; 122b62f6813406a03bf8a371c4e46c9fad51d102121Fariborz Jahanian 1236083ea3723ec3996ae3bdf8d1b352b0c3b3922c8Ted Kremenek /// ObjCProtoType - another pseudo built-in typedef type (set by Sema). 124a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType ObjCProtoType; 125390d50a725497e99247dc104a7d2c2a255d3af14Fariborz Jahanian const RecordType *ProtoStructType; 1268baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson 1276083ea3723ec3996ae3bdf8d1b352b0c3b3922c8Ted Kremenek /// ObjCClassType - another pseudo built-in typedef type (set by Sema). 128de2e22d33afec98324a66a358dfe0951b3c7259aSteve Naroff QualType ObjCClassTypedefType; 129390d50a725497e99247dc104a7d2c2a255d3af14Fariborz Jahanian 130a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType ObjCConstantStringType; 1312198891824c38d45b2279de5d5e3ef9394eb457cSteve Naroff RecordDecl *CFConstantStringTypeDecl; 1327a9d49fd2bfac00e905b361ba76d26ab5b6c3b09Ted Kremenek 133bd4c1ada2e8668f43a865dc2c662085cf61940c4Anders Carlsson RecordDecl *ObjCFastEnumerationStateTypeDecl; 134bd4c1ada2e8668f43a865dc2c662085cf61940c4Anders Carlsson 135c29f77b769bcc5b6dc85e72c8e3cc2e348e5cf25Douglas Gregor /// \brief The type for the C FILE type. 136c29f77b769bcc5b6dc85e72c8e3cc2e348e5cf25Douglas Gregor TypeDecl *FILEDecl; 137c29f77b769bcc5b6dc85e72c8e3cc2e348e5cf25Douglas Gregor 1388fad9941a635a42ee644e7396ca84cbaaa5c1b6eMike Stump /// \brief The type for the C jmp_buf type. 139782fa308a765aeac2acb39c4e697c937ec21185bMike Stump TypeDecl *jmp_bufDecl; 140782fa308a765aeac2acb39c4e697c937ec21185bMike Stump 1418fad9941a635a42ee644e7396ca84cbaaa5c1b6eMike Stump /// \brief The type for the C sigjmp_buf type. 142782fa308a765aeac2acb39c4e697c937ec21185bMike Stump TypeDecl *sigjmp_bufDecl; 143782fa308a765aeac2acb39c4e697c937ec21185bMike Stump 14468584ed35ad819a1668e3f527ba7f5dd4ae6a333Douglas Gregor /// \brief Keeps track of all declaration attributes. 14568584ed35ad819a1668e3f527ba7f5dd4ae6a333Douglas Gregor /// 14668584ed35ad819a1668e3f527ba7f5dd4ae6a333Douglas Gregor /// Since so few decls have attrs, we keep them in a hash map instead of 14768584ed35ad819a1668e3f527ba7f5dd4ae6a333Douglas Gregor /// wasting space in the Decl class. 14868584ed35ad819a1668e3f527ba7f5dd4ae6a333Douglas Gregor llvm::DenseMap<const Decl*, Attr*> DeclAttrs; 1492455636163fdd18581d7fdae816433f886d88213Mike Stump 1507caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// \brief Keeps track of the static data member templates from which 1517caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// static data members of class template specializations were instantiated. 1527caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// 1537caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// This data structure stores the mapping from instantiations of static 1547caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// data members to the static data member representations within the 1557caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// class template from which they were instantiated. 1567caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// 1577caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// Given the following example: 1587caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// 1597caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// \code 1607caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// template<typename T> 1617caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// struct X { 1627caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// static T value; 1637caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// }; 1647caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// 1657caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// template<typename T> 1667caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// T X<T>::value = T(17); 1677caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// 1687caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// int *x = &X<int>::value; 1697caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// \endcode 1707caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// 1717caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// This mapping will contain an entry that maps from the VarDecl for 1727caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// X<int>::value to the corresponding VarDecl for X<T>::value (within the 1737caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// class template X). 1747caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor llvm::DenseMap<VarDecl *, VarDecl *> InstantiatedFromStaticDataMember; 1757caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor 1760d8df780aef1acda5962347a32591efc629b6748Anders Carlsson /// \brief Keeps track of the UnresolvedUsingDecls from which UsingDecls 1770d8df780aef1acda5962347a32591efc629b6748Anders Carlsson /// where created during instantiation. 1780d8df780aef1acda5962347a32591efc629b6748Anders Carlsson /// 1790d8df780aef1acda5962347a32591efc629b6748Anders Carlsson /// For example: 1800d8df780aef1acda5962347a32591efc629b6748Anders Carlsson /// \code 1810d8df780aef1acda5962347a32591efc629b6748Anders Carlsson /// template<typename T> 1820d8df780aef1acda5962347a32591efc629b6748Anders Carlsson /// struct A { 1830d8df780aef1acda5962347a32591efc629b6748Anders Carlsson /// void f(); 1840d8df780aef1acda5962347a32591efc629b6748Anders Carlsson /// }; 1850d8df780aef1acda5962347a32591efc629b6748Anders Carlsson /// 1860d8df780aef1acda5962347a32591efc629b6748Anders Carlsson /// template<typename T> 1870d8df780aef1acda5962347a32591efc629b6748Anders Carlsson /// struct B : A<T> { 1880d8df780aef1acda5962347a32591efc629b6748Anders Carlsson /// using A<T>::f; 1890d8df780aef1acda5962347a32591efc629b6748Anders Carlsson /// }; 1900d8df780aef1acda5962347a32591efc629b6748Anders Carlsson /// 1910d8df780aef1acda5962347a32591efc629b6748Anders Carlsson /// template struct B<int>; 1920d8df780aef1acda5962347a32591efc629b6748Anders Carlsson /// \endcode 1930d8df780aef1acda5962347a32591efc629b6748Anders Carlsson /// 1940d8df780aef1acda5962347a32591efc629b6748Anders Carlsson /// This mapping will contain an entry that maps from the UsingDecl in 1950d8df780aef1acda5962347a32591efc629b6748Anders Carlsson /// B<int> to the UnresolvedUsingDecl in B<T>. 1960d8df780aef1acda5962347a32591efc629b6748Anders Carlsson llvm::DenseMap<UsingDecl *, UnresolvedUsingDecl *> 1970d8df780aef1acda5962347a32591efc629b6748Anders Carlsson InstantiatedFromUnresolvedUsingDecl; 1980d8df780aef1acda5962347a32591efc629b6748Anders Carlsson 199ef177820100ab583b08fd3056e2a5a52ee4b1629Argyrios Kyrtzidis TranslationUnitDecl *TUDecl; 200ef177820100ab583b08fd3056e2a5a52ee4b1629Argyrios Kyrtzidis 201e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek /// SourceMgr - The associated SourceManager object. 202b800dc2d5e27ec60f567567b623cdc61152b8fb8Chris Lattner SourceManager &SourceMgr; 203e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek 204e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek /// LangOpts - The language options used to create the AST associated with 205e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek /// this ASTContext object. 206e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek LangOptions LangOpts; 207e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek 2082e22253e03e175144aeb9d13350a12fd83f858beDouglas Gregor /// \brief Whether we have already loaded comment source ranges from an 2092e22253e03e175144aeb9d13350a12fd83f858beDouglas Gregor /// external source. 2102e22253e03e175144aeb9d13350a12fd83f858beDouglas Gregor bool LoadedExternalComments; 2112e22253e03e175144aeb9d13350a12fd83f858beDouglas Gregor 212c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff /// MallocAlloc/BumpAlloc - The allocator objects used to create AST objects. 213c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff bool FreeMemory; 214c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff llvm::MallocAllocator MallocAlloc; 215c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff llvm::BumpPtrAllocator BumpAlloc; 2162e22253e03e175144aeb9d13350a12fd83f858beDouglas Gregor 2172e22253e03e175144aeb9d13350a12fd83f858beDouglas Gregor /// \brief Mapping from declarations to their comments, once we have 2182e22253e03e175144aeb9d13350a12fd83f858beDouglas Gregor /// already looked up the comment associated with a given declaration. 2192e22253e03e175144aeb9d13350a12fd83f858beDouglas Gregor llvm::DenseMap<const Decl *, std::string> DeclComments; 2202e22253e03e175144aeb9d13350a12fd83f858beDouglas Gregor 2216ab3524f72a6e64aa04973fa9433b5559abb3525Douglas Gregorpublic: 2225f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer TargetInfo &Target; 22371993dd85eed9cc42c6b2fa61ee5c53026b74817Anders Carlsson IdentifierTable &Idents; 22429238a0bf7cbf5b396efb451a0adb5fe4aa037caSteve Naroff SelectorTable &Selectors; 2251b63e4f732dbc73d90abf886b4d21f8e3a165f6dChris Lattner Builtin::Context &BuiltinInfo; 2262e1cd4264d363ca869bf37ef160902f211d21b8cDouglas Gregor DeclarationNameTable DeclarationNames; 2272cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor llvm::OwningPtr<ExternalASTSource> ExternalSource; 228d249e1d1f1498b81314459ceda19d6ff25c278adDouglas Gregor clang::PrintingPolicy PrintingPolicy; 2292e1cd4264d363ca869bf37ef160902f211d21b8cDouglas Gregor 2300f436560640a1cff5b6d96f80f540770f139453fDavid Chisnall // Typedefs which may be provided defining the structure of Objective-C 2310f436560640a1cff5b6d96f80f540770f139453fDavid Chisnall // pseudo-builtins 2320f436560640a1cff5b6d96f80f540770f139453fDavid Chisnall QualType ObjCIdRedefinitionType; 2330f436560640a1cff5b6d96f80f540770f139453fDavid Chisnall QualType ObjCClassRedefinitionType; 2340f436560640a1cff5b6d96f80f540770f139453fDavid Chisnall 2352e22253e03e175144aeb9d13350a12fd83f858beDouglas Gregor /// \brief Source ranges for all of the comments in the source file, 2362e22253e03e175144aeb9d13350a12fd83f858beDouglas Gregor /// sorted in order of appearance in the translation unit. 2372e22253e03e175144aeb9d13350a12fd83f858beDouglas Gregor std::vector<SourceRange> Comments; 2382e22253e03e175144aeb9d13350a12fd83f858beDouglas Gregor 2397a9d49fd2bfac00e905b361ba76d26ab5b6c3b09Ted Kremenek SourceManager& getSourceManager() { return SourceMgr; } 240a9376d470ccb0eac74fe09a6b2a18a890f1d17c4Chris Lattner const SourceManager& getSourceManager() const { return SourceMgr; } 241c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff void *Allocate(unsigned Size, unsigned Align = 8) { 242c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff return FreeMemory ? MallocAlloc.Allocate(Size, Align) : 243c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff BumpAlloc.Allocate(Size, Align); 244c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff } 245c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff void Deallocate(void *Ptr) { 246c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff if (FreeMemory) 247c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff MallocAlloc.Deallocate(Ptr); 248c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff } 249e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek const LangOptions& getLangOptions() const { return LangOpts; } 2506c2b6eb8d836da19007f7540709e16d5e39a1cbaChris Lattner 2519c728dc4d8da89c73fcae74c9e72d7a83ffd7b6dTed Kremenek FullSourceLoc getFullLoc(SourceLocation Loc) const { 2529c728dc4d8da89c73fcae74c9e72d7a83ffd7b6dTed Kremenek return FullSourceLoc(Loc,SourceMgr); 2539c728dc4d8da89c73fcae74c9e72d7a83ffd7b6dTed Kremenek } 254ef177820100ab583b08fd3056e2a5a52ee4b1629Argyrios Kyrtzidis 25568584ed35ad819a1668e3f527ba7f5dd4ae6a333Douglas Gregor /// \brief Retrieve the attributes for the given declaration. 25668584ed35ad819a1668e3f527ba7f5dd4ae6a333Douglas Gregor Attr*& getDeclAttrs(const Decl *D) { return DeclAttrs[D]; } 25768584ed35ad819a1668e3f527ba7f5dd4ae6a333Douglas Gregor 25868584ed35ad819a1668e3f527ba7f5dd4ae6a333Douglas Gregor /// \brief Erase the attributes corresponding to the given declaration. 25968584ed35ad819a1668e3f527ba7f5dd4ae6a333Douglas Gregor void eraseDeclAttrs(const Decl *D) { DeclAttrs.erase(D); } 2602455636163fdd18581d7fdae816433f886d88213Mike Stump 2617caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// \brief If this variable is an instantiated static data member of a 2627caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// class template specialization, returns the templated static data member 2637caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// from which it was instantiated. 2647caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor VarDecl *getInstantiatedFromStaticDataMember(VarDecl *Var); 2657caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor 2667caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// \brief Note that the static data member \p Inst is an instantiation of 2677caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor /// the static data member template \p Tmpl of a class template. 2687caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor void setInstantiatedFromStaticDataMember(VarDecl *Inst, VarDecl *Tmpl); 2697caa6825f42a0f7e97d6fc06233133c42b218e46Douglas Gregor 2700d8df780aef1acda5962347a32591efc629b6748Anders Carlsson UnresolvedUsingDecl *getInstantiatedFromUnresolvedUsingDecl(UsingDecl *UUD); 2710d8df780aef1acda5962347a32591efc629b6748Anders Carlsson void setInstantiatedFromUnresolvedUsingDecl(UsingDecl *UD, 2720d8df780aef1acda5962347a32591efc629b6748Anders Carlsson UnresolvedUsingDecl *UUD); 2730d8df780aef1acda5962347a32591efc629b6748Anders Carlsson 274ef177820100ab583b08fd3056e2a5a52ee4b1629Argyrios Kyrtzidis TranslationUnitDecl *getTranslationUnitDecl() const { return TUDecl; } 275ef177820100ab583b08fd3056e2a5a52ee4b1629Argyrios Kyrtzidis 2762e22253e03e175144aeb9d13350a12fd83f858beDouglas Gregor const char *getCommentForDecl(const Decl *D); 2772e22253e03e175144aeb9d13350a12fd83f858beDouglas Gregor 2785f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer // Builtin Types. 2795f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType VoidTy; 2805f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType BoolTy; 2815f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType CharTy; 282f5c209d23b20ada4a9b6235db50317239cbf6ae1Alisdair Meredith QualType WCharTy; // [C++ 3.9.1p5], integer type in C99. 283f5c209d23b20ada4a9b6235db50317239cbf6ae1Alisdair Meredith QualType Char16Ty; // [C++0x 3.9.1p5], integer type in C99. 284f5c209d23b20ada4a9b6235db50317239cbf6ae1Alisdair Meredith QualType Char32Ty; // [C++0x 3.9.1p5], integer type in C99. 2852df9ced9fd1e8c7d7b38443db07e0e811de22571Chris Lattner QualType SignedCharTy, ShortTy, IntTy, LongTy, LongLongTy, Int128Ty; 2865f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType UnsignedCharTy, UnsignedShortTy, UnsignedIntTy, UnsignedLongTy; 2872df9ced9fd1e8c7d7b38443db07e0e811de22571Chris Lattner QualType UnsignedLongLongTy, UnsignedInt128Ty; 2885f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType FloatTy, DoubleTy, LongDoubleTy; 2895f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType FloatComplexTy, DoubleComplexTy, LongDoubleComplexTy; 2906e8ed16ffef02b82995a90bdcf10ffff7d63839aSebastian Redl QualType VoidPtrTy, NullPtrTy; 2918e9bebdea69c590dedfbf27374114cb76fe12fbdDouglas Gregor QualType OverloadTy; 292898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor QualType DependentTy; 293e89d15944dd3be750a09805ad21222d2fa9321faAnders Carlsson QualType UndeducedAutoTy; 294de2e22d33afec98324a66a358dfe0951b3c7259aSteve Naroff QualType ObjCBuiltinIdTy, ObjCBuiltinClassTy; 2958e9bebdea69c590dedfbf27374114cb76fe12fbdDouglas Gregor 296e7d07d113677a39026ff5119b8b67f6fe8ca9793Ted Kremenek ASTContext(const LangOptions& LOpts, SourceManager &SM, TargetInfo &t, 2971b63e4f732dbc73d90abf886b4d21f8e3a165f6dChris Lattner IdentifierTable &idents, SelectorTable &sels, 2981b63e4f732dbc73d90abf886b4d21f8e3a165f6dChris Lattner Builtin::Context &builtins, 2991b63e4f732dbc73d90abf886b4d21f8e3a165f6dChris Lattner bool FreeMemory = true, unsigned size_reserve=0); 300fee0452973f28691a61aab0fb074468ce3e34b9bTed Kremenek 3015f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer ~ASTContext(); 3026ab3524f72a6e64aa04973fa9433b5559abb3525Douglas Gregor 3032cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// \brief Attach an external AST source to the AST context. 3042cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// 3052cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// The external AST source provides the ability to load parts of 3062cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// the abstract syntax tree as needed from some external storage, 3072cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// e.g., a precompiled header. 3082cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor void setExternalSource(llvm::OwningPtr<ExternalASTSource> &Source); 3092cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor 3102cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// \brief Retrieve a pointer to the external AST source associated 3112cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor /// with this AST context, if any. 3122cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor ExternalASTSource *getExternalSource() const { return ExternalSource.get(); } 3132cf2634ffdb4f7c8d46cef3f8e60a55993f1c57aDouglas Gregor 3145f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer void PrintStats() const; 31503ed44061df258e74a40383bda849e14b892a8c6Ted Kremenek const std::vector<Type*>& getTypes() const { return Types; } 316d249e1d1f1498b81314459ceda19d6ff25c278adDouglas Gregor 317464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 318464175bba1318bef7905122e9fda20cff926df78Chris Lattner // Type Constructors 319464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 320d2d2a11a91d7ddf468bfb70f66362d24806ed601Chris Lattner 321f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian /// getAddSpaceQualType - Return the uniqued reference to the type for an 322f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian /// address space qualified type with the specified type and address space. 323f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian /// The resulting type has a union of the qualifiers from T and the address 324f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian /// space. If T already has an address space specifier, it is silently 325f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian /// replaced. 326f11284ac87daa613bc7b30db9f54bd716d123222Fariborz Jahanian QualType getAddrSpaceQualType(QualType T, unsigned AddressSpace); 327ebb97e98c03f8d7034bd3748a10e35f39a95c289Christopher Lamb 328d33d9c0cc0cfdcd0b10f35a6acdfb25da4a64f19Fariborz Jahanian /// getObjCGCQualType - Returns the uniqued reference to the type for an 329d33d9c0cc0cfdcd0b10f35a6acdfb25da4a64f19Fariborz Jahanian /// objc gc qualified type. The retulting type has a union of the qualifiers 330d33d9c0cc0cfdcd0b10f35a6acdfb25da4a64f19Fariborz Jahanian /// from T and the gc attribute. 331d33d9c0cc0cfdcd0b10f35a6acdfb25da4a64f19Fariborz Jahanian QualType getObjCGCQualType(QualType T, QualType::GCAttrTypes gcAttr); 332d33d9c0cc0cfdcd0b10f35a6acdfb25da4a64f19Fariborz Jahanian 3332455636163fdd18581d7fdae816433f886d88213Mike Stump /// getNoReturnType - Add the noreturn attribute to the given type which must 3342455636163fdd18581d7fdae816433f886d88213Mike Stump /// be a FunctionType or a pointer to an allowable type or a BlockPointer. 3352455636163fdd18581d7fdae816433f886d88213Mike Stump QualType getNoReturnType(QualType T); 3362455636163fdd18581d7fdae816433f886d88213Mike Stump 3375f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getComplexType - Return the uniqued reference to the type for a complex 3385f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// number with the specified element type. 3395f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getComplexType(QualType T); 3405f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 3415f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getPointerType - Return the uniqued reference to the type for a pointer to 3425f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// the specified type. 3435f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getPointerType(QualType T); 3445618bd4a52c45fbbb605e3ba885663b2164db8a3Steve Naroff 3455618bd4a52c45fbbb605e3ba885663b2164db8a3Steve Naroff /// getBlockPointerType - Return the uniqued reference to the type for a block 3465618bd4a52c45fbbb605e3ba885663b2164db8a3Steve Naroff /// of the specified type. 3475618bd4a52c45fbbb605e3ba885663b2164db8a3Steve Naroff QualType getBlockPointerType(QualType T); 348f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl 3497c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl /// getLValueReferenceType - Return the uniqued reference to the type for an 3507c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl /// lvalue reference to the specified type. 3517c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl QualType getLValueReferenceType(QualType T); 3527c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl 3537c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl /// getRValueReferenceType - Return the uniqued reference to the type for an 3547c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl /// rvalue reference to the specified type. 3557c80bd64032e610c0dbd74fc0ef6ea334447f2fdSebastian Redl QualType getRValueReferenceType(QualType T); 356f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl 357f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl /// getMemberPointerType - Return the uniqued reference to the type for a 358f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl /// member pointer to the specified type in the specified class. The class 359f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl /// is a Type because it could be a dependent name. 360f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl QualType getMemberPointerType(QualType T, const Type *Cls); 361f30208ad5b334e93582e846a2a0c92f38a607b8aSebastian Redl 362bdbf7b030a3e0ddb95240076683830e6f78c79a5Steve Naroff /// getVariableArrayType - Returns a non-unique reference to the type for a 363bdbf7b030a3e0ddb95240076683830e6f78c79a5Steve Naroff /// variable array of the specified element type. 364c9406125e2cac9208098655ac8058c095c2c3a65Steve Naroff QualType getVariableArrayType(QualType EltTy, Expr *NumElts, 365c9406125e2cac9208098655ac8058c095c2c3a65Steve Naroff ArrayType::ArraySizeModifier ASM, 3667e7eb3da052a6d80ddf2377cab0384c798f73f75Douglas Gregor unsigned EltTypeQuals, 3677e7eb3da052a6d80ddf2377cab0384c798f73f75Douglas Gregor SourceRange Brackets); 368898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor 369898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor /// getDependentSizedArrayType - Returns a non-unique reference to 370898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor /// the type for a dependently-sized array of the specified element 371898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor /// type. FIXME: We will need these to be uniqued, or at least 372898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor /// comparable, at some point. 373898574e7496ba8fd76290079d3a9d06954992734Douglas Gregor QualType getDependentSizedArrayType(QualType EltTy, Expr *NumElts, 374fea8685bf3036b199c573e70b03affde2583fc44Nate Begeman ArrayType::ArraySizeModifier ASM, 3757e7eb3da052a6d80ddf2377cab0384c798f73f75Douglas Gregor unsigned EltTypeQuals, 3767e7eb3da052a6d80ddf2377cab0384c798f73f75Douglas Gregor SourceRange Brackets); 377fb22d96692c5240fb8d611290dbf7eeed3759c73Steve Naroff 378c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman /// getIncompleteArrayType - Returns a unique reference to the type for a 379c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman /// incomplete array of the specified element type. 380c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman QualType getIncompleteArrayType(QualType EltTy, 381c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman ArrayType::ArraySizeModifier ASM, 382c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman unsigned EltTypeQuals); 383c5773c4b8ce1ed6ed5c7112c9020c954a47dce96Eli Friedman 384bdbf7b030a3e0ddb95240076683830e6f78c79a5Steve Naroff /// getConstantArrayType - Return the unique reference to the type for a 385bdbf7b030a3e0ddb95240076683830e6f78c79a5Steve Naroff /// constant array of the specified element type. 386c9406125e2cac9208098655ac8058c095c2c3a65Steve Naroff QualType getConstantArrayType(QualType EltTy, const llvm::APInt &ArySize, 387c9406125e2cac9208098655ac8058c095c2c3a65Steve Naroff ArrayType::ArraySizeModifier ASM, 388c9406125e2cac9208098655ac8058c095c2c3a65Steve Naroff unsigned EltTypeQuals); 3897e7eb3da052a6d80ddf2377cab0384c798f73f75Douglas Gregor 3907e7eb3da052a6d80ddf2377cab0384c798f73f75Douglas Gregor /// getConstantArrayWithExprType - Return a reference to the type for a 3917e7eb3da052a6d80ddf2377cab0384c798f73f75Douglas Gregor /// constant array of the specified element type. 3927e7eb3da052a6d80ddf2377cab0384c798f73f75Douglas Gregor QualType getConstantArrayWithExprType(QualType EltTy, 3937e7eb3da052a6d80ddf2377cab0384c798f73f75Douglas Gregor const llvm::APInt &ArySize, 3947e7eb3da052a6d80ddf2377cab0384c798f73f75Douglas Gregor Expr *ArySizeExpr, 3957e7eb3da052a6d80ddf2377cab0384c798f73f75Douglas Gregor ArrayType::ArraySizeModifier ASM, 3967e7eb3da052a6d80ddf2377cab0384c798f73f75Douglas Gregor unsigned EltTypeQuals, 3977e7eb3da052a6d80ddf2377cab0384c798f73f75Douglas Gregor SourceRange Brackets); 3987e7eb3da052a6d80ddf2377cab0384c798f73f75Douglas Gregor 3997e7eb3da052a6d80ddf2377cab0384c798f73f75Douglas Gregor /// getConstantArrayWithoutExprType - Return a reference to the type 4007e7eb3da052a6d80ddf2377cab0384c798f73f75Douglas Gregor /// for a constant array of the specified element type. 4017e7eb3da052a6d80ddf2377cab0384c798f73f75Douglas Gregor QualType getConstantArrayWithoutExprType(QualType EltTy, 4027e7eb3da052a6d80ddf2377cab0384c798f73f75Douglas Gregor const llvm::APInt &ArySize, 4037e7eb3da052a6d80ddf2377cab0384c798f73f75Douglas Gregor ArrayType::ArraySizeModifier ASM, 4047e7eb3da052a6d80ddf2377cab0384c798f73f75Douglas Gregor unsigned EltTypeQuals); 4057e7eb3da052a6d80ddf2377cab0384c798f73f75Douglas Gregor 40673322924127c873c13101b705dd823f5539ffa5fSteve Naroff /// getVectorType - Return the unique reference to a vector type of 40773322924127c873c13101b705dd823f5539ffa5fSteve Naroff /// the specified element type and size. VectorType must be a built-in type. 40873322924127c873c13101b705dd823f5539ffa5fSteve Naroff QualType getVectorType(QualType VectorType, unsigned NumElts); 40973322924127c873c13101b705dd823f5539ffa5fSteve Naroff 410213541a68a3e137d11d2cefb612c6cdb410d7e8eNate Begeman /// getExtVectorType - Return the unique reference to an extended vector type 411213541a68a3e137d11d2cefb612c6cdb410d7e8eNate Begeman /// of the specified element type and size. VectorType must be a built-in 412213541a68a3e137d11d2cefb612c6cdb410d7e8eNate Begeman /// type. 413213541a68a3e137d11d2cefb612c6cdb410d7e8eNate Begeman QualType getExtVectorType(QualType VectorType, unsigned NumElts); 4145f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 4159cdda0cf8528e3d595be9bfa002f0450074beb4dDouglas Gregor /// getDependentSizedExtVectorType - Returns a non-unique reference to 4169cdda0cf8528e3d595be9bfa002f0450074beb4dDouglas Gregor /// the type for a dependently-sized vector of the specified element 4179cdda0cf8528e3d595be9bfa002f0450074beb4dDouglas Gregor /// type. FIXME: We will need these to be uniqued, or at least 4189cdda0cf8528e3d595be9bfa002f0450074beb4dDouglas Gregor /// comparable, at some point. 4199cdda0cf8528e3d595be9bfa002f0450074beb4dDouglas Gregor QualType getDependentSizedExtVectorType(QualType VectorType, 4209cdda0cf8528e3d595be9bfa002f0450074beb4dDouglas Gregor Expr *SizeExpr, 4219cdda0cf8528e3d595be9bfa002f0450074beb4dDouglas Gregor SourceLocation AttrLoc); 4229cdda0cf8528e3d595be9bfa002f0450074beb4dDouglas Gregor 42372564e73277e29f6db3305d1f27ba408abb7ed88Douglas Gregor /// getFunctionNoProtoType - Return a K&R style C function type like 'int()'. 4245f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// 4252455636163fdd18581d7fdae816433f886d88213Mike Stump QualType getFunctionNoProtoType(QualType ResultTy, bool NoReturn = false); 426465226e23a3008bd68973513dda1f9e3cd27dbddSebastian Redl 4275f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getFunctionType - Return a normal function type with a typed argument 4285f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// list. isVariadic indicates whether the argument list includes '...'. 42986da77fdaf4c0237eafb9670f54eee20b08635bfEli Friedman QualType getFunctionType(QualType ResultTy, const QualType *ArgArray, 430971c4fae6092976338b755af1d47dac07c8f16e3Argyrios Kyrtzidis unsigned NumArgs, bool isVariadic, 431465226e23a3008bd68973513dda1f9e3cd27dbddSebastian Redl unsigned TypeQuals, bool hasExceptionSpec = false, 432465226e23a3008bd68973513dda1f9e3cd27dbddSebastian Redl bool hasAnyExceptionSpec = false, 4332455636163fdd18581d7fdae816433f886d88213Mike Stump unsigned NumExs = 0, const QualType *ExArray = 0, 4342455636163fdd18581d7fdae816433f886d88213Mike Stump bool NoReturn = false); 4352ce52f3fb95bf544db6bd3d91a72bce7d9cceb6cDouglas Gregor 4362ce52f3fb95bf544db6bd3d91a72bce7d9cceb6cDouglas Gregor /// getTypeDeclType - Return the unique reference to the type for 4372ce52f3fb95bf544db6bd3d91a72bce7d9cceb6cDouglas Gregor /// the specified type declaration. 4384b7c98378ae0c1a3635f0b7756848b4a9923f8bcTed Kremenek QualType getTypeDeclType(TypeDecl *Decl, TypeDecl* PrevDecl=0); 4392ce52f3fb95bf544db6bd3d91a72bce7d9cceb6cDouglas Gregor 4405f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getTypedefType - Return the unique reference to the type for the 4415f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// specified typename decl. 4425f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getTypedefType(TypedefDecl *Decl); 443fab9d67cebb87be968e7ae31a3b549a5279b5d51Douglas Gregor 444fab9d67cebb87be968e7ae31a3b549a5279b5d51Douglas Gregor QualType getTemplateTypeParmType(unsigned Depth, unsigned Index, 44576e4ce42a30cee4dc40ce7c6014874fbc4f9baa7Anders Carlsson bool ParameterPack, 446fab9d67cebb87be968e7ae31a3b549a5279b5d51Douglas Gregor IdentifierInfo *Name = 0); 447fab9d67cebb87be968e7ae31a3b549a5279b5d51Douglas Gregor 4487532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor QualType getTemplateSpecializationType(TemplateName T, 4497532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor const TemplateArgument *Args, 4507532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor unsigned NumArgs, 4517532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor QualType Canon = QualType()); 45255f6b14230c94272efbbcdd89a92224c8db9f225Douglas Gregor 453ab452ba8323d1985e08bade2bced588cddf2cc28Douglas Gregor QualType getQualifiedNameType(NestedNameSpecifier *NNS, 454e4e5b054b4917f0ee493bb2fda5b1ec749bfb9a1Douglas Gregor QualType NamedType); 455d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor QualType getTypenameType(NestedNameSpecifier *NNS, 456d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor const IdentifierInfo *Name, 457d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor QualType Canon = QualType()); 4581734317845d60307d474b5da8a8d33adbaf5e723Douglas Gregor QualType getTypenameType(NestedNameSpecifier *NNS, 4591734317845d60307d474b5da8a8d33adbaf5e723Douglas Gregor const TemplateSpecializationType *TemplateId, 4601734317845d60307d474b5da8a8d33adbaf5e723Douglas Gregor QualType Canon = QualType()); 461e4e5b054b4917f0ee493bb2fda5b1ec749bfb9a1Douglas Gregor 462c15cb2af27514ecc879daba9aa01389c5203685dSteve Naroff QualType getObjCInterfaceType(const ObjCInterfaceDecl *Decl, 463c15cb2af27514ecc879daba9aa01389c5203685dSteve Naroff ObjCProtocolDecl **Protocols = 0, 464c15cb2af27514ecc879daba9aa01389c5203685dSteve Naroff unsigned NumProtocols = 0); 465c15cb2af27514ecc879daba9aa01389c5203685dSteve Naroff 466d1b3c2dd5bc1f3103bee6137957aa7c5f8f2f0bcSteve Naroff /// getObjCObjectPointerType - Return a ObjCObjectPointerType type for the 467d1b3c2dd5bc1f3103bee6137957aa7c5f8f2f0bcSteve Naroff /// given interface decl and the conforming protocol list. 468c02397509bb4057f3a7d6f5f4d764d122ed2381fSteve Naroff QualType getObjCObjectPointerType(QualType OIT, 469d1b3c2dd5bc1f3103bee6137957aa7c5f8f2f0bcSteve Naroff ObjCProtocolDecl **ProtocolList = 0, 470d1b3c2dd5bc1f3103bee6137957aa7c5f8f2f0bcSteve Naroff unsigned NumProtocols = 0); 471d1b3c2dd5bc1f3103bee6137957aa7c5f8f2f0bcSteve Naroff 472d1861fd633d5096a00777c918eb8575ea7162fe7Steve Naroff /// getTypeOfType - GCC extension. 47372564e73277e29f6db3305d1f27ba408abb7ed88Douglas Gregor QualType getTypeOfExprType(Expr *e); 474d1861fd633d5096a00777c918eb8575ea7162fe7Steve Naroff QualType getTypeOfType(QualType t); 475d1861fd633d5096a00777c918eb8575ea7162fe7Steve Naroff 476395b475a4474f1c7574d927ad142ca0c7997cbcaAnders Carlsson /// getDecltypeType - C++0x decltype. 477395b475a4474f1c7574d927ad142ca0c7997cbcaAnders Carlsson QualType getDecltypeType(Expr *e); 478395b475a4474f1c7574d927ad142ca0c7997cbcaAnders Carlsson 4795f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getTagDeclType - Return the unique reference to the type for the 4805f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// specified TagDecl (struct/union/class/enum) decl. 481e607ed068334bacb8d7b093996b4671c6ca79e25Mike Stump QualType getTagDeclType(const TagDecl *Decl); 4825f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 4835f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getSizeType - Return the unique type for "size_t" (C99 7.17), defined 4845f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// in <stddef.h>. The sizeof operator requires this (C99 6.5.3.4p4). 4855f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getSizeType() const; 486fd888a581d6d329f5b447c8ff4d37cf396315993Eli Friedman 4873a2503227c3db04a3619735127483263c1075ef7Chris Lattner /// getWCharType - In C++, this returns the unique wchar_t type. In C99, this 4883a2503227c3db04a3619735127483263c1075ef7Chris Lattner /// returns a type compatible with the type defined in <stddef.h> as defined 4893a2503227c3db04a3619735127483263c1075ef7Chris Lattner /// by the target. 4903a2503227c3db04a3619735127483263c1075ef7Chris Lattner QualType getWCharType() const { return WCharTy; } 49164c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis 49264c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis /// getSignedWCharType - Return the type of "signed wchar_t". 49364c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis /// Used when in C++, as a GCC extension. 49464c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis QualType getSignedWCharType() const; 49564c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis 49664c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis /// getUnsignedWCharType - Return the type of "unsigned wchar_t". 49764c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis /// Used when in C++, as a GCC extension. 49864c438a4be2a871fa43c78264663ba1e9788b94dArgyrios Kyrtzidis QualType getUnsignedWCharType() const; 4995f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 5008b9023ba35a86838789e2c9034a6128728c547aaChris Lattner /// getPointerDiffType - Return the unique type for "ptrdiff_t" (ref?) 5018b9023ba35a86838789e2c9034a6128728c547aaChris Lattner /// defined in <stddef.h>. Pointer - pointer requires this (C99 6.5.6p9). 5028b9023ba35a86838789e2c9034a6128728c547aaChris Lattner QualType getPointerDiffType() const; 5038b9023ba35a86838789e2c9034a6128728c547aaChris Lattner 504beaf299a2701c5559a4e5d76b0c40f805afb8e6aSteve Naroff // getCFConstantStringType - Return the C structure type used to represent 505beaf299a2701c5559a4e5d76b0c40f805afb8e6aSteve Naroff // constant CFStrings. 50671993dd85eed9cc42c6b2fa61ee5c53026b74817Anders Carlsson QualType getCFConstantStringType(); 50771993dd85eed9cc42c6b2fa61ee5c53026b74817Anders Carlsson 508319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor /// Get the structure type used to representation CFStrings, or NULL 509319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor /// if it hasn't yet been built. 510319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor QualType getRawCFConstantStringType() { 511319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor if (CFConstantStringTypeDecl) 512319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor return getTagDeclType(CFConstantStringTypeDecl); 513319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor return QualType(); 514319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor } 515319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor void setCFConstantStringType(QualType T); 516319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor 517983df5b2280980e59b0b062bcc2882230465a61eSteve Naroff // This setter/getter represents the ObjC type for an NSConstantString. 518a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek void setObjCConstantStringInterface(ObjCInterfaceDecl *Decl); 519a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType getObjCConstantStringInterface() const { 520a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek return ObjCConstantStringType; 5212198891824c38d45b2279de5d5e3ef9394eb457cSteve Naroff } 522b62f6813406a03bf8a371c4e46c9fad51d102121Fariborz Jahanian 523bd4c1ada2e8668f43a865dc2c662085cf61940c4Anders Carlsson //// This gets the struct used to keep track of fast enumerations. 524bd4c1ada2e8668f43a865dc2c662085cf61940c4Anders Carlsson QualType getObjCFastEnumerationStateType(); 525bd4c1ada2e8668f43a865dc2c662085cf61940c4Anders Carlsson 526319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor /// Get the ObjCFastEnumerationState type, or NULL if it hasn't yet 527319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor /// been built. 528319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor QualType getRawObjCFastEnumerationStateType() { 529319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor if (ObjCFastEnumerationStateTypeDecl) 530319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor return getTagDeclType(ObjCFastEnumerationStateTypeDecl); 531319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor return QualType(); 532319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor } 533319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor 534319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor void setObjCFastEnumerationStateType(QualType T); 535319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor 536c29f77b769bcc5b6dc85e72c8e3cc2e348e5cf25Douglas Gregor /// \brief Set the type for the C FILE type. 537c29f77b769bcc5b6dc85e72c8e3cc2e348e5cf25Douglas Gregor void setFILEDecl(TypeDecl *FILEDecl) { this->FILEDecl = FILEDecl; } 538c29f77b769bcc5b6dc85e72c8e3cc2e348e5cf25Douglas Gregor 539c29f77b769bcc5b6dc85e72c8e3cc2e348e5cf25Douglas Gregor /// \brief Retrieve the C FILE type. 540c29f77b769bcc5b6dc85e72c8e3cc2e348e5cf25Douglas Gregor QualType getFILEType() { 541c29f77b769bcc5b6dc85e72c8e3cc2e348e5cf25Douglas Gregor if (FILEDecl) 542c29f77b769bcc5b6dc85e72c8e3cc2e348e5cf25Douglas Gregor return getTypeDeclType(FILEDecl); 543c29f77b769bcc5b6dc85e72c8e3cc2e348e5cf25Douglas Gregor return QualType(); 544c29f77b769bcc5b6dc85e72c8e3cc2e348e5cf25Douglas Gregor } 545782fa308a765aeac2acb39c4e697c937ec21185bMike Stump 546782fa308a765aeac2acb39c4e697c937ec21185bMike Stump /// \brief Set the type for the C jmp_buf type. 547fd612dbb23cd31c03c898ae53ff18d0dfd8488f9Mike Stump void setjmp_bufDecl(TypeDecl *jmp_bufDecl) { 548fd612dbb23cd31c03c898ae53ff18d0dfd8488f9Mike Stump this->jmp_bufDecl = jmp_bufDecl; 549fd612dbb23cd31c03c898ae53ff18d0dfd8488f9Mike Stump } 550782fa308a765aeac2acb39c4e697c937ec21185bMike Stump 551782fa308a765aeac2acb39c4e697c937ec21185bMike Stump /// \brief Retrieve the C jmp_buf type. 552782fa308a765aeac2acb39c4e697c937ec21185bMike Stump QualType getjmp_bufType() { 553782fa308a765aeac2acb39c4e697c937ec21185bMike Stump if (jmp_bufDecl) 554782fa308a765aeac2acb39c4e697c937ec21185bMike Stump return getTypeDeclType(jmp_bufDecl); 555782fa308a765aeac2acb39c4e697c937ec21185bMike Stump return QualType(); 556782fa308a765aeac2acb39c4e697c937ec21185bMike Stump } 557782fa308a765aeac2acb39c4e697c937ec21185bMike Stump 558782fa308a765aeac2acb39c4e697c937ec21185bMike Stump /// \brief Set the type for the C sigjmp_buf type. 559fd612dbb23cd31c03c898ae53ff18d0dfd8488f9Mike Stump void setsigjmp_bufDecl(TypeDecl *sigjmp_bufDecl) { 560fd612dbb23cd31c03c898ae53ff18d0dfd8488f9Mike Stump this->sigjmp_bufDecl = sigjmp_bufDecl; 561fd612dbb23cd31c03c898ae53ff18d0dfd8488f9Mike Stump } 562782fa308a765aeac2acb39c4e697c937ec21185bMike Stump 563782fa308a765aeac2acb39c4e697c937ec21185bMike Stump /// \brief Retrieve the C sigjmp_buf type. 564782fa308a765aeac2acb39c4e697c937ec21185bMike Stump QualType getsigjmp_bufType() { 565782fa308a765aeac2acb39c4e697c937ec21185bMike Stump if (sigjmp_bufDecl) 566782fa308a765aeac2acb39c4e697c937ec21185bMike Stump return getTypeDeclType(sigjmp_bufDecl); 567782fa308a765aeac2acb39c4e697c937ec21185bMike Stump return QualType(); 568782fa308a765aeac2acb39c4e697c937ec21185bMike Stump } 569c29f77b769bcc5b6dc85e72c8e3cc2e348e5cf25Douglas Gregor 570d96b35bc6becf8db00d140c11e3d0e53f27567a1Daniel Dunbar /// getObjCEncodingForType - Emit the ObjC type encoding for the 571d96b35bc6becf8db00d140c11e3d0e53f27567a1Daniel Dunbar /// given type into \arg S. If \arg NameFields is specified then 572d96b35bc6becf8db00d140c11e3d0e53f27567a1Daniel Dunbar /// record field names are also encoded. 5737d6b46d9a9d75dea8ef9f6973dd50633c1f37963Fariborz Jahanian void getObjCEncodingForType(QualType t, std::string &S, 574153bfe5795e2c1a5a738e73d3784964e082237fcDaniel Dunbar const FieldDecl *Field=0); 575a1c033e9514865f3a7b0d8b3b20e6de926cfec6cFariborz Jahanian 576a1c033e9514865f3a7b0d8b3b20e6de926cfec6cFariborz Jahanian void getLegacyIntegralTypeEncoding(QualType &t) const; 57733e1d64ab5cd5d27f8530ccd056191fe2c9f3f2eFariborz Jahanian 578ecb01e666665efabd2aa76a76f6080e2a78965faFariborz Jahanian // Put the string version of type qualifiers into S. 579a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek void getObjCEncodingForTypeQualifier(Decl::ObjCDeclQualifier QT, 580ecb01e666665efabd2aa76a76f6080e2a78965faFariborz Jahanian std::string &S) const; 581ecb01e666665efabd2aa76a76f6080e2a78965faFariborz Jahanian 582a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek /// getObjCEncodingForMethodDecl - Return the encoded type for this method 58333e1d64ab5cd5d27f8530ccd056191fe2c9f3f2eFariborz Jahanian /// declaration. 584c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar void getObjCEncodingForMethodDecl(const ObjCMethodDecl *Decl, std::string &S); 585c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar 586c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar /// getObjCEncodingForPropertyDecl - Return the encoded type for 587c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar /// this method declaration. If non-NULL, Container must be either 588c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar /// an ObjCCategoryImplDecl or ObjCImplementationDecl; it should 589c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar /// only be NULL when getting encodings for protocol properties. 59077a49f6b1e5741f6bda71eb7837b43343925027bArgyrios Kyrtzidis void getObjCEncodingForPropertyDecl(const ObjCPropertyDecl *PD, 591c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar const Decl *Container, 592c56f34a1c1779de15330bdb3eec39b3418802d47Daniel Dunbar std::string &S); 59333e1d64ab5cd5d27f8530ccd056191fe2c9f3f2eFariborz Jahanian 5940fd8904c5f71a11d29f67716c3ebdf7ad1c855fbFariborz Jahanian bool ProtocolCompatibleWithProtocol(ObjCProtocolDecl *lProto, 5950fd8904c5f71a11d29f67716c3ebdf7ad1c855fbFariborz Jahanian ObjCProtocolDecl *rProto); 5960fd8904c5f71a11d29f67716c3ebdf7ad1c855fbFariborz Jahanian 597a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek /// getObjCEncodingTypeSize returns size of type for objective-c encoding 59833e1d64ab5cd5d27f8530ccd056191fe2c9f3f2eFariborz Jahanian /// purpose. 599a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek int getObjCEncodingTypeSize(QualType t); 600d1b3c2dd5bc1f3103bee6137957aa7c5f8f2f0bcSteve Naroff 601d85376aa66bc16488539f6bb11f97d0170b1fe6bChris Lattner /// This setter/getter represents the ObjC 'id' type. It is setup lazily, by 602d85376aa66bc16488539f6bb11f97d0170b1fe6bChris Lattner /// Sema. id is always a (typedef for a) pointer type, a pointer to a struct. 603de2e22d33afec98324a66a358dfe0951b3c7259aSteve Naroff QualType getObjCIdType() const { return ObjCIdTypedefType; } 604319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor void setObjCIdType(QualType T); 605b62f6813406a03bf8a371c4e46c9fad51d102121Fariborz Jahanian 606319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor void setObjCSelType(QualType T); 607a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType getObjCSelType() const { return ObjCSelType; } 608b62f6813406a03bf8a371c4e46c9fad51d102121Fariborz Jahanian 609a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek void setObjCProtoType(QualType QT); 610a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek QualType getObjCProtoType() const { return ObjCProtoType; } 611390d50a725497e99247dc104a7d2c2a255d3af14Fariborz Jahanian 612d85376aa66bc16488539f6bb11f97d0170b1fe6bChris Lattner /// This setter/getter repreents the ObjC 'Class' type. It is setup lazily, by 613d85376aa66bc16488539f6bb11f97d0170b1fe6bChris Lattner /// Sema. 'Class' is always a (typedef for a) pointer type, a pointer to a 614d85376aa66bc16488539f6bb11f97d0170b1fe6bChris Lattner /// struct. 615de2e22d33afec98324a66a358dfe0951b3c7259aSteve Naroff QualType getObjCClassType() const { return ObjCClassTypedefType; } 616319ac896a0fef7365d5589b8021db7e41207fe42Douglas Gregor void setObjCClassType(QualType T); 6178baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson 618b2cf3573d7351094f6247fcca94703ce88eb9ee0Anders Carlsson void setBuiltinVaListType(QualType T); 619b2cf3573d7351094f6247fcca94703ce88eb9ee0Anders Carlsson QualType getBuiltinVaListType() const { return BuiltinVaListType; } 620f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman 621f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman QualType getFixedWidthIntType(unsigned Width, bool Signed); 622f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman 6237532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor TemplateName getQualifiedTemplateName(NestedNameSpecifier *NNS, 6247532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor bool TemplateKeyword, 6257532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor TemplateDecl *Template); 626d99cbe66403ee39c2ee58024b9582b95649a4fc5Douglas Gregor TemplateName getQualifiedTemplateName(NestedNameSpecifier *NNS, 627d99cbe66403ee39c2ee58024b9582b95649a4fc5Douglas Gregor bool TemplateKeyword, 628d99cbe66403ee39c2ee58024b9582b95649a4fc5Douglas Gregor OverloadedFunctionDecl *Template); 629d99cbe66403ee39c2ee58024b9582b95649a4fc5Douglas Gregor 6307532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor TemplateName getDependentTemplateName(NestedNameSpecifier *NNS, 6317532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor const IdentifierInfo *Name); 6327532dc66648cfe7432c9fe66dec5225f0ab301c6Douglas Gregor 63386df27bbdbb98c39ec2184695c0561209f91beddChris Lattner enum GetBuiltinTypeError { 634782fa308a765aeac2acb39c4e697c937ec21185bMike Stump GE_None, //< No error 635f711c41dd9412a8182793259d355c4f6979ed5edMike Stump GE_Missing_stdio, //< Missing a type from <stdio.h> 636f711c41dd9412a8182793259d355c4f6979ed5edMike Stump GE_Missing_setjmp //< Missing a type from <setjmp.h> 63786df27bbdbb98c39ec2184695c0561209f91beddChris Lattner }; 63886df27bbdbb98c39ec2184695c0561209f91beddChris Lattner 63986df27bbdbb98c39ec2184695c0561209f91beddChris Lattner /// GetBuiltinType - Return the type for the specified builtin. 64086df27bbdbb98c39ec2184695c0561209f91beddChris Lattner QualType GetBuiltinType(unsigned ID, GetBuiltinTypeError &Error); 64186df27bbdbb98c39ec2184695c0561209f91beddChris Lattner 642d934112e6170b0fd940d8e40db6936cea2cdcf62Douglas Gregorprivate: 643d934112e6170b0fd940d8e40db6936cea2cdcf62Douglas Gregor QualType getFromTargetType(unsigned Type) const; 644b4e66d5259f90e9aae4d40fc5de801e046c7df94Douglas Gregor 645464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 646b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek // Type Predicates. 647b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek //===--------------------------------------------------------------------===// 648d934112e6170b0fd940d8e40db6936cea2cdcf62Douglas Gregor 649d934112e6170b0fd940d8e40db6936cea2cdcf62Douglas Gregorpublic: 6504fd83ea566f4a0c083001c84b75da6cc8c99c1d6Fariborz Jahanian /// getObjCGCAttr - Returns one of GCNone, Weak or Strong objc's 6514fd83ea566f4a0c083001c84b75da6cc8c99c1d6Fariborz Jahanian /// garbage collection attribute. 6524fd83ea566f4a0c083001c84b75da6cc8c99c1d6Fariborz Jahanian /// 6534fd83ea566f4a0c083001c84b75da6cc8c99c1d6Fariborz Jahanian QualType::GCAttrTypes getObjCGCAttrKind(const QualType &Ty) const; 654fa23c1d9adc99c662c1c0e192817185809d95614Fariborz Jahanian 655fa23c1d9adc99c662c1c0e192817185809d95614Fariborz Jahanian /// isObjCNSObjectType - Return true if this is an NSObject object with 656fa23c1d9adc99c662c1c0e192817185809d95614Fariborz Jahanian /// its NSObject attribute set. 657fa23c1d9adc99c662c1c0e192817185809d95614Fariborz Jahanian bool isObjCNSObjectType(QualType Ty) const; 658b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek 659b6ccaac65ca72f72954eb3893bbd940bedd23f00Ted Kremenek //===--------------------------------------------------------------------===// 660464175bba1318bef7905122e9fda20cff926df78Chris Lattner // Type Sizing and Analysis 661464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 662464175bba1318bef7905122e9fda20cff926df78Chris Lattner 663b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner /// getFloatTypeSemantics - Return the APFloat 'semantics' for the specified 664b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner /// scalar floating point type. 665b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner const llvm::fltSemantics &getFloatTypeSemantics(QualType T) const; 666b7cfe88e88cb4f46308de89cf3f0c81bfe624128Chris Lattner 667464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// getTypeInfo - Get the size and alignment of the specified complete type in 668464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// bits. 6691d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar std::pair<uint64_t, unsigned> getTypeInfo(const Type *T); 6701d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar std::pair<uint64_t, unsigned> getTypeInfo(QualType T) { 6711d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar return getTypeInfo(T.getTypePtr()); 6721d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar } 673464175bba1318bef7905122e9fda20cff926df78Chris Lattner 674464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// getTypeSize - Return the size of the specified type, in bits. This method 675464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// does not work on incomplete types. 67698be4943e8dc4f3905629a7102668960873cf863Chris Lattner uint64_t getTypeSize(QualType T) { 67798be4943e8dc4f3905629a7102668960873cf863Chris Lattner return getTypeInfo(T).first; 678464175bba1318bef7905122e9fda20cff926df78Chris Lattner } 6791d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar uint64_t getTypeSize(const Type *T) { 6801d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar return getTypeInfo(T).first; 6811d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar } 682464175bba1318bef7905122e9fda20cff926df78Chris Lattner 68334ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// getTypeAlign - Return the ABI-specified alignment of a type, in bits. 68434ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// This method does not work on incomplete types. 68598be4943e8dc4f3905629a7102668960873cf863Chris Lattner unsigned getTypeAlign(QualType T) { 68698be4943e8dc4f3905629a7102668960873cf863Chris Lattner return getTypeInfo(T).second; 687464175bba1318bef7905122e9fda20cff926df78Chris Lattner } 6881d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar unsigned getTypeAlign(const Type *T) { 6891d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar return getTypeInfo(T).second; 6901d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar } 691464175bba1318bef7905122e9fda20cff926df78Chris Lattner 69234ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// getPreferredTypeAlign - Return the "preferred" alignment of the specified 69334ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// type for the current target in bits. This can be different than the ABI 69434ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// alignment in cases where it is beneficial for performance to overalign 69534ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner /// a data type. 69634ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner unsigned getPreferredTypeAlign(const Type *T); 69734ebde404dc17d89487b07e6daaf1b47d5dfee39Chris Lattner 698b7d0844c887a72064b624dc6df12cbe1441f69d0Daniel Dunbar /// getDeclAlignInBytes - Return the alignment of the specified decl 699b7d0844c887a72064b624dc6df12cbe1441f69d0Daniel Dunbar /// that should be returned by __alignof(). Note that bitfields do 700b7d0844c887a72064b624dc6df12cbe1441f69d0Daniel Dunbar /// not have a valid alignment, so this method will assert on them. 701b7d0844c887a72064b624dc6df12cbe1441f69d0Daniel Dunbar unsigned getDeclAlignInBytes(const Decl *D); 702af707ab8fbb9451e8febb8d766f6c043628125c4Chris Lattner 70388a981b47c7face1b1fdaa9074256245107b9ca9Devang Patel /// getASTRecordLayout - Get or compute information about the layout of the 704464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// specified record (struct/union/class), which indicates its size and field 705464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// position information. 70698be4943e8dc4f3905629a7102668960873cf863Chris Lattner const ASTRecordLayout &getASTRecordLayout(const RecordDecl *D); 707464175bba1318bef7905122e9fda20cff926df78Chris Lattner 708b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar /// getASTObjCInterfaceLayout - Get or compute information about the 709b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar /// layout of the specified Objective-C interface. 71044a3dded8080c5c9cfdad208ade8f8f7850d9a4fDevang Patel const ASTRecordLayout &getASTObjCInterfaceLayout(const ObjCInterfaceDecl *D); 711b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar 712b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar /// getASTObjCImplementationLayout - Get or compute information about 713b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar /// the layout of the specified Objective-C implementation. This may 714b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar /// differ from the interface if synthesized ivars are present. 715b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar const ASTRecordLayout & 716b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar getASTObjCImplementationLayout(const ObjCImplementationDecl *D); 717b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar 71888e469cf4240d4b898eacc0ad092019b022e0e50Fariborz Jahanian void CollectObjCIvars(const ObjCInterfaceDecl *OI, 7196ab3524f72a6e64aa04973fa9433b5559abb3525Douglas Gregor llvm::SmallVectorImpl<FieldDecl*> &Fields); 7208e6ac1d80055fa37b9b84029c7e751624ba7f84cFariborz Jahanian 7218e6ac1d80055fa37b9b84029c7e751624ba7f84cFariborz Jahanian void ShallowCollectObjCIvars(const ObjCInterfaceDecl *OI, 7228e6ac1d80055fa37b9b84029c7e751624ba7f84cFariborz Jahanian llvm::SmallVectorImpl<ObjCIvarDecl*> &Ivars, 7238e6ac1d80055fa37b9b84029c7e751624ba7f84cFariborz Jahanian bool CollectSynthesized = true); 7249820074dd47d37681085e964cd3392ac0b3e67b9Fariborz Jahanian void CollectSynthesizedIvars(const ObjCInterfaceDecl *OI, 7259820074dd47d37681085e964cd3392ac0b3e67b9Fariborz Jahanian llvm::SmallVectorImpl<ObjCIvarDecl*> &Ivars); 7269820074dd47d37681085e964cd3392ac0b3e67b9Fariborz Jahanian void CollectProtocolSynthesizedIvars(const ObjCProtocolDecl *PD, 7279820074dd47d37681085e964cd3392ac0b3e67b9Fariborz Jahanian llvm::SmallVectorImpl<ObjCIvarDecl*> &Ivars); 7288e6ac1d80055fa37b9b84029c7e751624ba7f84cFariborz Jahanian unsigned CountSynthesizedIvars(const ObjCInterfaceDecl *OI); 7298e6ac1d80055fa37b9b84029c7e751624ba7f84cFariborz Jahanian unsigned CountProtocolSynthesizedIvars(const ObjCProtocolDecl *PD); 730525c9b7baeeff022127cd1b167579f3bda73b3edDaniel Dunbar 731464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 732464175bba1318bef7905122e9fda20cff926df78Chris Lattner // Type Operators 733464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 734464175bba1318bef7905122e9fda20cff926df78Chris Lattner 73577c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// getCanonicalType - Return the canonical (structural) type corresponding to 73677c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// the specified potentially non-canonical type. The non-canonical version 73777c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// of a type may have many "decorated" versions of types. Decorators can 73877c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// include typedefs, 'typeof' operators, etc. The returned type is guaranteed 73977c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// to be free of any of these, allowing two canonical types to be compared 74077c9647cae939104c6cb2b6a4dd8ca859d2e5770Chris Lattner /// for exact equality with a simple pointer comparison. 74150d62d1b4a98adbc83de8f8cd1379ea1c25656f7Douglas Gregor CanQualType getCanonicalType(QualType T); 7421d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar const Type *getCanonicalType(const Type *T) { 7431d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar return T->getCanonicalTypeInternal().getTypePtr(); 7441d75118af76cae2bfc06389cde410e14bd0a19fcDaniel Dunbar } 7452a3009a432bdcec59e6383d7b2b17494d6f91649Douglas Gregor 7468e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor /// \brief Determine whether the given types are equivalent. 7478e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor bool hasSameType(QualType T1, QualType T2) { 7488e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor return getCanonicalType(T1) == getCanonicalType(T2); 7498e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor } 7508e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor 7518e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor /// \brief Determine whether the given types are equivalent after 7528e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor /// cvr-qualifiers have been removed. 7538e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor bool hasSameUnqualifiedType(QualType T1, QualType T2) { 7548e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor T1 = getCanonicalType(T1); 7558e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor T2 = getCanonicalType(T2); 7568e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor return T1.getUnqualifiedType() == T2.getUnqualifiedType(); 7578e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor } 7588e6563ba097732dc1fffcfc85f8dbbceac899a80Douglas Gregor 7597da97d0f31e1ec16998d3de2cfd2e88fe3736673Douglas Gregor /// \brief Retrieves the "canonical" declaration of 7607da97d0f31e1ec16998d3de2cfd2e88fe3736673Douglas Gregor 761d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// \brief Retrieves the "canonical" nested name specifier for a 762d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// given nested name specifier. 763d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// 764d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// The canonical nested name specifier is a nested name specifier 765d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// that uniquely identifies a type or namespace within the type 766d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// system. For example, given: 767d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// 768d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// \code 769d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// namespace N { 770d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// struct S { 771d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// template<typename T> struct X { typename T* type; }; 772d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// }; 773d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// } 774d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// 775d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// template<typename T> struct Y { 776d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// typename N::S::X<T>::type member; 777d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// }; 778d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// \endcode 779d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// 780d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// Here, the nested-name-specifier for N::S::X<T>:: will be 781d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// S::X<template-param-0-0>, since 'S' and 'X' are uniquely defined 782d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// by declarations in the type system and the canonical type for 783d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor /// the template type parameter 'T' is template-param-0-0. 784d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor NestedNameSpecifier * 785d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor getCanonicalNestedNameSpecifier(NestedNameSpecifier *NNS); 786d57959af02b4af695276f4204443afe6e5d86bd8Douglas Gregor 78725a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// \brief Retrieves the "canonical" template name that refers to a 78825a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// given template. 78925a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// 79025a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// The canonical template name is the simplest expression that can 79125a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// be used to refer to a given template. For most templates, this 79225a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// expression is just the template declaration itself. For example, 79325a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// the template std::vector can be referred to via a variety of 79425a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// names---std::vector, ::std::vector, vector (if vector is in 79525a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// scope), etc.---but all of these names map down to the same 79625a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// TemplateDecl, which is used to form the canonical template name. 79725a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// 79825a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// Dependent template names are more interesting. Here, the 79925a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// template name could be something like T::template apply or 80025a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// std::allocator<T>::template rebind, where the nested name 80125a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// specifier itself is dependent. In this case, the canonical 80225a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// template name uses the shortest form of the dependent 80325a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// nested-name-specifier, which itself contains all canonical 80425a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor /// types, values, and templates. 80525a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor TemplateName getCanonicalTemplateName(TemplateName Name); 80625a3ef7cc5fd55dc8cc67c6e6770c8595657e082Douglas Gregor 8071275ae098acda31fe0e434510c729fcfed0458a1Douglas Gregor /// \brief Retrieve the "canonical" template argument. 8081275ae098acda31fe0e434510c729fcfed0458a1Douglas Gregor /// 8091275ae098acda31fe0e434510c729fcfed0458a1Douglas Gregor /// The canonical template argument is the simplest template argument 8101275ae098acda31fe0e434510c729fcfed0458a1Douglas Gregor /// (which may be a type, value, expression, or declaration) that 8111275ae098acda31fe0e434510c729fcfed0458a1Douglas Gregor /// expresses the value of the argument. 8121275ae098acda31fe0e434510c729fcfed0458a1Douglas Gregor TemplateArgument getCanonicalTemplateArgument(const TemplateArgument &Arg); 8131275ae098acda31fe0e434510c729fcfed0458a1Douglas Gregor 814c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner /// Type Query functions. If the type is an instance of the specified class, 815c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner /// return the Type pointer for the underlying maximally pretty type. This 816c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner /// is a member of ASTContext because this may need to do some amount of 817c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner /// canonicalization, e.g. to move type qualifiers into the element type. 818c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner const ArrayType *getAsArrayType(QualType T); 819c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner const ConstantArrayType *getAsConstantArrayType(QualType T) { 820c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner return dyn_cast_or_null<ConstantArrayType>(getAsArrayType(T)); 821c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner } 822c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner const VariableArrayType *getAsVariableArrayType(QualType T) { 823c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner return dyn_cast_or_null<VariableArrayType>(getAsArrayType(T)); 824c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner } 825c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner const IncompleteArrayType *getAsIncompleteArrayType(QualType T) { 826c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner return dyn_cast_or_null<IncompleteArrayType>(getAsArrayType(T)); 827c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner } 8286183a99b064b397d98297904fbd6cf00fe1f453dAnders Carlsson 8296183a99b064b397d98297904fbd6cf00fe1f453dAnders Carlsson /// getBaseElementType - Returns the innermost element type of a variable 8306183a99b064b397d98297904fbd6cf00fe1f453dAnders Carlsson /// length array type. For example, will return "int" for int[m][n] 8316183a99b064b397d98297904fbd6cf00fe1f453dAnders Carlsson QualType getBaseElementType(const VariableArrayType *VAT); 8325e03f9ea8174ae588c5e69ec6b5ef4c68f8fd766Douglas Gregor 8335e03f9ea8174ae588c5e69ec6b5ef4c68f8fd766Douglas Gregor /// getBaseElementType - Returns the innermost element type of a type 8345e03f9ea8174ae588c5e69ec6b5ef4c68f8fd766Douglas Gregor /// (which needn't actually be an array type). 8355e03f9ea8174ae588c5e69ec6b5ef4c68f8fd766Douglas Gregor QualType getBaseElementType(QualType QT); 836c63a1f276f7b324fd9a4be82098b1c8f7bf30733Chris Lattner 8370de78998e7bda473b408437053e48661b510d453Fariborz Jahanian /// getConstantArrayElementCount - Returns number of constant array elements. 8380de78998e7bda473b408437053e48661b510d453Fariborz Jahanian uint64_t getConstantArrayElementCount(const ConstantArrayType *CA) const; 8390de78998e7bda473b408437053e48661b510d453Fariborz Jahanian 840e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// getArrayDecayedType - Return the properly qualified result of decaying the 841e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// specified array type to a pointer. This operation is non-trivial when 842e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// handling typedefs etc. The canonical type of "T" must be an array type, 843e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// this returns a pointer to a properly qualified element of the array. 844e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// 845e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner /// See C99 6.7.5.3p7 and C99 6.3.2.1p3. 846e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner QualType getArrayDecayedType(QualType T); 847e6327747b72bb687c948270f702ff53c30f411a6Chris Lattner 848a95d75769edae299816ec7fd9bbcdf1ef617c5c9Eli Friedman /// getPromotedIntegerType - Returns the type that Promotable will 849a95d75769edae299816ec7fd9bbcdf1ef617c5c9Eli Friedman /// promote to: C99 6.3.1.1p2, assuming that Promotable is a promotable 850a95d75769edae299816ec7fd9bbcdf1ef617c5c9Eli Friedman /// integer type. 851a95d75769edae299816ec7fd9bbcdf1ef617c5c9Eli Friedman QualType getPromotedIntegerType(QualType PromotableType); 852a95d75769edae299816ec7fd9bbcdf1ef617c5c9Eli Friedman 85304e8357f6801e9ff52673e7e899a67bbabf9de93Eli Friedman /// \brief Whether this is a promotable bitfield reference according 85404e8357f6801e9ff52673e7e899a67bbabf9de93Eli Friedman /// to C99 6.3.1.1p2, bullet 2 (and GCC extensions). 85504e8357f6801e9ff52673e7e899a67bbabf9de93Eli Friedman /// 85604e8357f6801e9ff52673e7e899a67bbabf9de93Eli Friedman /// \returns the type this bit-field will promote to, or NULL if no 85704e8357f6801e9ff52673e7e899a67bbabf9de93Eli Friedman /// promotion occurs. 85804e8357f6801e9ff52673e7e899a67bbabf9de93Eli Friedman QualType isPromotableBitField(Expr *E); 85904e8357f6801e9ff52673e7e899a67bbabf9de93Eli Friedman 8607cfeb08f2466d6263ec6ff1402298f93f6d6991fChris Lattner /// getIntegerTypeOrder - Returns the highest ranked integer type: 8617cfeb08f2466d6263ec6ff1402298f93f6d6991fChris Lattner /// C99 6.3.1.8p1. If LHS > RHS, return 1. If LHS == RHS, return 0. If 8627cfeb08f2466d6263ec6ff1402298f93f6d6991fChris Lattner /// LHS < RHS, return -1. 8637cfeb08f2466d6263ec6ff1402298f93f6d6991fChris Lattner int getIntegerTypeOrder(QualType LHS, QualType RHS); 864a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner 865a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner /// getFloatingTypeOrder - Compare the rank of the two specified floating 866a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner /// point types, ignoring the domain of the type (i.e. 'double' == 867a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner /// '_Complex double'). If LHS > RHS, return 1. If LHS == RHS, return 0. If 868a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner /// LHS < RHS, return -1. 869a75cea3f6be0daa8054d36af81a6ffda1713f82dChris Lattner int getFloatingTypeOrder(QualType LHS, QualType RHS); 8705f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 871716c7304ff5d27a95e1e7823acd1d09d5ec3e37fSteve Naroff /// getFloatingTypeOfSizeWithinDomain - Returns a real floating 872716c7304ff5d27a95e1e7823acd1d09d5ec3e37fSteve Naroff /// point or a complex type (based on typeDomain/typeSize). 873716c7304ff5d27a95e1e7823acd1d09d5ec3e37fSteve Naroff /// 'typeDomain' is a real floating point or complex type. 874716c7304ff5d27a95e1e7823acd1d09d5ec3e37fSteve Naroff /// 'typeSize' is a real floating point or complex type. 875f1448a0e4a1e868ff873a8530a61a09cb68666ccSteve Naroff QualType getFloatingTypeOfSizeWithinDomain(QualType typeSize, 876f1448a0e4a1e868ff873a8530a61a09cb68666ccSteve Naroff QualType typeDomain) const; 877ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff 878f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedmanprivate: 879f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman // Helper for integer ordering 880f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman unsigned getIntegerRank(Type* T); 881f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman 882f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedmanpublic: 883f98aba35e6c3da5aae61843fc01334939e4e12ecEli Friedman 884ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff //===--------------------------------------------------------------------===// 885ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff // Type Compatibility Predicates 886ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff //===--------------------------------------------------------------------===// 887ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff 888ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff /// Compatibility predicates used to check assignment expressions. 889ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff bool typesAreCompatible(QualType, QualType); // C99 6.2.7p1 890ec0550fa3653d46560bf4484a2e988329c228e39Steve Naroff 891a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek bool isObjCIdType(QualType T) const { 892de2e22d33afec98324a66a358dfe0951b3c7259aSteve Naroff return T == ObjCIdTypedefType; 893389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff } 894a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek bool isObjCClassType(QualType T) const { 895de2e22d33afec98324a66a358dfe0951b3c7259aSteve Naroff return T == ObjCClassTypedefType; 896389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff } 897a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek bool isObjCSelType(QualType T) const { 898a526c5c67e5a0473c340903ee542ce570119665fTed Kremenek assert(SelStructType && "isObjCSelType used before 'SEL' type is built"); 8998baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson return T->getAsStructureType() == SelStructType; 9008baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson } 9014084c306635b70f37029dca938444e6013f08684Steve Naroff bool QualifiedIdConformsQualifiedId(QualType LHS, QualType RHS); 9024084c306635b70f37029dca938444e6013f08684Steve Naroff bool ObjCQualifiedIdTypesAreCompatible(QualType LHS, QualType RHS, 9034084c306635b70f37029dca938444e6013f08684Steve Naroff bool ForCompare); 9048baaca50f07d0c10bba69c8d88c1b9078c92d06dAnders Carlsson 9053d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman // Check the safety of assignment from LHS to RHS 90614108da7f7fc059772711e4ffee1322a27b152a7Steve Naroff bool canAssignObjCInterfaces(const ObjCObjectPointerType *LHSOPT, 90714108da7f7fc059772711e4ffee1322a27b152a7Steve Naroff const ObjCObjectPointerType *RHSOPT); 90814108da7f7fc059772711e4ffee1322a27b152a7Steve Naroff bool canAssignObjCInterfaces(const ObjCInterfaceType *LHS, 9093d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman const ObjCInterfaceType *RHS); 910389bf46ae41241a656ed71b00ac2177d7f385651Steve Naroff bool areComparableObjCPointerTypes(QualType LHS, QualType RHS); 9113d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman 9123d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman // Functions for calculating composite types 9133d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman QualType mergeTypes(QualType, QualType); 9143d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman QualType mergeFunctionTypes(QualType, QualType); 9153d815e7eb56c25d7ed812eced32e41df43039f9aEli Friedman 916a95d75769edae299816ec7fd9bbcdf1ef617c5c9Eli Friedman /// UsualArithmeticConversionsType - handles the various conversions 917a95d75769edae299816ec7fd9bbcdf1ef617c5c9Eli Friedman /// that are common to binary operators (C99 6.3.1.8, C++ [expr]p9) 918a95d75769edae299816ec7fd9bbcdf1ef617c5c9Eli Friedman /// and returns the result type of that conversion. 919a95d75769edae299816ec7fd9bbcdf1ef617c5c9Eli Friedman QualType UsualArithmeticConversionsType(QualType lhs, QualType rhs); 920a95d75769edae299816ec7fd9bbcdf1ef617c5c9Eli Friedman 921368eefa081d12f0a265ee90ee8ec61b54168d57dChris Lattner //===--------------------------------------------------------------------===// 922ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // Integer Predicates 923ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman //===--------------------------------------------------------------------===// 924ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman 925ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // The width of an integer, as defined in C99 6.2.6.2. This is the number 926ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // of bits in an integer type excluding any padding bits. 927ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman unsigned getIntWidth(QualType T); 928ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman 929ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // Per C99 6.2.5p6, for every signed integer type, there is a corresponding 930ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // unsigned integer type. This method takes a signed type, and returns the 931ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman // corresponding unsigned integer type. 932ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman QualType getCorrespondingUnsignedType(QualType T); 933ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman 934ad74a758189180b8ab8faea648e4766c3bfd7fcbEli Friedman //===--------------------------------------------------------------------===// 935e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek // Type Iterators. 936e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek //===--------------------------------------------------------------------===// 937e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek 938e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek typedef std::vector<Type*>::iterator type_iterator; 939e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek typedef std::vector<Type*>::const_iterator const_type_iterator; 940e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek 941e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek type_iterator types_begin() { return Types.begin(); } 942e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek type_iterator types_end() { return Types.end(); } 943e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek const_type_iterator types_begin() const { return Types.begin(); } 944e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek const_type_iterator types_end() const { return Types.end(); } 945e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek 946e22d911dcff7a9c18b583817b7319c07600fd3eeTed Kremenek //===--------------------------------------------------------------------===// 9470cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar // Integer Values 9480cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar //===--------------------------------------------------------------------===// 9490cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar 9500cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar /// MakeIntValue - Make an APSInt of the appropriate width and 9510cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar /// signedness for the given \arg Value and integer \arg Type. 9520cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar llvm::APSInt MakeIntValue(uint64_t Value, QualType Type) { 9530cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar llvm::APSInt Res(getIntWidth(Type), !Type->isSignedIntegerType()); 9540cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar Res = Value; 9550cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar return Res; 9560cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar } 9570cd7fc28d4f69b281522b1bc96decd2b92cfd812Daniel Dunbar 9588a1d722f13df383600f36d77f842957c8adb5f1bArgyrios Kyrtzidis /// \brief Get the implementation of ObjCInterfaceDecl,or NULL if none exists. 9598a1d722f13df383600f36d77f842957c8adb5f1bArgyrios Kyrtzidis ObjCImplementationDecl *getObjCImplementation(ObjCInterfaceDecl *D); 9608a1d722f13df383600f36d77f842957c8adb5f1bArgyrios Kyrtzidis /// \brief Get the implementation of ObjCCategoryDecl, or NULL if none exists. 9618a1d722f13df383600f36d77f842957c8adb5f1bArgyrios Kyrtzidis ObjCCategoryImplDecl *getObjCImplementation(ObjCCategoryDecl *D); 9628a1d722f13df383600f36d77f842957c8adb5f1bArgyrios Kyrtzidis 9638a1d722f13df383600f36d77f842957c8adb5f1bArgyrios Kyrtzidis /// \brief Set the implementation of ObjCInterfaceDecl. 9648a1d722f13df383600f36d77f842957c8adb5f1bArgyrios Kyrtzidis void setObjCImplementation(ObjCInterfaceDecl *IFaceD, 9658a1d722f13df383600f36d77f842957c8adb5f1bArgyrios Kyrtzidis ObjCImplementationDecl *ImplD); 9668a1d722f13df383600f36d77f842957c8adb5f1bArgyrios Kyrtzidis /// \brief Set the implementation of ObjCCategoryDecl. 9678a1d722f13df383600f36d77f842957c8adb5f1bArgyrios Kyrtzidis void setObjCImplementation(ObjCCategoryDecl *CatD, 9688a1d722f13df383600f36d77f842957c8adb5f1bArgyrios Kyrtzidis ObjCCategoryImplDecl *ImplD); 9698a1d722f13df383600f36d77f842957c8adb5f1bArgyrios Kyrtzidis 970b17166c8077cd900cca83a895c43b30ea6660598Argyrios Kyrtzidis /// \brief Allocate an uninitialized DeclaratorInfo. 971b17166c8077cd900cca83a895c43b30ea6660598Argyrios Kyrtzidis /// 972b17166c8077cd900cca83a895c43b30ea6660598Argyrios Kyrtzidis /// The caller should initialize the memory held by DeclaratorInfo using 973b17166c8077cd900cca83a895c43b30ea6660598Argyrios Kyrtzidis /// the TypeLoc wrappers. 974b17166c8077cd900cca83a895c43b30ea6660598Argyrios Kyrtzidis /// 975b17166c8077cd900cca83a895c43b30ea6660598Argyrios Kyrtzidis /// \param T the type that will be the basis for type source info. This type 976b17166c8077cd900cca83a895c43b30ea6660598Argyrios Kyrtzidis /// should refer to how the declarator was written in source code, not to 977b17166c8077cd900cca83a895c43b30ea6660598Argyrios Kyrtzidis /// what type semantic analysis resolved the declarator to. 978b17166c8077cd900cca83a895c43b30ea6660598Argyrios Kyrtzidis DeclaratorInfo *CreateDeclaratorInfo(QualType T); 979b17166c8077cd900cca83a895c43b30ea6660598Argyrios Kyrtzidis 9805f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencerprivate: 9815f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer ASTContext(const ASTContext&); // DO NOT IMPLEMENT 9825f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer void operator=(const ASTContext&); // DO NOT IMPLEMENT 9835f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 9845f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer void InitBuiltinTypes(); 9855f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer void InitBuiltinType(QualType &R, BuiltinType::Kind K); 9864b7c98378ae0c1a3635f0b7756848b4a9923f8bcTed Kremenek 98782a6cfbc421cc99c5b7313271f399f7ef95056ecDaniel Dunbar // Return the ObjC type encoding for a given type. 98882a6cfbc421cc99c5b7313271f399f7ef95056ecDaniel Dunbar void getObjCEncodingForTypeImpl(QualType t, std::string &S, 98982a6cfbc421cc99c5b7313271f399f7ef95056ecDaniel Dunbar bool ExpandPointedToStructures, 99082a6cfbc421cc99c5b7313271f399f7ef95056ecDaniel Dunbar bool ExpandStructures, 991153bfe5795e2c1a5a738e73d3784964e082237fcDaniel Dunbar const FieldDecl *Field, 992090b3f71702c5626d8520f9608d77c6f26dcfa15Fariborz Jahanian bool OutermostType = false, 9936ab3524f72a6e64aa04973fa9433b5559abb3525Douglas Gregor bool EncodingProperty = false); 994b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar 995b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar const ASTRecordLayout &getObjCLayout(const ObjCInterfaceDecl *D, 996b2dbbb99e12806eaaf53b7ccabc32f42b5719443Daniel Dunbar const ObjCImplementationDecl *Impl); 9975f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer}; 998e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl 9995f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer} // end namespace clang 10005f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 1001e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl// operator new and delete aren't allowed inside namespaces. 1002e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl// The throw specifications are mandated by the standard. 1003e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @brief Placement new for using the ASTContext's allocator. 1004e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// 1005e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// This placement form of operator new uses the ASTContext's allocator for 1006e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// obtaining memory. It is a non-throwing new, which means that it returns 1007e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// null on error. (If that is what the allocator does. The current does, so if 1008e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// this ever changes, this operator will have to be changed, too.) 1009e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// Usage looks like this (assuming there's an ASTContext 'Context' in scope): 1010e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @code 1011e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// // Default alignment (16) 1012e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// IntegerLiteral *Ex = new (Context) IntegerLiteral(arguments); 1013e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// // Specific alignment 1014e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// IntegerLiteral *Ex2 = new (Context, 8) IntegerLiteral(arguments); 1015e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @endcode 1016e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// Please note that you cannot use delete on the pointer; it must be 1017e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// deallocated using an explicit destructor call followed by 10184398a78095cd05a3be702fbab25bfe324a5d7946Ted Kremenek/// @c Context.Deallocate(Ptr). 1019e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// 1020e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @param Bytes The number of bytes to allocate. Calculated by the compiler. 1021e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @param C The ASTContext that provides the allocator. 102242542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @param Alignment The alignment of the allocated memory (if the underlying 102342542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// allocator supports it). 1024e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @return The allocated memory. Could be NULL. 1025e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redlinline void *operator new(size_t Bytes, clang::ASTContext &C, 10269f9bf258f8ebae30bfb70feb9d797d6eb67b0460Douglas Gregor size_t Alignment) throw () { 1027c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff return C.Allocate(Bytes, Alignment); 1028e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl} 1029e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// @brief Placement delete companion to the new above. 1030e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// 1031e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// This operator is just a companion to the new above. There is no way of 1032e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// invoking it directly; see the new operator for more details. This operator 1033e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// is called implicitly by the compiler if a placement new expression using 1034e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl/// the ASTContext throws in the object constructor. 1035fb523e16dd1f860ff02a3ae03e5e3e25327a5860Chris Lattnerinline void operator delete(void *Ptr, clang::ASTContext &C, size_t) 1036e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl throw () { 1037c0ac4923f08b25ae973a8ee7942cf3eb89da57b7Steve Naroff C.Deallocate(Ptr); 1038e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl} 1039e91b3bc1624ec877862e5d276f1b6f5026fe71e3Sebastian Redl 104042542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// This placement form of operator new[] uses the ASTContext's allocator for 104142542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// obtaining memory. It is a non-throwing new[], which means that it returns 104242542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// null on error. 104342542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// Usage looks like this (assuming there's an ASTContext 'Context' in scope): 104442542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @code 104542542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// // Default alignment (16) 104642542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// char *data = new (Context) char[10]; 104742542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// // Specific alignment 104842542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// char *data = new (Context, 8) char[10]; 104942542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @endcode 105042542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// Please note that you cannot use delete on the pointer; it must be 105142542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// deallocated using an explicit destructor call followed by 10524398a78095cd05a3be702fbab25bfe324a5d7946Ted Kremenek/// @c Context.Deallocate(Ptr). 105342542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// 105442542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @param Bytes The number of bytes to allocate. Calculated by the compiler. 105542542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @param C The ASTContext that provides the allocator. 105642542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @param Alignment The alignment of the allocated memory (if the underlying 105742542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// allocator supports it). 105842542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @return The allocated memory. Could be NULL. 105942542c6a4b3c60f63820e6177a8938443831492cTed Kremenekinline void *operator new[](size_t Bytes, clang::ASTContext& C, 106042542c6a4b3c60f63820e6177a8938443831492cTed Kremenek size_t Alignment = 16) throw () { 106142542c6a4b3c60f63820e6177a8938443831492cTed Kremenek return C.Allocate(Bytes, Alignment); 106242542c6a4b3c60f63820e6177a8938443831492cTed Kremenek} 106342542c6a4b3c60f63820e6177a8938443831492cTed Kremenek 106442542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// @brief Placement delete[] companion to the new[] above. 106542542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// 106642542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// This operator is just a companion to the new[] above. There is no way of 106742542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// invoking it directly; see the new[] operator for more details. This operator 106842542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// is called implicitly by the compiler if a placement new[] expression using 106942542c6a4b3c60f63820e6177a8938443831492cTed Kremenek/// the ASTContext throws in the object constructor. 107042542c6a4b3c60f63820e6177a8938443831492cTed Kremenekinline void operator delete[](void *Ptr, clang::ASTContext &C) throw () { 107142542c6a4b3c60f63820e6177a8938443831492cTed Kremenek C.Deallocate(Ptr); 107242542c6a4b3c60f63820e6177a8938443831492cTed Kremenek} 107342542c6a4b3c60f63820e6177a8938443831492cTed Kremenek 10745f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer#endif 1075