ASTContext.h revision 464175bba1318bef7905122e9fda20cff926df78
15f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer//===--- ASTContext.h - Context to hold long-lived AST nodes ----*- C++ -*-===// 25f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer// 35f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer// The LLVM Compiler Infrastructure 45f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer// 55f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer// This file was developed by Chris Lattner and is distributed under 65f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer// the University of Illinois Open Source 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 175f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer#include "clang/AST/Builtins.h" 185f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer#include "clang/AST/Expr.h" 19464175bba1318bef7905122e9fda20cff926df78Chris Lattner#include "clang/AST/RecordLayout.h" 20464175bba1318bef7905122e9fda20cff926df78Chris Lattner#include "clang/AST/Type.h" 21464175bba1318bef7905122e9fda20cff926df78Chris Lattner#include "llvm/ADT/DenseMap.h" 225f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer#include <vector> 235f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 245f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencernamespace clang { 255f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer class TargetInfo; 265f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 275f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer/// ASTContext - This class holds long-lived AST nodes (such as types and 285f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer/// decls) that can be referred to throughout the semantic analysis of a file. 295f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencerclass ASTContext { 305f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer std::vector<Type*> Types; 315f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer llvm::FoldingSet<ComplexType> ComplexTypes; 325f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer llvm::FoldingSet<PointerType> PointerTypes; 335f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer llvm::FoldingSet<ReferenceType> ReferenceTypes; 345f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer llvm::FoldingSet<ArrayType> ArrayTypes; 355f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer llvm::FoldingSet<VectorType> VectorTypes; 365f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer llvm::FoldingSet<FunctionTypeNoProto> FunctionTypeNoProtos; 375f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer llvm::FoldingSet<FunctionTypeProto> FunctionTypeProtos; 38464175bba1318bef7905122e9fda20cff926df78Chris Lattner llvm::DenseMap<const RecordDecl*, const RecordLayout*> RecordLayoutInfo; 395f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencerpublic: 405f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer TargetInfo &Target; 415f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer Builtin::Context BuiltinInfo; 425f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 435f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer // Builtin Types. 445f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType VoidTy; 455f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType BoolTy; 465f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType CharTy; 475f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType SignedCharTy, ShortTy, IntTy, LongTy, LongLongTy; 485f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType UnsignedCharTy, UnsignedShortTy, UnsignedIntTy, UnsignedLongTy; 495f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType UnsignedLongLongTy; 505f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType FloatTy, DoubleTy, LongDoubleTy; 515f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType FloatComplexTy, DoubleComplexTy, LongDoubleComplexTy; 525f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 535f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer ASTContext(TargetInfo &t, IdentifierTable &idents) : Target(t) { 545f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer InitBuiltinTypes(); 555f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer BuiltinInfo.InitializeBuiltins(idents, Target); 565f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer } 575f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer ~ASTContext(); 585f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 595f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer void PrintStats() const; 60d2d2a11a91d7ddf468bfb70f66362d24806ed601Chris Lattner 61464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 62464175bba1318bef7905122e9fda20cff926df78Chris Lattner // Type Constructors 63464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 64d2d2a11a91d7ddf468bfb70f66362d24806ed601Chris Lattner 655f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getComplexType - Return the uniqued reference to the type for a complex 665f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// number with the specified element type. 675f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getComplexType(QualType T); 685f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 695f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getPointerType - Return the uniqued reference to the type for a pointer to 705f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// the specified type. 715f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getPointerType(QualType T); 725f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 735f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getReferenceType - Return the uniqued reference to the type for a 745f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// reference to the specified type. 755f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getReferenceType(QualType T); 765f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 775f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getArrayType - Return the unique reference to the type for an array of the 785f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// specified element type. 795f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getArrayType(QualType EltTy, ArrayType::ArraySizeModifier ASM, 805f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer unsigned EltTypeQuals, Expr *NumElts); 815f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 825f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// convertToVectorType - Return the unique reference to a vector type of 835f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// the specified element type and size. VectorType can be a pointer, array, 845f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// function, or built-in type (i.e. _Bool, integer, or float). 855f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType convertToVectorType(QualType VectorType, unsigned NumElts); 865f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 875f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getFunctionTypeNoProto - Return a K&R style C function type like 'int()'. 885f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// 895f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getFunctionTypeNoProto(QualType ResultTy); 905f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 915f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getFunctionType - Return a normal function type with a typed argument 925f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// list. isVariadic indicates whether the argument list includes '...'. 935f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getFunctionType(QualType ResultTy, QualType *ArgArray, 945f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer unsigned NumArgs, bool isVariadic); 955f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 965f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getTypedefType - Return the unique reference to the type for the 975f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// specified typename decl. 985f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getTypedefType(TypedefDecl *Decl); 995f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 1005f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getTagDeclType - Return the unique reference to the type for the 1015f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// specified TagDecl (struct/union/class/enum) decl. 1025f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getTagDeclType(TagDecl *Decl); 1035f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 1045f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getSizeType - Return the unique type for "size_t" (C99 7.17), defined 1055f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// in <stddef.h>. The sizeof operator requires this (C99 6.5.3.4p4). 1065f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType getSizeType() const; 1075f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 1088b9023ba35a86838789e2c9034a6128728c547aaChris Lattner /// getPointerDiffType - Return the unique type for "ptrdiff_t" (ref?) 1098b9023ba35a86838789e2c9034a6128728c547aaChris Lattner /// defined in <stddef.h>. Pointer - pointer requires this (C99 6.5.6p9). 1108b9023ba35a86838789e2c9034a6128728c547aaChris Lattner QualType getPointerDiffType() const; 1118b9023ba35a86838789e2c9034a6128728c547aaChris Lattner 112464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 113464175bba1318bef7905122e9fda20cff926df78Chris Lattner // Type Sizing and Analysis 114464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 115464175bba1318bef7905122e9fda20cff926df78Chris Lattner 116464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// getTypeInfo - Get the size and alignment of the specified complete type in 117464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// bits. 118464175bba1318bef7905122e9fda20cff926df78Chris Lattner std::pair<uint64_t, unsigned> getTypeInfo(QualType T, SourceLocation L); 119464175bba1318bef7905122e9fda20cff926df78Chris Lattner 120464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// getTypeSize - Return the size of the specified type, in bits. This method 121464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// does not work on incomplete types. 122464175bba1318bef7905122e9fda20cff926df78Chris Lattner uint64_t getTypeSize(QualType T, SourceLocation L) { 123464175bba1318bef7905122e9fda20cff926df78Chris Lattner return getTypeInfo(T, L).first; 124464175bba1318bef7905122e9fda20cff926df78Chris Lattner } 125464175bba1318bef7905122e9fda20cff926df78Chris Lattner 126464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// getTypeAlign - Return the alignment of the specified type, in bits. This 127464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// method does not work on incomplete types. 128464175bba1318bef7905122e9fda20cff926df78Chris Lattner unsigned getTypeAlign(QualType T, SourceLocation L) { 129464175bba1318bef7905122e9fda20cff926df78Chris Lattner return getTypeInfo(T, L).second; 130464175bba1318bef7905122e9fda20cff926df78Chris Lattner } 131464175bba1318bef7905122e9fda20cff926df78Chris Lattner 132464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// getRecordLayout - Get or compute information about the layout of the 133464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// specified record (struct/union/class), which indicates its size and field 134464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// position information. 135464175bba1318bef7905122e9fda20cff926df78Chris Lattner const RecordLayout &getRecordLayout(const RecordDecl *D, SourceLocation L); 136464175bba1318bef7905122e9fda20cff926df78Chris Lattner 137464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 138464175bba1318bef7905122e9fda20cff926df78Chris Lattner // Type Operators 139464175bba1318bef7905122e9fda20cff926df78Chris Lattner //===--------------------------------------------------------------------===// 140464175bba1318bef7905122e9fda20cff926df78Chris Lattner 1415f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// getIntegerBitwidth - Return the bitwidth of the specified integer type 1425f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// according to the target. 'Loc' specifies the source location that 1435f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer /// requires evaluation of this property. 1445f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer unsigned getIntegerBitwidth(QualType T, SourceLocation Loc); 145464175bba1318bef7905122e9fda20cff926df78Chris Lattner 146464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// maxIntegerType - Returns the highest ranked integer type. Handles 3 147464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// different type combos: unsigned/unsigned, signed/signed, signed/unsigned. 1485f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer static QualType maxIntegerType(QualType lhs, QualType rhs); 1495f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 150464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// maxFloatingType - Returns the highest ranked float type. Both input 151464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// types are required to be floats. 1525f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer static QualType maxFloatingType(QualType lt, QualType rt); 1535f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 154464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// maxComplexType - Returns the highest ranked complex type. Handles 3 155464175bba1318bef7905122e9fda20cff926df78Chris Lattner /// different type combos: complex/complex, complex/float, float/complex. 1565f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer QualType maxComplexType(QualType lt, QualType rt) const; 1575f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 1585f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencerprivate: 1595f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer ASTContext(const ASTContext&); // DO NOT IMPLEMENT 1605f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer void operator=(const ASTContext&); // DO NOT IMPLEMENT 1615f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 1625f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer void InitBuiltinTypes(); 1635f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer void InitBuiltinType(QualType &R, BuiltinType::Kind K); 1645f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer}; 1655f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 1665f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer} // end namespace clang 1675f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer 1685f016e2cb5d11daeb237544de1c5d59f20fe1a6eReid Spencer#endif 169