blob: 5d99dba69a8cb1ab903fdec5904fcd1351b457f7 [file] [log] [blame]
Daniel Dunbar9c426522008-07-29 23:18:29 +00001//===-- CodeGenFunction.h - Per-Function state for LLVM CodeGen -*- C++ -*-===//
Chris Lattnerbed31442007-05-28 01:07:47 +00002//
3// The LLVM Compiler Infrastructure
4//
Chris Lattner5b12ab82007-12-29 19:59:25 +00005// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
Chris Lattnerbed31442007-05-28 01:07:47 +00007//
8//===----------------------------------------------------------------------===//
9//
10// This is the internal per-function state used for llvm translation.
11//
12//===----------------------------------------------------------------------===//
13
Chris Lattnerc18bfbb2008-02-29 17:10:38 +000014#ifndef CLANG_CODEGEN_CODEGENFUNCTION_H
15#define CLANG_CODEGEN_CODEGENFUNCTION_H
Chris Lattnerbed31442007-05-28 01:07:47 +000016
Chris Lattner4bd55962008-03-30 23:03:07 +000017#include "clang/AST/Type.h"
Chris Lattnerac248202007-05-30 00:13:02 +000018#include "llvm/ADT/DenseMap.h"
Chris Lattnere73e4322007-07-16 21:28:45 +000019#include "llvm/ADT/SmallVector.h"
Ted Kremenek08e17112008-06-17 02:43:46 +000020#include "clang/AST/Expr.h"
Argyrios Kyrtzidis07052352008-09-10 02:36:38 +000021#include "clang/AST/ExprCXX.h"
Ted Kremenek08e17112008-06-17 02:43:46 +000022#include "clang/AST/ExprObjC.h"
23
Chris Lattner2ccb73b2007-06-16 00:16:26 +000024#include <vector>
Daniel Dunbar88402ce2008-08-04 16:51:22 +000025#include <map>
Chris Lattner308f4312007-05-29 23:50:05 +000026
Daniel Dunbarcb463852008-11-01 01:53:16 +000027#include "CGBuilder.h"
Daniel Dunbar3d7c90b2008-09-08 21:33:45 +000028#include "CGCall.h"
Daniel Dunbar97db84c2008-08-23 03:46:30 +000029#include "CGValue.h"
30
Chris Lattnerbed31442007-05-28 01:07:47 +000031namespace llvm {
Daniel Dunbar6e8aa532008-08-11 05:35:13 +000032 class BasicBlock;
Chris Lattnerbed31442007-05-28 01:07:47 +000033 class Module;
Daniel Dunbar2efd5382008-09-30 01:06:03 +000034 class SwitchInst;
Chris Lattner23b7eb62007-06-15 23:05:46 +000035}
36
Chris Lattnerbed31442007-05-28 01:07:47 +000037namespace clang {
38 class ASTContext;
Chris Lattner84915fa2007-06-02 04:16:21 +000039 class Decl;
Daniel Dunbar6e8aa532008-08-11 05:35:13 +000040 class EnumConstantDecl;
Chris Lattnerbed31442007-05-28 01:07:47 +000041 class FunctionDecl;
Daniel Dunbar6e8aa532008-08-11 05:35:13 +000042 class FunctionTypeProto;
43 class LabelStmt;
Daniel Dunbar1c64e5d2008-09-24 04:00:38 +000044 class ObjCInterfaceDecl;
45 class ObjCIvarDecl;
Chris Lattner4bd55962008-03-30 23:03:07 +000046 class ObjCMethodDecl;
Daniel Dunbar89654ee2008-08-26 08:29:31 +000047 class ObjCPropertyImplDecl;
Chris Lattner2ccb73b2007-06-16 00:16:26 +000048 class TargetInfo;
Daniel Dunbar6e8aa532008-08-11 05:35:13 +000049 class VarDecl;
Devang Patel3e11cce2007-10-23 02:10:49 +000050
Chris Lattnerbed31442007-05-28 01:07:47 +000051namespace CodeGen {
52 class CodeGenModule;
Devang Patel3e11cce2007-10-23 02:10:49 +000053 class CodeGenTypes;
Devang Patele11664a2007-11-01 19:11:01 +000054 class CGRecordLayout;
Daniel Dunbarcb463852008-11-01 01:53:16 +000055
Chris Lattnerbed31442007-05-28 01:07:47 +000056/// CodeGenFunction - This class organizes the per-function state that is used
57/// while generating LLVM code.
58class CodeGenFunction {
Chris Lattnerbda69f82007-08-26 23:13:56 +000059public:
Chris Lattnerbed31442007-05-28 01:07:47 +000060 CodeGenModule &CGM; // Per-module state.
Chris Lattnerd1af2d22007-05-29 23:17:50 +000061 TargetInfo &Target;
Chris Lattnerbda69f82007-08-26 23:13:56 +000062
Chris Lattner96d72562007-08-21 16:57:55 +000063 typedef std::pair<llvm::Value *, llvm::Value *> ComplexPairTy;
Daniel Dunbarcb463852008-11-01 01:53:16 +000064 CGBuilderTy Builder;
Chris Lattner3f3dbee2007-06-02 03:19:07 +000065
Chris Lattner5506f8c2008-04-04 04:07:35 +000066 // Holds the Decl for the current function or method
Chris Lattner5696e7b2008-06-17 18:05:57 +000067 const Decl *CurFuncDecl;
Chris Lattner4bd55962008-03-30 23:03:07 +000068 QualType FnRetTy;
Chris Lattnerac248202007-05-30 00:13:02 +000069 llvm::Function *CurFn;
70
Daniel Dunbar54bb1932008-09-09 21:00:17 +000071 /// ReturnBlock - Unified return block.
72 llvm::BasicBlock *ReturnBlock;
73 /// ReturnValue - The temporary alloca to hold the return value. This
74 /// is null iff the function has no return value.
75 llvm::Instruction *ReturnValue;
76
Chris Lattner03df1222007-06-02 04:53:11 +000077 /// AllocaInsertPoint - This is an instruction in the entry block before which
78 /// we prefer to insert allocas.
79 llvm::Instruction *AllocaInsertPt;
Daniel Dunbar88402ce2008-08-04 16:51:22 +000080
Chris Lattner6db1fb82007-06-02 22:49:07 +000081 const llvm::Type *LLVMIntTy;
Hartmut Kaiser7078da82007-10-17 15:00:17 +000082 uint32_t LLVMPointerWidth;
Daniel Dunbard3dcb4f82008-09-28 01:03:14 +000083
84public:
85 // FIXME: The following should be private once EH code is moved out
86 // of NeXT runtime.
87
88 // ObjCEHStack - This keeps track of which object to rethrow from
89 // inside @catch blocks and which @finally block exits from an EH
90 // scope should be chained through.
91 struct ObjCEHEntry {
Daniel Dunbar2efd5382008-09-30 01:06:03 +000092 ObjCEHEntry(llvm::BasicBlock *fb, llvm::BasicBlock *fne,
93 llvm::SwitchInst *fs, llvm::Value *dc)
94 : FinallyBlock(fb), FinallyNoExit(fne), FinallySwitch(fs),
95 DestCode(dc), Exception(0) {}
Daniel Dunbard3dcb4f82008-09-28 01:03:14 +000096
Daniel Dunbar2efd5382008-09-30 01:06:03 +000097 /// Entry point to the finally block.
98 llvm::BasicBlock *FinallyBlock;
99
100 /// Entry point to the finally block which skips execution of the
101 /// try_exit runtime function.
102 llvm::BasicBlock *FinallyNoExit;
103
104 /// Switch instruction which runs at the end of the finally block
105 /// to forward jumps through the finally block.
106 llvm::SwitchInst *FinallySwitch;
107
108 /// Variable holding the code for the destination of a jump
109 /// through the @finally block.
110 llvm::Value *DestCode;
111
112 /// The exception object being handled, during IR generation for a
113 /// @catch block.
114 llvm::Value *Exception;
Daniel Dunbard3dcb4f82008-09-28 01:03:14 +0000115 };
Daniel Dunbar2efd5382008-09-30 01:06:03 +0000116
117 typedef llvm::SmallVector<ObjCEHEntry*, 8> ObjCEHStackType;
118 ObjCEHStackType ObjCEHStack;
119
120 /// EmitJumpThroughFinally - Emit a branch from the current insert
121 /// point through the finally handling code for \arg Entry and then
Daniel Dunbar5c7e3932008-11-11 23:11:34 +0000122 /// on to \arg Dest. It is legal to call this function even if there
123 /// is no current insertion point.
Daniel Dunbar2efd5382008-09-30 01:06:03 +0000124 ///
125 /// \param ExecuteTryExit - When true, the try_exit runtime function
126 /// should be called prior to executing the finally code.
127 void EmitJumpThroughFinally(ObjCEHEntry *Entry, llvm::BasicBlock *Dest,
128 bool ExecuteTryExit=true);
Chris Lattner6db1fb82007-06-02 22:49:07 +0000129
Chris Lattner2da04b32007-08-24 05:35:26 +0000130private:
Daniel Dunbar88402ce2008-08-04 16:51:22 +0000131 /// LabelIDs - Track arbitrary ids assigned to labels for use in
132 /// implementing the GCC address-of-label extension and indirect
133 /// goto. IDs are assigned to labels inside getIDForAddrOfLabel().
134 std::map<const LabelStmt*, unsigned> LabelIDs;
135
136 /// IndirectSwitches - Record the list of switches for indirect
137 /// gotos. Emission of the actual switching code needs to be delayed
138 /// until all AddrLabelExprs have been seen.
139 std::vector<llvm::SwitchInst*> IndirectSwitches;
140
Chris Lattner84915fa2007-06-02 04:16:21 +0000141 /// LocalDeclMap - This keeps track of the LLVM allocas or globals for local C
142 /// decls.
Chris Lattner23b7eb62007-06-15 23:05:46 +0000143 llvm::DenseMap<const Decl*, llvm::Value*> LocalDeclMap;
Chris Lattner84915fa2007-06-02 04:16:21 +0000144
Chris Lattnerac248202007-05-30 00:13:02 +0000145 /// LabelMap - This keeps track of the LLVM basic block for each C label.
Chris Lattner23b7eb62007-06-15 23:05:46 +0000146 llvm::DenseMap<const LabelStmt*, llvm::BasicBlock*> LabelMap;
Chris Lattnere73e4322007-07-16 21:28:45 +0000147
148 // BreakContinueStack - This keeps track of where break and continue
149 // statements should jump to.
150 struct BreakContinue {
151 BreakContinue(llvm::BasicBlock *bb, llvm::BasicBlock *cb)
152 : BreakBlock(bb), ContinueBlock(cb) {}
153
154 llvm::BasicBlock *BreakBlock;
155 llvm::BasicBlock *ContinueBlock;
156 };
157 llvm::SmallVector<BreakContinue, 8> BreakContinueStack;
Daniel Dunbard3dcb4f82008-09-28 01:03:14 +0000158
Devang Patel49a44f32007-10-09 17:08:50 +0000159 /// SwitchInsn - This is nearest current switch instruction. It is null if
160 /// if current context is not in a switch.
Devang Patelda5d6bb2007-10-04 23:45:31 +0000161 llvm::SwitchInst *SwitchInsn;
162
Devang Patel49a44f32007-10-09 17:08:50 +0000163 /// CaseRangeBlock - This block holds if condition check for last case
164 /// statement range in current switch instruction.
Devang Patel11663122007-10-08 20:57:48 +0000165 llvm::BasicBlock *CaseRangeBlock;
166
Chris Lattnerbed31442007-05-28 01:07:47 +0000167public:
Chris Lattnerd1af2d22007-05-29 23:17:50 +0000168 CodeGenFunction(CodeGenModule &cgm);
Chris Lattnerbed31442007-05-28 01:07:47 +0000169
Chris Lattner6db1fb82007-06-02 22:49:07 +0000170 ASTContext &getContext() const;
171
Chris Lattner4bd55962008-03-30 23:03:07 +0000172 void GenerateObjCMethod(const ObjCMethodDecl *OMD);
Daniel Dunbar89654ee2008-08-26 08:29:31 +0000173
174 void StartObjCMethod(const ObjCMethodDecl *MD);
175
176 /// GenerateObjCGetter - Synthesize an Objective-C property getter
177 /// function.
178 void GenerateObjCGetter(const ObjCPropertyImplDecl *PID);
179
180 /// GenerateObjCSetter - Synthesize an Objective-C property setter
181 /// function for the given property.
182 void GenerateObjCSetter(const ObjCPropertyImplDecl *PID);
183
Daniel Dunbar9c426522008-07-29 23:18:29 +0000184 void GenerateCode(const FunctionDecl *FD,
185 llvm::Function *Fn);
Daniel Dunbarbc915f42008-09-09 23:14:03 +0000186 void StartFunction(const Decl *D, QualType RetTy,
187 llvm::Function *Fn,
Daniel Dunbar354d2782008-10-18 18:22:23 +0000188 const FunctionArgList &Args,
189 SourceLocation StartLoc);
Daniel Dunbar5c7e3932008-11-11 23:11:34 +0000190
191 /// FinishFunction - Complete IR generation of the current
192 /// function. It is legal to call this function even if there is no
193 /// current insertion point.
Daniel Dunbar89654ee2008-08-26 08:29:31 +0000194 void FinishFunction(SourceLocation EndLoc=SourceLocation());
Daniel Dunbar613855c2008-09-09 23:27:19 +0000195
196 /// EmitFunctionProlog - Emit the target specific LLVM code to load
197 /// the arguments for the given function. This is also responsible
198 /// for naming the LLVM function arguments.
199 void EmitFunctionProlog(llvm::Function *Fn, QualType RetTy,
200 const FunctionArgList &Args);
201
202 /// EmitFunctionEpilog - Emit the target specific LLVM code to
203 /// return the given temporary.
204 void EmitFunctionEpilog(QualType RetTy,
205 llvm::Value *ReturnValue);
206
Chris Lattnerf033c142007-06-22 19:05:19 +0000207 const llvm::Type *ConvertType(QualType T);
Chris Lattner5506f8c2008-04-04 04:07:35 +0000208
Daniel Dunbara94ecd22008-08-16 03:19:19 +0000209 /// LoadObjCSelf - Load the value of self. This function is only
210 /// valid while generating code for an Objective-C method.
Chris Lattner5506f8c2008-04-04 04:07:35 +0000211 llvm::Value *LoadObjCSelf();
Chris Lattner5696e7b2008-06-17 18:05:57 +0000212
213 /// isObjCPointerType - Return true if the specificed AST type will map onto
214 /// some Objective-C pointer type.
215 static bool isObjCPointerType(QualType T);
216
Chris Lattner54fb19e2007-06-22 22:02:34 +0000217 /// hasAggregateLLVMType - Return true if the specified AST type will map into
218 /// an aggregate LLVM type or is void.
219 static bool hasAggregateLLVMType(QualType T);
Daniel Dunbar75283ff2008-11-11 02:29:29 +0000220
221 /// createBasicBlock - Create an LLVM basic block.
222 llvm::BasicBlock *createBasicBlock(const char *Name="",
223 llvm::Function *Parent=0,
224 llvm::BasicBlock *InsertBefore=0) {
Daniel Dunbar851eec12008-11-12 00:01:12 +0000225#ifdef NDEBUG
226 return llvm::BasicBlock::Create("", Parent, InsertBefore);
227#else
Daniel Dunbar75283ff2008-11-11 02:29:29 +0000228 return llvm::BasicBlock::Create(Name, Parent, InsertBefore);
Daniel Dunbar851eec12008-11-12 00:01:12 +0000229#endif
Daniel Dunbar75283ff2008-11-11 02:29:29 +0000230 }
231
Chris Lattnerac248202007-05-30 00:13:02 +0000232 /// getBasicBlockForLabel - Return the LLVM basicblock that the specified
233 /// label maps to.
234 llvm::BasicBlock *getBasicBlockForLabel(const LabelStmt *S);
235
Daniel Dunbar5c7e3932008-11-11 23:11:34 +0000236 /// EmitBlock - Emit the given block \arg BB and set it as the
237 /// insert point, adding a fall-through branch from the current
238 /// insert block if necessary. It is legal to call this function
239 /// even if there is no current insertion point.
Daniel Dunbarfcac22e2008-11-13 01:24:05 +0000240 ///
241 /// IsFinished - If true, indicates that the caller has finished
242 /// emitting branches to the given block and does not expect to emit
243 /// code into it. This means the block can be ignored if it is
244 /// unreachable.
245 void EmitBlock(llvm::BasicBlock *BB, bool IsFinished=false);
Daniel Dunbar29ac59f2008-11-11 04:34:23 +0000246
Daniel Dunbarc56e6762008-11-11 09:41:28 +0000247 /// EmitBranch - Emit a branch to the specified basic block from the
248 /// current insert block, taking care to avoid creation of branches
Daniel Dunbar5c7e3932008-11-11 23:11:34 +0000249 /// from dummy blocks. It is legal to call this function even if
250 /// there is no current insertion point.
Daniel Dunbarab197eb2008-11-11 22:06:59 +0000251 ///
252 /// This function clears the current insertion point. The caller
253 /// should follow calls to this function with calls to Emit*Block
254 /// prior to generation new code.
Daniel Dunbarc56e6762008-11-11 09:41:28 +0000255 void EmitBranch(llvm::BasicBlock *Block);
256
Daniel Dunbar5c7e3932008-11-11 23:11:34 +0000257 /// HaveInsertPoint - True if an insertion point is defined. If not,
258 /// this indicates that the current code being emitted is
259 /// unreachable.
260 bool HaveInsertPoint() const {
261 return Builder.GetInsertBlock() != 0;
262 }
263
264 /// EnsureInsertPoint - Ensure that an insertion point is defined so
265 /// that emitted IR has a place to go. Note that by definition, if
266 /// this function creates a block then that block is unreachable;
267 /// callers may do better to detect when no insertion point is
268 /// defined and simply skip IR generation.
269 void EnsureInsertPoint() {
270 if (!HaveInsertPoint())
271 EmitBlock(createBasicBlock());
272 }
Chris Lattnerfc944342007-12-02 01:43:38 +0000273
Daniel Dunbara7c8cf62008-08-16 00:56:44 +0000274 /// ErrorUnsupported - Print out an error that codegen doesn't support the
Chris Lattnerfc944342007-12-02 01:43:38 +0000275 /// specified stmt yet.
Daniel Dunbarf2cf6d12008-09-04 03:43:08 +0000276 void ErrorUnsupported(const Stmt *S, const char *Type,
277 bool OmitOnError=false);
Chris Lattner84915fa2007-06-02 04:16:21 +0000278
Chris Lattnere9a64532007-06-22 21:44:33 +0000279 //===--------------------------------------------------------------------===//
280 // Helpers
281 //===--------------------------------------------------------------------===//
282
283 /// CreateTempAlloca - This creates a alloca and inserts it into the entry
284 /// block.
285 llvm::AllocaInst *CreateTempAlloca(const llvm::Type *Ty,
286 const char *Name = "tmp");
287
Chris Lattner8394d792007-06-05 20:53:16 +0000288 /// EvaluateExprAsBool - Perform the usual unary conversions on the specified
289 /// expression and compare the result against zero, returning an Int1Ty value.
Chris Lattner23b7eb62007-06-15 23:05:46 +0000290 llvm::Value *EvaluateExprAsBool(const Expr *E);
Chris Lattnere9a64532007-06-22 21:44:33 +0000291
Chris Lattner4647a212007-08-31 22:49:20 +0000292 /// EmitAnyExpr - Emit code to compute the specified expression which can have
293 /// any type. The result is returned as an RValue struct. If this is an
294 /// aggregate expression, the aggloc/agglocvolatile arguments indicate where
295 /// the result should be returned.
296 RValue EmitAnyExpr(const Expr *E, llvm::Value *AggLoc = 0,
297 bool isAggLocVolatile = false);
Devang Patel8ec4f832007-09-28 21:49:18 +0000298
Daniel Dunbar41cf9de2008-09-09 01:06:48 +0000299 /// EmitAnyExprToTemp - Similary to EmitAnyExpr(), however, the result
300 /// will always be accessible even if no aggregate location is
301 /// provided.
302 RValue EmitAnyExprToTemp(const Expr *E, llvm::Value *AggLoc = 0,
303 bool isAggLocVolatile = false);
304
Daniel Dunbar0bc8e862008-09-09 20:49:46 +0000305 void EmitAggregateCopy(llvm::Value *DestPtr, llvm::Value *SrcPtr,
306 QualType EltTy);
307
308 void EmitAggregateClear(llvm::Value *DestPtr, QualType Ty);
309
Devang Patelda5d6bb2007-10-04 23:45:31 +0000310 /// StartBlock - Start new block named N. If insert block is a dummy block
311 /// then reuse it.
312 void StartBlock(const char *N);
313
Devang Patele11664a2007-11-01 19:11:01 +0000314 /// getCGRecordLayout - Return record layout info.
315 const CGRecordLayout *getCGRecordLayout(CodeGenTypes &CGT, QualType RTy);
Lauro Ramos Venancio01a72ff2008-02-26 21:41:45 +0000316
317 /// GetAddrOfStaticLocalVar - Return the address of a static local variable.
Steve Naroff08899ff2008-04-15 22:42:06 +0000318 llvm::Constant *GetAddrOfStaticLocalVar(const VarDecl *BVD);
Dan Gohman75d69da2008-05-22 00:50:06 +0000319
Anders Carlsson9396a892008-09-11 09:15:33 +0000320 /// GetAddrOfLocalVar - Return the address of a local variable.
321 llvm::Value *GetAddrOfLocalVar(const VarDecl *VD);
322
Dan Gohman75d69da2008-05-22 00:50:06 +0000323 /// getAccessedFieldNo - Given an encoded value and a result number, return
324 /// the input field number being accessed.
325 static unsigned getAccessedFieldNo(unsigned Idx, const llvm::Constant *Elts);
326
Daniel Dunbar88402ce2008-08-04 16:51:22 +0000327 unsigned GetIDForAddrOfLabel(const LabelStmt *L);
328
Anders Carlsson2e744e82008-08-30 19:51:14 +0000329 /// EmitMemSetToZero - Generate code to memset a value of the given type to 0;
330 void EmitMemSetToZero(llvm::Value *DestPtr, QualType Ty);
Anders Carlsson13abd7e2008-11-04 05:30:00 +0000331
332 // EmitVAArg - Generate code to get an argument from the passed in pointer
333 // and update it accordingly. The return value is a pointer to the argument.
334 // FIXME: We should be able to get rid of this method and use the va_arg
335 // instruction in LLVM instead once it works well enough.
336 llvm::Value *EmitVAArg(llvm::Value *VAListAddr, QualType Ty);
Anders Carlsson2e744e82008-08-30 19:51:14 +0000337
Chris Lattner8394d792007-06-05 20:53:16 +0000338 //===--------------------------------------------------------------------===//
Chris Lattner53621a52007-06-13 20:44:40 +0000339 // Declaration Emission
Chris Lattner84915fa2007-06-02 04:16:21 +0000340 //===--------------------------------------------------------------------===//
341
Chris Lattner1ad38f82007-06-09 01:20:56 +0000342 void EmitDecl(const Decl &D);
Steve Naroff08899ff2008-04-15 22:42:06 +0000343 void EmitBlockVarDecl(const VarDecl &D);
344 void EmitLocalBlockVarDecl(const VarDecl &D);
345 void EmitStaticBlockVarDecl(const VarDecl &D);
Daniel Dunbara94ecd22008-08-16 03:19:19 +0000346
347 /// EmitParmDecl - Emit a ParmVarDecl or an ImplicitParamDecl.
348 void EmitParmDecl(const VarDecl &D, llvm::Value *Arg);
Chris Lattner03df1222007-06-02 04:53:11 +0000349
Chris Lattner84915fa2007-06-02 04:16:21 +0000350 //===--------------------------------------------------------------------===//
Chris Lattner308f4312007-05-29 23:50:05 +0000351 // Statement Emission
352 //===--------------------------------------------------------------------===//
353
Daniel Dunbar5fc28712008-11-12 08:21:33 +0000354 /// EmitStopPoint - Emit a debug stoppoint if we are emitting debug
355 /// info.
356 void EmitStopPoint(const Stmt *S);
357
Daniel Dunbar5c7e3932008-11-11 23:11:34 +0000358 /// EmitStmt - Emit the code for the statement \arg S. It is legal
359 /// to call this function even if there is no current insertion
360 /// point.
361 ///
362 /// This function may clear the current insertion point; callers
363 /// should use EnsureInsertPoint if they wish to subsequently
364 /// generate code without first calling EmitBlock, EmitBranch, or
365 /// EmitStmt.
Chris Lattner308f4312007-05-29 23:50:05 +0000366 void EmitStmt(const Stmt *S);
Daniel Dunbar5c7e3932008-11-11 23:11:34 +0000367
Daniel Dunbar5fc28712008-11-12 08:21:33 +0000368 /// EmitSimpleStmt - Try to emit a "simple" statement which does not
369 /// necessarily require an insertion point or debug information;
370 /// typically because the statement amounts to a jump or a container
371 /// of other statements.
372 ///
373 /// \return True if the statement was handled.
374 bool EmitSimpleStmt(const Stmt *S);
375
Chris Lattner4647a212007-08-31 22:49:20 +0000376 RValue EmitCompoundStmt(const CompoundStmt &S, bool GetLast = false,
377 llvm::Value *AggLoc = 0, bool isAggVol = false);
Daniel Dunbar5c7e3932008-11-11 23:11:34 +0000378
379 /// EmitLabel - Emit the block for the given label. It is legal
380 /// to call this function even if there is no current insertion
381 /// point.
Chris Lattner7e800972008-07-26 20:23:23 +0000382 void EmitLabel(const LabelStmt &S); // helper for EmitLabelStmt.
Daniel Dunbar5c7e3932008-11-11 23:11:34 +0000383
Chris Lattnerac248202007-05-30 00:13:02 +0000384 void EmitLabelStmt(const LabelStmt &S);
385 void EmitGotoStmt(const GotoStmt &S);
Daniel Dunbar88402ce2008-08-04 16:51:22 +0000386 void EmitIndirectGotoStmt(const IndirectGotoStmt &S);
Chris Lattner5269c032007-05-30 21:03:58 +0000387 void EmitIfStmt(const IfStmt &S);
Chris Lattner946aa312007-06-05 03:59:43 +0000388 void EmitWhileStmt(const WhileStmt &S);
Chris Lattner8394d792007-06-05 20:53:16 +0000389 void EmitDoStmt(const DoStmt &S);
390 void EmitForStmt(const ForStmt &S);
Chris Lattner3f3dbee2007-06-02 03:19:07 +0000391 void EmitReturnStmt(const ReturnStmt &S);
Chris Lattner1ad38f82007-06-09 01:20:56 +0000392 void EmitDeclStmt(const DeclStmt &S);
Daniel Dunbar5fc28712008-11-12 08:21:33 +0000393 void EmitBreakStmt(const BreakStmt &S);
394 void EmitContinueStmt(const ContinueStmt &S);
Devang Patelda5d6bb2007-10-04 23:45:31 +0000395 void EmitSwitchStmt(const SwitchStmt &S);
396 void EmitDefaultStmt(const DefaultStmt &S);
397 void EmitCaseStmt(const CaseStmt &S);
Devang Patel11663122007-10-08 20:57:48 +0000398 void EmitCaseStmtRange(const CaseStmt &S);
Anders Carlsson952a9952008-02-05 16:35:33 +0000399 void EmitAsmStmt(const AsmStmt &S);
400
Anders Carlsson2e744e82008-08-30 19:51:14 +0000401 void EmitObjCForCollectionStmt(const ObjCForCollectionStmt &S);
Anders Carlsson1963b0c2008-09-09 10:04:29 +0000402 void EmitObjCAtTryStmt(const ObjCAtTryStmt &S);
403 void EmitObjCAtThrowStmt(const ObjCAtThrowStmt &S);
Chris Lattnere132e242008-11-15 21:26:17 +0000404 void EmitObjCAtSynchronizedStmt(const ObjCAtSynchronizedStmt &S);
Anders Carlsson2e744e82008-08-30 19:51:14 +0000405
Chris Lattner208ae962007-05-30 17:57:17 +0000406 //===--------------------------------------------------------------------===//
Chris Lattnerd7f58862007-06-02 05:24:33 +0000407 // LValue Expression Emission
408 //===--------------------------------------------------------------------===//
Chris Lattner8394d792007-06-05 20:53:16 +0000409
Daniel Dunbarf2e69882008-08-25 20:45:57 +0000410 /// EmitUnsupportedLValue - Emit a dummy l-value using the type of E
411 /// and issue an ErrorUnsupported style diagnostic (using the
412 /// provided Name).
413 LValue EmitUnsupportedLValue(const Expr *E,
414 const char *Name);
415
Chris Lattner8394d792007-06-05 20:53:16 +0000416 /// EmitLValue - Emit code to compute a designator that specifies the location
417 /// of the expression.
418 ///
419 /// This can return one of two things: a simple address or a bitfield
420 /// reference. In either case, the LLVM Value* in the LValue structure is
421 /// guaranteed to be an LLVM pointer type.
422 ///
423 /// If this returns a bitfield reference, nothing about the pointee type of
424 /// the LLVM value is known: For example, it may not be a pointer to an
425 /// integer.
426 ///
427 /// If this returns a normal address, and if the lvalue's C type is fixed
428 /// size, this method guarantees that the returned pointer type will point to
429 /// an LLVM type of the same size of the lvalue's type. If the lvalue has a
430 /// variable length type, this is not possible.
431 ///
Chris Lattnerd7f58862007-06-02 05:24:33 +0000432 LValue EmitLValue(const Expr *E);
Chris Lattner8394d792007-06-05 20:53:16 +0000433
434 /// EmitLoadOfLValue - Given an expression that represents a value lvalue,
435 /// this method emits the address of the lvalue, then loads the result as an
436 /// rvalue, returning the rvalue.
Chris Lattner9369a562007-06-29 16:31:29 +0000437 RValue EmitLoadOfLValue(LValue V, QualType LVType);
Nate Begemance4d7fc2008-04-18 23:10:10 +0000438 RValue EmitLoadOfExtVectorElementLValue(LValue V, QualType LVType);
Lauro Ramos Venancio2ddcb25a32008-01-22 20:17:04 +0000439 RValue EmitLoadOfBitfieldLValue(LValue LV, QualType ExprType);
Daniel Dunbar9e22c0d2008-08-29 08:11:39 +0000440 RValue EmitLoadOfPropertyRefLValue(LValue LV, QualType ExprType);
Chris Lattner9369a562007-06-29 16:31:29 +0000441
Chris Lattner40ff7012007-08-03 16:18:34 +0000442
Chris Lattner8394d792007-06-05 20:53:16 +0000443 /// EmitStoreThroughLValue - Store the specified rvalue into the specified
444 /// lvalue, where both are guaranteed to the have the same type, and that type
445 /// is 'Ty'.
446 void EmitStoreThroughLValue(RValue Src, LValue Dst, QualType Ty);
Nate Begemance4d7fc2008-04-18 23:10:10 +0000447 void EmitStoreThroughExtVectorComponentLValue(RValue Src, LValue Dst,
448 QualType Ty);
Lauro Ramos Venancio09af71c2008-01-22 22:36:45 +0000449 void EmitStoreThroughBitfieldLValue(RValue Src, LValue Dst, QualType Ty);
Daniel Dunbar9e22c0d2008-08-29 08:11:39 +0000450 void EmitStoreThroughPropertyRefLValue(RValue Src, LValue Dst, QualType Ty);
Christopher Lambd91c3d42007-12-29 05:02:41 +0000451
452 // Note: only availabe for agg return types
Daniel Dunbar8cde00a2008-09-04 03:20:13 +0000453 LValue EmitBinaryOperatorLValue(const BinaryOperator *E);
454 // Note: only availabe for agg return types
Christopher Lambd91c3d42007-12-29 05:02:41 +0000455 LValue EmitCallExprLValue(const CallExpr *E);
Chris Lattner8394d792007-06-05 20:53:16 +0000456
Chris Lattnerd7f58862007-06-02 05:24:33 +0000457 LValue EmitDeclRefLValue(const DeclRefExpr *E);
Chris Lattner4347e3692007-06-06 04:54:52 +0000458 LValue EmitStringLiteralLValue(const StringLiteral *E);
Daniel Dunbarb3517472008-10-17 21:58:32 +0000459 LValue EmitPredefinedFunctionName(unsigned Type);
Chris Lattner6307f192008-08-10 01:53:14 +0000460 LValue EmitPredefinedLValue(const PredefinedExpr *E);
Chris Lattner8394d792007-06-05 20:53:16 +0000461 LValue EmitUnaryOpLValue(const UnaryOperator *E);
Chris Lattnerd9d2fb12007-06-08 23:31:14 +0000462 LValue EmitArraySubscriptExpr(const ArraySubscriptExpr *E);
Nate Begemance4d7fc2008-04-18 23:10:10 +0000463 LValue EmitExtVectorElementExpr(const ExtVectorElementExpr *E);
Devang Patel3e11cce2007-10-23 02:10:49 +0000464 LValue EmitMemberExpr(const MemberExpr *E);
Eli Friedman9fd8b682008-05-13 23:18:27 +0000465 LValue EmitCompoundLiteralLValue(const CompoundLiteralExpr *E);
Eli Friedmana62f3e12008-02-09 08:50:58 +0000466
Daniel Dunbar1c64e5d2008-09-24 04:00:38 +0000467 llvm::Value *EmitIvarOffset(ObjCInterfaceDecl *Interface,
468 const ObjCIvarDecl *Ivar);
Eli Friedmana62f3e12008-02-09 08:50:58 +0000469 LValue EmitLValueForField(llvm::Value* Base, FieldDecl* Field,
Eli Friedman327944b2008-06-13 23:01:12 +0000470 bool isUnion, unsigned CVRQualifiers);
Daniel Dunbar1c64e5d2008-09-24 04:00:38 +0000471 LValue EmitLValueForIvar(llvm::Value* Base, const ObjCIvarDecl *Ivar,
472 unsigned CVRQualifiers);
473
Argyrios Kyrtzidis07052352008-09-10 02:36:38 +0000474 LValue EmitCXXConditionDeclLValue(const CXXConditionDeclExpr *E);
475
Daniel Dunbarc8317a42008-08-23 10:51:21 +0000476 LValue EmitObjCMessageExprLValue(const ObjCMessageExpr *E);
Chris Lattner4bd55962008-03-30 23:03:07 +0000477 LValue EmitObjCIvarRefLValue(const ObjCIvarRefExpr *E);
Daniel Dunbar9e22c0d2008-08-29 08:11:39 +0000478 LValue EmitObjCPropertyRefLValue(const ObjCPropertyRefExpr *E);
Douglas Gregor8ea1f532008-11-04 14:56:14 +0000479 LValue EmitObjCSuperExpr(const ObjCSuperExpr *E);
Daniel Dunbarc8317a42008-08-23 10:51:21 +0000480
Chris Lattnerd7f58862007-06-02 05:24:33 +0000481 //===--------------------------------------------------------------------===//
Chris Lattner6278e6a2007-08-11 00:04:45 +0000482 // Scalar Expression Emission
Chris Lattner208ae962007-05-30 17:57:17 +0000483 //===--------------------------------------------------------------------===//
484
Daniel Dunbar4b8c6db2008-08-30 05:35:15 +0000485 /// EmitCall - Generate a call of the given function, expecting the
486 /// given result type, and using the given argument list which
487 /// specifies both the LLVM arguments and the types they were
488 /// derived from.
Daniel Dunbarc722b852008-08-30 03:02:31 +0000489 RValue EmitCall(llvm::Value *Callee,
490 QualType ResultType,
491 const CallArgList &Args);
492
Chris Lattner2b228c92007-06-15 21:34:29 +0000493 RValue EmitCallExpr(const CallExpr *E);
Ted Kremenek08e17112008-06-17 02:43:46 +0000494
495 RValue EmitCallExpr(Expr *FnExpr, CallExpr::const_arg_iterator ArgBeg,
496 CallExpr::const_arg_iterator ArgEnd);
497
Eli Friedman9d92ce82008-01-30 01:32:06 +0000498 RValue EmitCallExpr(llvm::Value *Callee, QualType FnType,
Ted Kremenek08e17112008-06-17 02:43:46 +0000499 CallExpr::const_arg_iterator ArgBeg,
500 CallExpr::const_arg_iterator ArgEnd);
501
Chris Lattner6c555f92007-08-26 22:58:05 +0000502 RValue EmitBuiltinExpr(unsigned BuiltinID, const CallExpr *E);
Chris Lattner8394d792007-06-05 20:53:16 +0000503
Daniel Dunbareca513d2008-10-10 00:24:54 +0000504 /// EmitTargetBuiltinExpr - Emit the given builtin call. Returns 0
505 /// if the call is unhandled by the current target.
506 llvm::Value *EmitTargetBuiltinExpr(unsigned BuiltinID, const CallExpr *E);
507
Anders Carlsson895af082007-12-09 23:17:02 +0000508 llvm::Value *EmitX86BuiltinExpr(unsigned BuiltinID, const CallExpr *E);
509 llvm::Value *EmitPPCBuiltinExpr(unsigned BuiltinID, const CallExpr *E);
510
Anders Carlssonb9eb82c2007-12-10 19:35:18 +0000511 llvm::Value *EmitShuffleVector(llvm::Value* V1, llvm::Value *V2, ...);
Nate Begeman330aaa72007-12-30 02:59:45 +0000512 llvm::Value *EmitVector(llvm::Value * const *Vals, unsigned NumVals,
513 bool isSplat = false);
Anders Carlssonf5f65442007-12-15 21:23:30 +0000514
Daniel Dunbar66912a12008-08-20 00:28:19 +0000515 llvm::Value *EmitObjCProtocolExpr(const ObjCProtocolExpr *E);
Chris Lattner2da04b32007-08-24 05:35:26 +0000516 llvm::Value *EmitObjCStringLiteral(const ObjCStringLiteral *E);
Chris Lattnerb1d329d2008-06-24 17:04:18 +0000517 llvm::Value *EmitObjCSelectorExpr(const ObjCSelectorExpr *E);
Daniel Dunbar97db84c2008-08-23 03:46:30 +0000518 RValue EmitObjCMessageExpr(const ObjCMessageExpr *E);
Daniel Dunbar55310df2008-08-27 06:57:25 +0000519 RValue EmitObjCPropertyGet(const ObjCPropertyRefExpr *E);
Daniel Dunbar9e22c0d2008-08-29 08:11:39 +0000520 void EmitObjCPropertySet(const ObjCPropertyRefExpr *E, RValue Src);
Chris Lattnerb1d329d2008-06-24 17:04:18 +0000521
522
Chris Lattner6278e6a2007-08-11 00:04:45 +0000523 //===--------------------------------------------------------------------===//
Chris Lattnerbda69f82007-08-26 23:13:56 +0000524 // Expression Emission
Chris Lattner6278e6a2007-08-11 00:04:45 +0000525 //===--------------------------------------------------------------------===//
Chris Lattnerbda69f82007-08-26 23:13:56 +0000526
527 // Expressions are broken into three classes: scalar, complex, aggregate.
Chris Lattner6278e6a2007-08-11 00:04:45 +0000528
Chris Lattner2da04b32007-08-24 05:35:26 +0000529 /// EmitScalarExpr - Emit the computation of the specified expression of
530 /// LLVM scalar type, returning the result.
531 llvm::Value *EmitScalarExpr(const Expr *E);
532
Chris Lattner3474c202007-08-26 06:48:56 +0000533 /// EmitScalarConversion - Emit a conversion from the specified type to the
534 /// specified destination type, both of which are LLVM scalar types.
535 llvm::Value *EmitScalarConversion(llvm::Value *Src, QualType SrcTy,
536 QualType DstTy);
537
Chris Lattner42e6b812007-08-26 16:34:22 +0000538 /// EmitComplexToScalarConversion - Emit a conversion from the specified
539 /// complex type to the specified destination type, where the destination
540 /// type is an LLVM scalar type.
541 llvm::Value *EmitComplexToScalarConversion(ComplexPairTy Src, QualType SrcTy,
542 QualType DstTy);
543
Chris Lattner3474c202007-08-26 06:48:56 +0000544
Chris Lattner6278e6a2007-08-11 00:04:45 +0000545 /// EmitAggExpr - Emit the computation of the specified expression of
546 /// aggregate type. The result is computed into DestPtr. Note that if
547 /// DestPtr is null, the value of the aggregate expression is not needed.
548 void EmitAggExpr(const Expr *E, llvm::Value *DestPtr, bool VolatileDest);
Chris Lattnercbfc73b2007-08-21 05:54:00 +0000549
550 /// EmitComplexExpr - Emit the computation of the specified expression of
Chris Lattner08b15df2007-08-23 23:43:33 +0000551 /// complex type, returning the result.
Chris Lattner96d72562007-08-21 16:57:55 +0000552 ComplexPairTy EmitComplexExpr(const Expr *E);
Chris Lattner08b15df2007-08-23 23:43:33 +0000553
554 /// EmitComplexExprIntoAddr - Emit the computation of the specified expression
555 /// of complex type, storing into the specified Value*.
Chris Lattnerb84bb952007-08-26 16:22:13 +0000556 void EmitComplexExprIntoAddr(const Expr *E, llvm::Value *DestAddr,
557 bool DestIsVolatile);
Daniel Dunbar4b8c6db2008-08-30 05:35:15 +0000558
559 /// StoreComplexToAddr - Store a complex number into the specified address.
560 void StoreComplexToAddr(ComplexPairTy V, llvm::Value *DestAddr,
561 bool DestIsVolatile);
Chris Lattner4647a212007-08-31 22:49:20 +0000562 /// LoadComplexFromAddr - Load a complex number from the specified address.
563 ComplexPairTy LoadComplexFromAddr(llvm::Value *SrcAddr, bool SrcIsVolatile);
Chris Lattnerb781dc792008-05-08 05:58:21 +0000564
565 /// GenerateStaticBlockVarDecl - return the the static
566 /// declaration of local variable.
567 llvm::GlobalValue *GenerateStaticBlockVarDecl(const VarDecl &D,
568 bool NoInit,
569 const char *Separator);
Daniel Dunbar88402ce2008-08-04 16:51:22 +0000570
Anders Carlsson87fc5a52008-08-22 16:00:37 +0000571 // GenerateStaticBlockVarDecl - return the static declaration of
572 // a local variable. Performs initialization of the variable if necessary.
573 llvm::GlobalValue *GenerateStaticCXXBlockVarDecl(const VarDecl &D);
574
Daniel Dunbar88402ce2008-08-04 16:51:22 +0000575 //===--------------------------------------------------------------------===//
576 // Internal Helpers
577 //===--------------------------------------------------------------------===//
578
Chris Lattner5b1964b2008-11-11 07:41:27 +0000579 /// ContainsLabel - Return true if the statement contains a label in it. If
580 /// this statement is not executed normally, it not containing a label means
581 /// that we can just remove the code.
582 static bool ContainsLabel(const Stmt *S, bool IgnoreCaseStmts = false);
583
Daniel Dunbar682712c2008-11-12 10:12:14 +0000584 /// ConstantFoldsToSimpleInteger - If the specified expression does not fold
Chris Lattnercd439292008-11-12 08:04:58 +0000585 /// to a constant, or if it does but contains a label, return 0. If it
586 /// constant folds to 'true' and does not contain a label, return 1, if it
587 /// constant folds to 'false' and does not contain a label, return -1.
588 int ConstantFoldsToSimpleInteger(const Expr *Cond);
589
590 /// EmitBranchOnBoolExpr - Emit a branch on a boolean condition (e.g. for an
591 /// if statement) to the specified blocks. Based on the condition, this might
592 /// try to simplify the codegen of the conditional based on the branch.
593 ///
Chris Lattnerb7a9e162008-11-12 07:46:33 +0000594 void EmitBranchOnBoolExpr(const Expr *Cond, llvm::BasicBlock *TrueBlock,
Daniel Dunbar682712c2008-11-12 10:12:14 +0000595 llvm::BasicBlock *FalseBlock);
Chris Lattnercd439292008-11-12 08:04:58 +0000596private:
Chris Lattner5b1964b2008-11-11 07:41:27 +0000597
Daniel Dunbar88402ce2008-08-04 16:51:22 +0000598 /// EmitIndirectSwitches - Emit code for all of the switch
599 /// instructions in IndirectSwitches.
600 void EmitIndirectSwitches();
Daniel Dunbar8fc81b02008-09-17 00:51:38 +0000601
Daniel Dunbar1c64e5d2008-09-24 04:00:38 +0000602 void EmitReturnOfRValue(RValue RV, QualType Ty);
603
Daniel Dunbar8fc81b02008-09-17 00:51:38 +0000604 /// ExpandTypeFromArgs - Reconstruct a structure of type \arg Ty
605 /// from function arguments into \arg Dst. See ABIArgInfo::Expand.
606 ///
607 /// \param AI - The first function argument of the expansion.
608 /// \return The argument following the last expanded function
609 /// argument.
610 llvm::Function::arg_iterator
611 ExpandTypeFromArgs(QualType Ty, LValue Dst,
612 llvm::Function::arg_iterator AI);
613
614 /// ExpandTypeToArgs - Expand an RValue \arg Src, with the LLVM type
615 /// for \arg Ty, into individual arguments on the provided vector
616 /// \arg Args. See ABIArgInfo::Expand.
617 void ExpandTypeToArgs(QualType Ty, RValue Src,
618 llvm::SmallVector<llvm::Value*, 16> &Args);
Chris Lattnerbed31442007-05-28 01:07:47 +0000619};
620} // end namespace CodeGen
621} // end namespace clang
Chris Lattnerbed31442007-05-28 01:07:47 +0000622
623#endif