clang API Documentation

CGCXXABI.cpp
Go to the documentation of this file.
00001 //===----- CGCXXABI.cpp - Interface to C++ ABIs -----------------*- C++ -*-===//
00002 //
00003 //                     The LLVM Compiler Infrastructure
00004 //
00005 // This file is distributed under the University of Illinois Open Source
00006 // License. See LICENSE.TXT for details.
00007 //
00008 //===----------------------------------------------------------------------===//
00009 //
00010 // This provides an abstract class for C++ code generation. Concrete subclasses
00011 // of this implement code generation for specific C++ ABIs.
00012 //
00013 //===----------------------------------------------------------------------===//
00014 
00015 #include "CGCXXABI.h"
00016 
00017 using namespace clang;
00018 using namespace CodeGen;
00019 
00020 CGCXXABI::~CGCXXABI() { }
00021 
00022 static void ErrorUnsupportedABI(CodeGenFunction &CGF,
00023                                 StringRef S) {
00024   DiagnosticsEngine &Diags = CGF.CGM.getDiags();
00025   unsigned DiagID = Diags.getCustomDiagID(DiagnosticsEngine::Error,
00026                                           "cannot yet compile %1 in this ABI");
00027   Diags.Report(CGF.getContext().getFullLoc(CGF.CurCodeDecl->getLocation()),
00028                DiagID)
00029     << S;
00030 }
00031 
00032 static llvm::Constant *GetBogusMemberPointer(CodeGenModule &CGM,
00033                                              QualType T) {
00034   return llvm::Constant::getNullValue(CGM.getTypes().ConvertType(T));
00035 }
00036 
00037 llvm::Type *
00038 CGCXXABI::ConvertMemberPointerType(const MemberPointerType *MPT) {
00039   return CGM.getTypes().ConvertType(CGM.getContext().getPointerDiffType());
00040 }
00041 
00042 llvm::Value *CGCXXABI::EmitLoadOfMemberFunctionPointer(CodeGenFunction &CGF,
00043                                                        llvm::Value *&This,
00044                                                        llvm::Value *MemPtr,
00045                                                  const MemberPointerType *MPT) {
00046   ErrorUnsupportedABI(CGF, "calls through member pointers");
00047 
00048   const FunctionProtoType *FPT = 
00049     MPT->getPointeeType()->getAs<FunctionProtoType>();
00050   const CXXRecordDecl *RD = 
00051     cast<CXXRecordDecl>(MPT->getClass()->getAs<RecordType>()->getDecl());
00052   llvm::FunctionType *FTy = CGM.getTypes().GetFunctionType(
00053                               CGM.getTypes().arrangeCXXMethodType(RD, FPT));
00054   return llvm::Constant::getNullValue(FTy->getPointerTo());
00055 }
00056 
00057 llvm::Value *CGCXXABI::EmitMemberDataPointerAddress(CodeGenFunction &CGF,
00058                                                     llvm::Value *Base,
00059                                                     llvm::Value *MemPtr,
00060                                               const MemberPointerType *MPT) {
00061   ErrorUnsupportedABI(CGF, "loads of member pointers");
00062   llvm::Type *Ty = CGF.ConvertType(MPT->getPointeeType())->getPointerTo();
00063   return llvm::Constant::getNullValue(Ty);
00064 }
00065 
00066 llvm::Value *CGCXXABI::EmitMemberPointerConversion(CodeGenFunction &CGF,
00067                                                    const CastExpr *E,
00068                                                    llvm::Value *Src) {
00069   ErrorUnsupportedABI(CGF, "member function pointer conversions");
00070   return GetBogusMemberPointer(CGM, E->getType());
00071 }
00072 
00073 llvm::Constant *CGCXXABI::EmitMemberPointerConversion(const CastExpr *E,
00074                                                       llvm::Constant *Src) {
00075   return GetBogusMemberPointer(CGM, E->getType());
00076 }
00077 
00078 llvm::Value *
00079 CGCXXABI::EmitMemberPointerComparison(CodeGenFunction &CGF,
00080                                       llvm::Value *L,
00081                                       llvm::Value *R,
00082                                       const MemberPointerType *MPT,
00083                                       bool Inequality) {
00084   ErrorUnsupportedABI(CGF, "member function pointer comparison");
00085   return CGF.Builder.getFalse();
00086 }
00087 
00088 llvm::Value *
00089 CGCXXABI::EmitMemberPointerIsNotNull(CodeGenFunction &CGF,
00090                                      llvm::Value *MemPtr,
00091                                      const MemberPointerType *MPT) {
00092   ErrorUnsupportedABI(CGF, "member function pointer null testing");
00093   return CGF.Builder.getFalse();
00094 }
00095 
00096 llvm::Constant *
00097 CGCXXABI::EmitNullMemberPointer(const MemberPointerType *MPT) {
00098   return GetBogusMemberPointer(CGM, QualType(MPT, 0));
00099 }
00100 
00101 llvm::Constant *CGCXXABI::EmitMemberPointer(const CXXMethodDecl *MD) {
00102   return GetBogusMemberPointer(CGM,
00103                          CGM.getContext().getMemberPointerType(MD->getType(),
00104                                          MD->getParent()->getTypeForDecl()));
00105 }
00106 
00107 llvm::Constant *CGCXXABI::EmitMemberDataPointer(const MemberPointerType *MPT,
00108                                                 CharUnits offset) {
00109   return GetBogusMemberPointer(CGM, QualType(MPT, 0));
00110 }
00111 
00112 llvm::Constant *CGCXXABI::EmitMemberPointer(const APValue &MP, QualType MPT) {
00113   return GetBogusMemberPointer(CGM, MPT);
00114 }
00115 
00116 bool CGCXXABI::isZeroInitializable(const MemberPointerType *MPT) {
00117   // Fake answer.
00118   return true;
00119 }
00120 
00121 void CGCXXABI::BuildThisParam(CodeGenFunction &CGF, FunctionArgList &params) {
00122   const CXXMethodDecl *MD = cast<CXXMethodDecl>(CGF.CurGD.getDecl());
00123 
00124   // FIXME: I'm not entirely sure I like using a fake decl just for code
00125   // generation. Maybe we can come up with a better way?
00126   ImplicitParamDecl *ThisDecl
00127     = ImplicitParamDecl::Create(CGM.getContext(), 0, MD->getLocation(),
00128                                 &CGM.getContext().Idents.get("this"),
00129                                 MD->getThisType(CGM.getContext()));
00130   params.push_back(ThisDecl);
00131   getThisDecl(CGF) = ThisDecl;
00132 }
00133 
00134 void CGCXXABI::EmitThisParam(CodeGenFunction &CGF) {
00135   /// Initialize the 'this' slot.
00136   assert(getThisDecl(CGF) && "no 'this' variable for function");
00137   getThisValue(CGF)
00138     = CGF.Builder.CreateLoad(CGF.GetAddrOfLocalVar(getThisDecl(CGF)),
00139                              "this");
00140 }
00141 
00142 void CGCXXABI::EmitReturnFromThunk(CodeGenFunction &CGF,
00143                                    RValue RV, QualType ResultType) {
00144   CGF.EmitReturnOfRValue(RV, ResultType);
00145 }
00146 
00147 CharUnits CGCXXABI::GetArrayCookieSize(const CXXNewExpr *expr) {
00148   if (!requiresArrayCookie(expr))
00149     return CharUnits::Zero();
00150   return getArrayCookieSizeImpl(expr->getAllocatedType());
00151 }
00152 
00153 CharUnits CGCXXABI::getArrayCookieSizeImpl(QualType elementType) {
00154   // BOGUS
00155   return CharUnits::Zero();
00156 }
00157 
00158 llvm::Value *CGCXXABI::InitializeArrayCookie(CodeGenFunction &CGF,
00159                                              llvm::Value *NewPtr,
00160                                              llvm::Value *NumElements,
00161                                              const CXXNewExpr *expr,
00162                                              QualType ElementType) {
00163   // Should never be called.
00164   ErrorUnsupportedABI(CGF, "array cookie initialization");
00165   return 0;
00166 }
00167 
00168 bool CGCXXABI::requiresArrayCookie(const CXXDeleteExpr *expr,
00169                                    QualType elementType) {
00170   // If the class's usual deallocation function takes two arguments,
00171   // it needs a cookie.
00172   if (expr->doesUsualArrayDeleteWantSize())
00173     return true;
00174 
00175   return elementType.isDestructedType();
00176 }
00177 
00178 bool CGCXXABI::requiresArrayCookie(const CXXNewExpr *expr) {
00179   // If the class's usual deallocation function takes two arguments,
00180   // it needs a cookie.
00181   if (expr->doesUsualArrayDeleteWantSize())
00182     return true;
00183 
00184   return expr->getAllocatedType().isDestructedType();
00185 }
00186 
00187 void CGCXXABI::ReadArrayCookie(CodeGenFunction &CGF, llvm::Value *ptr,
00188                                const CXXDeleteExpr *expr, QualType eltTy,
00189                                llvm::Value *&numElements,
00190                                llvm::Value *&allocPtr, CharUnits &cookieSize) {
00191   // Derive a char* in the same address space as the pointer.
00192   unsigned AS = cast<llvm::PointerType>(ptr->getType())->getAddressSpace();
00193   llvm::Type *charPtrTy = CGF.Int8Ty->getPointerTo(AS);
00194   ptr = CGF.Builder.CreateBitCast(ptr, charPtrTy);
00195 
00196   // If we don't need an array cookie, bail out early.
00197   if (!requiresArrayCookie(expr, eltTy)) {
00198     allocPtr = ptr;
00199     numElements = 0;
00200     cookieSize = CharUnits::Zero();
00201     return;
00202   }
00203 
00204   cookieSize = getArrayCookieSizeImpl(eltTy);
00205   allocPtr = CGF.Builder.CreateConstInBoundsGEP1_64(ptr,
00206                                                     -cookieSize.getQuantity());
00207   numElements = readArrayCookieImpl(CGF, allocPtr, cookieSize);
00208 }
00209 
00210 llvm::Value *CGCXXABI::readArrayCookieImpl(CodeGenFunction &CGF,
00211                                            llvm::Value *ptr,
00212                                            CharUnits cookieSize) {
00213   ErrorUnsupportedABI(CGF, "reading a new[] cookie");
00214   return llvm::ConstantInt::get(CGF.SizeTy, 0);
00215 }
00216 
00217 void CGCXXABI::EmitGuardedInit(CodeGenFunction &CGF,
00218                                const VarDecl &D,
00219                                llvm::GlobalVariable *GV,
00220                                bool PerformInit) {
00221   ErrorUnsupportedABI(CGF, "static local variable initialization");
00222 }
00223 
00224 void CGCXXABI::registerGlobalDtor(CodeGenFunction &CGF,
00225                                   llvm::Constant *dtor,
00226                                   llvm::Constant *addr) {
00227   // The default behavior is to use atexit.
00228   CGF.registerGlobalDtorWithAtExit(dtor, addr);
00229 }
00230 
00231 /// Returns the adjustment, in bytes, required for the given
00232 /// member-pointer operation.  Returns null if no adjustment is
00233 /// required.
00234 llvm::Constant *CGCXXABI::getMemberPointerAdjustment(const CastExpr *E) {
00235   assert(E->getCastKind() == CK_DerivedToBaseMemberPointer ||
00236          E->getCastKind() == CK_BaseToDerivedMemberPointer);
00237 
00238   QualType derivedType;
00239   if (E->getCastKind() == CK_DerivedToBaseMemberPointer)
00240     derivedType = E->getSubExpr()->getType();
00241   else
00242     derivedType = E->getType();
00243 
00244   const CXXRecordDecl *derivedClass =
00245     derivedType->castAs<MemberPointerType>()->getClass()->getAsCXXRecordDecl();
00246 
00247   return CGM.GetNonVirtualBaseClassOffset(derivedClass,
00248                                           E->path_begin(),
00249                                           E->path_end());
00250 }