blob: 82ac86aaa359e11bf0fa18e7b247550f97fa176b [file] [log] [blame]
Anders Carlssond2a889b2009-02-12 00:39:25 +00001//===--- CGBlocks.cpp - Emit LLVM Code for declarations -------------------===//
2//
3// The LLVM Compiler Infrastructure
4//
5// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
7//
8//===----------------------------------------------------------------------===//
9//
10// This contains code to emit blocks.
11//
12//===----------------------------------------------------------------------===//
13
14#include "CodeGenFunction.h"
15#include "CodeGenModule.h"
16#include "llvm/Module.h"
Anders Carlsson1f1cd392009-02-12 17:55:02 +000017#include "llvm/Target/TargetData.h"
Anders Carlssond2a889b2009-02-12 00:39:25 +000018
19#include <algorithm>
20
21using namespace clang;
22using namespace CodeGen;
23
Mike Stumpb3a6fac2009-03-04 13:17:22 +000024// Temporary code to enable testing of __block variables
25// #include "clang/Frontend/CompileOptions.h"
26#include "llvm/Support/CommandLine.h"
27static llvm::cl::opt<bool>
28Enable__block("f__block",
29 // See all the FIXMEs for the various work that needs to be done
30 llvm::cl::desc("temporary option to turn on __block precessing "
31 "even though the code isn't done yet"),
32 llvm::cl::ValueDisallowed, llvm::cl::AllowInverse,
Mike Stump1bdbf632009-03-05 08:32:30 +000033 llvm::cl::ZeroOrMore,
34 llvm::cl::init(false));
Mike Stumpb3a6fac2009-03-04 13:17:22 +000035
Mike Stumpfca5da02009-02-21 20:00:35 +000036llvm::Constant *CodeGenFunction::BuildDescriptorBlockDecl(uint64_t Size) {
Mike Stumpff8f0872009-02-13 16:55:51 +000037 const llvm::Type *UnsignedLongTy
38 = CGM.getTypes().ConvertType(getContext().UnsignedLongTy);
Mike Stumpb95bc002009-02-13 16:19:19 +000039 llvm::Constant *C;
40 std::vector<llvm::Constant*> Elts;
41
42 // reserved
Mike Stumpff8f0872009-02-13 16:55:51 +000043 C = llvm::ConstantInt::get(UnsignedLongTy, 0);
Mike Stumpb95bc002009-02-13 16:19:19 +000044 Elts.push_back(C);
45
46 // Size
Mike Stump139c3962009-02-21 20:07:44 +000047 // FIXME: What is the right way to say this doesn't fit? We should give
48 // a user diagnostic in that case. Better fix would be to change the
49 // API to size_t.
Mike Stumpfca5da02009-02-21 20:00:35 +000050 C = llvm::ConstantInt::get(UnsignedLongTy, Size);
Mike Stumpb95bc002009-02-13 16:19:19 +000051 Elts.push_back(C);
52
53 if (BlockHasCopyDispose) {
54 // copy_func_helper_decl
Mike Stumpfca5da02009-02-21 20:00:35 +000055 // FIXME: implement
Mike Stump1bdbf632009-03-05 08:32:30 +000056 C = llvm::Constant::getNullValue(PtrToInt8Ty);
Mike Stumpb95bc002009-02-13 16:19:19 +000057 C = llvm::ConstantExpr::getBitCast(C, PtrToInt8Ty);
58 Elts.push_back(C);
59
60 // destroy_func_decl
Mike Stumpfca5da02009-02-21 20:00:35 +000061 // FIXME: implement
Mike Stump1bdbf632009-03-05 08:32:30 +000062 C = llvm::Constant::getNullValue(PtrToInt8Ty);
Mike Stumpb95bc002009-02-13 16:19:19 +000063 C = llvm::ConstantExpr::getBitCast(C, PtrToInt8Ty);
64 Elts.push_back(C);
65 }
66
67 C = llvm::ConstantStruct::get(Elts);
68
Mike Stumpb95bc002009-02-13 16:19:19 +000069 C = new llvm::GlobalVariable(C->getType(), true,
70 llvm::GlobalValue::InternalLinkage,
Mike Stump92ea8882009-02-13 20:17:16 +000071 C, "__block_descriptor_tmp", &CGM.getModule());
Mike Stumpb95bc002009-02-13 16:19:19 +000072 return C;
73}
74
Mike Stump1f010b52009-03-04 18:17:45 +000075llvm::Constant *BlockModule::getNSConcreteGlobalBlock() {
Mike Stump5f87e9d2009-02-13 17:23:42 +000076 if (NSConcreteGlobalBlock)
77 return NSConcreteGlobalBlock;
78
Mike Stump56447902009-02-13 19:38:12 +000079 // FIXME: We should have a CodeGenModule::AddRuntimeVariable that does the
Mike Stumpf13eac12009-03-04 22:48:06 +000080 // same thing as CreateRuntimeFunction if there's already a variable with the
81 // same name.
Mike Stump5f87e9d2009-02-13 17:23:42 +000082 NSConcreteGlobalBlock
Mike Stump1bdbf632009-03-05 08:32:30 +000083 = new llvm::GlobalVariable(PtrToInt8Ty, false,
Mike Stump5f87e9d2009-02-13 17:23:42 +000084 llvm::GlobalValue::ExternalLinkage,
85 0, "_NSConcreteGlobalBlock",
86 &getModule());
87
88 return NSConcreteGlobalBlock;
89}
90
Mike Stump1f010b52009-03-04 18:17:45 +000091llvm::Constant *BlockModule::getNSConcreteStackBlock() {
Mike Stumpeb3a5ca2009-02-13 19:29:27 +000092 if (NSConcreteStackBlock)
93 return NSConcreteStackBlock;
94
Mike Stump56447902009-02-13 19:38:12 +000095 // FIXME: We should have a CodeGenModule::AddRuntimeVariable that does the
Mike Stumpf13eac12009-03-04 22:48:06 +000096 // same thing as CreateRuntimeFunction if there's already a variable with the
97 // same name.
Mike Stumpeb3a5ca2009-02-13 19:29:27 +000098 NSConcreteStackBlock
Mike Stump1bdbf632009-03-05 08:32:30 +000099 = new llvm::GlobalVariable(PtrToInt8Ty, false,
Mike Stumpeb3a5ca2009-02-13 19:29:27 +0000100 llvm::GlobalValue::ExternalLinkage,
101 0, "_NSConcreteStackBlock",
102 &getModule());
103
104 return NSConcreteStackBlock;
105}
106
Mike Stump1bdbf632009-03-05 08:32:30 +0000107static void CollectBlockDeclRefInfo(const Stmt *S,
Anders Carlsson6cf64be2009-03-01 01:09:12 +0000108 CodeGenFunction::BlockInfo &Info) {
109 for (Stmt::const_child_iterator I = S->child_begin(), E = S->child_end();
110 I != E; ++I)
Daniel Dunbar56941d32009-03-02 07:00:57 +0000111 if (*I)
112 CollectBlockDeclRefInfo(*I, Info);
Mike Stump1bdbf632009-03-05 08:32:30 +0000113
Anders Carlsson6cf64be2009-03-01 01:09:12 +0000114 if (const BlockDeclRefExpr *DE = dyn_cast<BlockDeclRefExpr>(S)) {
115 // FIXME: Handle enums.
116 if (isa<FunctionDecl>(DE->getDecl()))
117 return;
Mike Stump1bdbf632009-03-05 08:32:30 +0000118
Anders Carlsson6cf64be2009-03-01 01:09:12 +0000119 if (DE->isByRef())
120 Info.ByRefDeclRefs.push_back(DE);
121 else
122 Info.ByCopyDeclRefs.push_back(DE);
123 }
124}
125
Mike Stumpf13eac12009-03-04 22:48:06 +0000126/// CanBlockBeGlobal - Given a BlockInfo struct, determines if a block can be
127/// declared as a global variable instead of on the stack.
Anders Carlsson6cf64be2009-03-01 01:09:12 +0000128static bool CanBlockBeGlobal(const CodeGenFunction::BlockInfo &Info)
129{
130 return Info.ByRefDeclRefs.empty() && Info.ByCopyDeclRefs.empty();
131}
132
Mike Stumpf13eac12009-03-04 22:48:06 +0000133// FIXME: Push most into CGM, passing down a few bits, like current function
134// name.
Mike Stumpf1711822009-02-25 23:33:13 +0000135llvm::Value *CodeGenFunction::BuildBlockLiteralTmp(const BlockExpr *BE) {
Mike Stumpb95bc002009-02-13 16:19:19 +0000136
Anders Carlsson6cf64be2009-03-01 01:09:12 +0000137 std::string Name = CurFn->getName();
138 CodeGenFunction::BlockInfo Info(0, Name.c_str());
139 CollectBlockDeclRefInfo(BE->getBody(), Info);
140
141 // Check if the block can be global.
Mike Stumpf13eac12009-03-04 22:48:06 +0000142 // FIXME: This test doesn't work for nested blocks yet. Longer term, I'd like
143 // to just have one code path. We should move this function into CGM and pass
144 // CGF, then we can just check to see if CGF is 0.
Mike Stumpad9605d2009-03-04 03:23:46 +0000145 if (0 && CanBlockBeGlobal(Info))
Anders Carlsson6cf64be2009-03-01 01:09:12 +0000146 return CGM.GetAddrOfGlobalBlock(BE, Name.c_str());
Mike Stump1bdbf632009-03-05 08:32:30 +0000147
148 std::vector<llvm::Constant*> Elts(5);
Mike Stumpb95bc002009-02-13 16:19:19 +0000149 llvm::Constant *C;
Mike Stumpf1711822009-02-25 23:33:13 +0000150 llvm::Value *V;
Mike Stumpb95bc002009-02-13 16:19:19 +0000151
Mike Stumpb95bc002009-02-13 16:19:19 +0000152 {
153 // C = BuildBlockStructInitlist();
154 unsigned int flags = BLOCK_HAS_DESCRIPTOR;
155
Mike Stump1bdbf632009-03-05 08:32:30 +0000156 // We run this first so that we set BlockHasCopyDispose from the entire
157 // block literal.
158 // __invoke
159 uint64_t subBlockSize, subBlockAlign;
160 llvm::SmallVector<const Expr *, 8> subBlockDeclRefDecls;
161 llvm::Function *Fn
162 = CodeGenFunction(CGM).GenerateBlockFunction(BE, Info, subBlockSize,
163 subBlockAlign,
164 subBlockDeclRefDecls,
165 BlockHasCopyDispose);
166 Elts[3] = Fn;
167
168 if (!Enable__block && BlockHasCopyDispose)
169 ErrorUnsupported(BE, "block literal that requires copy/dispose");
170
Mike Stumpb95bc002009-02-13 16:19:19 +0000171 if (BlockHasCopyDispose)
172 flags |= BLOCK_HAS_COPY_DISPOSE;
173
Mike Stump92ea8882009-02-13 20:17:16 +0000174 // __isa
Mike Stumpeb3a5ca2009-02-13 19:29:27 +0000175 C = CGM.getNSConcreteStackBlock();
Mike Stumpb95bc002009-02-13 16:19:19 +0000176 C = llvm::ConstantExpr::getBitCast(C, PtrToInt8Ty);
Mike Stump1bdbf632009-03-05 08:32:30 +0000177 Elts[0] = C;
Mike Stumpb95bc002009-02-13 16:19:19 +0000178
179 // __flags
180 const llvm::IntegerType *IntTy = cast<llvm::IntegerType>(
181 CGM.getTypes().ConvertType(CGM.getContext().IntTy));
182 C = llvm::ConstantInt::get(IntTy, flags);
Mike Stump1bdbf632009-03-05 08:32:30 +0000183 Elts[1] = C;
Mike Stumpb95bc002009-02-13 16:19:19 +0000184
185 // __reserved
186 C = llvm::ConstantInt::get(IntTy, 0);
Mike Stump1bdbf632009-03-05 08:32:30 +0000187 Elts[2] = C;
Mike Stumpb95bc002009-02-13 16:19:19 +0000188
189 // __descriptor
Mike Stump1bdbf632009-03-05 08:32:30 +0000190 Elts[4] = BuildDescriptorBlockDecl(subBlockSize);
Mike Stumpb95bc002009-02-13 16:19:19 +0000191
Mike Stumpf1711822009-02-25 23:33:13 +0000192 if (subBlockDeclRefDecls.size() == 0) {
Mike Stumpa7db9be2009-03-01 20:07:53 +0000193 // Optimize to being a global block.
194 Elts[0] = CGM.getNSConcreteGlobalBlock();
195 Elts[1] = llvm::ConstantInt::get(IntTy, flags|BLOCK_IS_GLOBAL);
196
Mike Stumpf1711822009-02-25 23:33:13 +0000197 C = llvm::ConstantStruct::get(Elts);
198
199 char Name[32];
200 sprintf(Name, "__block_holder_tmp_%d", CGM.getGlobalUniqueCount());
201 C = new llvm::GlobalVariable(C->getType(), true,
202 llvm::GlobalValue::InternalLinkage,
203 C, Name, &CGM.getModule());
204 QualType BPT = BE->getType();
205 C = llvm::ConstantExpr::getBitCast(C, ConvertType(BPT));
206 return C;
207 }
Mike Stump1bdbf632009-03-05 08:32:30 +0000208
Mike Stumpf1711822009-02-25 23:33:13 +0000209 std::vector<const llvm::Type *> Types(5+subBlockDeclRefDecls.size());
210 for (int i=0; i<5; ++i)
211 Types[i] = Elts[i]->getType();
212
Mike Stump2b6933f2009-02-28 09:07:16 +0000213 for (unsigned i=0; i < subBlockDeclRefDecls.size(); ++i) {
214 const Expr *E = subBlockDeclRefDecls[i];
215 const BlockDeclRefExpr *BDRE = dyn_cast<BlockDeclRefExpr>(E);
216 QualType Ty = E->getType();
Mike Stumpad9605d2009-03-04 03:23:46 +0000217 if (BDRE && BDRE->isByRef()) {
218 uint64_t Align = getContext().getDeclAlignInBytes(BDRE->getDecl());
219 Types[i+5] = llvm::PointerType::get(BuildByRefType(Ty, Align), 0);
220 } else
221 Types[i+5] = ConvertType(Ty);
Mike Stump2b6933f2009-02-28 09:07:16 +0000222 }
Mike Stumpf1711822009-02-25 23:33:13 +0000223
224 llvm::Type *Ty = llvm::StructType::get(Types, true);
225
226 llvm::AllocaInst *A = CreateTempAlloca(Ty);
227 A->setAlignment(subBlockAlign);
228 V = A;
229
230 for (unsigned i=0; i<5; ++i)
231 Builder.CreateStore(Elts[i], Builder.CreateStructGEP(V, i, "block.tmp"));
Mike Stump1bdbf632009-03-05 08:32:30 +0000232
Mike Stumpf1711822009-02-25 23:33:13 +0000233 for (unsigned i=0; i < subBlockDeclRefDecls.size(); ++i)
234 {
Mike Stump2b6933f2009-02-28 09:07:16 +0000235 // FIXME: Push const down.
236 Expr *E = const_cast<Expr*>(subBlockDeclRefDecls[i]);
237 DeclRefExpr *DR;
238 ValueDecl *VD;
Mike Stumpf1711822009-02-25 23:33:13 +0000239
Mike Stump2b6933f2009-02-28 09:07:16 +0000240 DR = dyn_cast<DeclRefExpr>(E);
241 // Skip padding.
242 if (DR) continue;
243
244 BlockDeclRefExpr *BDRE = dyn_cast<BlockDeclRefExpr>(E);
245 VD = BDRE->getDecl();
246
Mike Stumpad9605d2009-03-04 03:23:46 +0000247 llvm::Value* Addr = Builder.CreateStructGEP(V, i+5, "tmp");
Mike Stump2b6933f2009-02-28 09:07:16 +0000248 // FIXME: I want a better way to do this.
249 if (LocalDeclMap[VD]) {
Mike Stumpad9605d2009-03-04 03:23:46 +0000250 if (BDRE->isByRef()) {
251 const llvm::Type *Ty = Types[i+5];
252 llvm::Value *Loc = LocalDeclMap[VD];
253 Loc = Builder.CreateStructGEP(Loc, 1, "forwarding");
254 Loc = Builder.CreateLoad(Loc, false);
255 Loc = Builder.CreateBitCast(Loc, Ty);
256 Builder.CreateStore(Loc, Addr);
257 continue;
258 } else
259 E = new (getContext()) DeclRefExpr (cast<NamedDecl>(VD),
260 VD->getType(), SourceLocation(),
261 false, false);
Mike Stump2b6933f2009-02-28 09:07:16 +0000262 }
Mike Stumpad9605d2009-03-04 03:23:46 +0000263 if (BDRE->isByRef()) {
Mike Stump2b6933f2009-02-28 09:07:16 +0000264 E = new (getContext())
265 UnaryOperator(E, UnaryOperator::AddrOf,
266 getContext().getPointerType(E->getType()),
267 SourceLocation());
Mike Stumpad9605d2009-03-04 03:23:46 +0000268 }
Mike Stump2b6933f2009-02-28 09:07:16 +0000269
Mike Stump2b6933f2009-02-28 09:07:16 +0000270 RValue r = EmitAnyExpr(E, Addr, false);
Mike Stumpad9605d2009-03-04 03:23:46 +0000271 if (r.isScalar()) {
272 llvm::Value *Loc = r.getScalarVal();
273 const llvm::Type *Ty = Types[i+5];
274 if (BDRE->isByRef()) {
Mike Stumpf13eac12009-03-04 22:48:06 +0000275 // E is now the address of the value field, instead, we want the
276 // address of the actual ByRef struct. We optimize this slightly
277 // compared to gcc by not grabbing the forwarding slot as this must
278 // be done during Block_copy for us, and we can postpone the work
279 // until then.
280 uint64_t offset = BlockDecls[BDRE->getDecl()];
Mike Stump1bdbf632009-03-05 08:32:30 +0000281
Mike Stumpf13eac12009-03-04 22:48:06 +0000282 llvm::Value *BlockLiteral = LoadBlockStruct();
Mike Stump1bdbf632009-03-05 08:32:30 +0000283
Mike Stumpf13eac12009-03-04 22:48:06 +0000284 Loc = Builder.CreateGEP(BlockLiteral,
285 llvm::ConstantInt::get(llvm::Type::Int64Ty,
286 offset),
287 "block.literal");
288 Ty = llvm::PointerType::get(Ty, 0);
Mike Stumpad9605d2009-03-04 03:23:46 +0000289 Loc = Builder.CreateBitCast(Loc, Ty);
Mike Stumpf13eac12009-03-04 22:48:06 +0000290 Loc = Builder.CreateLoad(Loc, false);
291 // Loc = Builder.CreateBitCast(Loc, Ty);
Mike Stumpad9605d2009-03-04 03:23:46 +0000292 }
293 Builder.CreateStore(Loc, Addr);
294 } else if (r.isComplex())
Mike Stumpf1711822009-02-25 23:33:13 +0000295 // FIXME: implement
296 ErrorUnsupported(BE, "complex in block literal");
297 else if (r.isAggregate())
298 ; // Already created into the destination
299 else
300 assert (0 && "bad block variable");
301 // FIXME: Ensure that the offset created by the backend for
302 // the struct matches the previously computed offset in BlockDecls.
303 }
Mike Stumpb95bc002009-02-13 16:19:19 +0000304 }
Mike Stump1bdbf632009-03-05 08:32:30 +0000305
Mike Stumpd55240e2009-02-19 01:01:04 +0000306 QualType BPT = BE->getType();
Mike Stumpf1711822009-02-25 23:33:13 +0000307 return Builder.CreateBitCast(V, ConvertType(BPT));
Mike Stumpb95bc002009-02-13 16:19:19 +0000308}
309
310
Mike Stump1f010b52009-03-04 18:17:45 +0000311const llvm::Type *BlockModule::getBlockDescriptorType() {
Mike Stump95e54802009-02-13 15:16:56 +0000312 if (BlockDescriptorType)
313 return BlockDescriptorType;
314
Mike Stumpc4ae9632009-02-13 15:32:32 +0000315 const llvm::Type *UnsignedLongTy =
Mike Stump95e54802009-02-13 15:16:56 +0000316 getTypes().ConvertType(getContext().UnsignedLongTy);
Mike Stumpc4ae9632009-02-13 15:32:32 +0000317
Mike Stump95e54802009-02-13 15:16:56 +0000318 // struct __block_descriptor {
319 // unsigned long reserved;
320 // unsigned long block_size;
321 // };
Mike Stumpc4ae9632009-02-13 15:32:32 +0000322 BlockDescriptorType = llvm::StructType::get(UnsignedLongTy,
323 UnsignedLongTy,
Mike Stump95e54802009-02-13 15:16:56 +0000324 NULL);
325
326 getModule().addTypeName("struct.__block_descriptor",
327 BlockDescriptorType);
328
329 return BlockDescriptorType;
Anders Carlssond2a889b2009-02-12 00:39:25 +0000330}
331
Mike Stump1f010b52009-03-04 18:17:45 +0000332const llvm::Type *BlockModule::getGenericBlockLiteralType() {
Mike Stump0dffa462009-02-13 15:25:34 +0000333 if (GenericBlockLiteralType)
334 return GenericBlockLiteralType;
335
Mike Stumpc4ae9632009-02-13 15:32:32 +0000336 const llvm::Type *BlockDescPtrTy =
Mike Stump0dffa462009-02-13 15:25:34 +0000337 llvm::PointerType::getUnqual(getBlockDescriptorType());
Mike Stumpc4ae9632009-02-13 15:32:32 +0000338
Mike Stump7b7cd8b2009-02-13 16:01:35 +0000339 const llvm::IntegerType *IntTy = cast<llvm::IntegerType>(
340 getTypes().ConvertType(getContext().IntTy));
341
Mike Stump0dffa462009-02-13 15:25:34 +0000342 // struct __block_literal_generic {
Mike Stumpd55240e2009-02-19 01:01:04 +0000343 // void *__isa;
344 // int __flags;
345 // int __reserved;
346 // void (*__invoke)(void *);
347 // struct __block_descriptor *__descriptor;
Mike Stump0dffa462009-02-13 15:25:34 +0000348 // };
Mike Stump60294662009-03-05 01:23:13 +0000349 GenericBlockLiteralType = llvm::StructType::get(PtrToInt8Ty,
Mike Stump7b7cd8b2009-02-13 16:01:35 +0000350 IntTy,
351 IntTy,
Mike Stump60294662009-03-05 01:23:13 +0000352 PtrToInt8Ty,
Mike Stump0dffa462009-02-13 15:25:34 +0000353 BlockDescPtrTy,
354 NULL);
Mike Stumpc4ae9632009-02-13 15:32:32 +0000355
Mike Stump0dffa462009-02-13 15:25:34 +0000356 getModule().addTypeName("struct.__block_literal_generic",
357 GenericBlockLiteralType);
Mike Stumpc4ae9632009-02-13 15:32:32 +0000358
Mike Stump0dffa462009-02-13 15:25:34 +0000359 return GenericBlockLiteralType;
Anders Carlssond2a889b2009-02-12 00:39:25 +0000360}
361
Mike Stump1f010b52009-03-04 18:17:45 +0000362const llvm::Type *BlockModule::getGenericExtendedBlockLiteralType() {
Mike Stumpd55240e2009-02-19 01:01:04 +0000363 if (GenericExtendedBlockLiteralType)
364 return GenericExtendedBlockLiteralType;
365
Mike Stumpd55240e2009-02-19 01:01:04 +0000366 const llvm::Type *BlockDescPtrTy =
367 llvm::PointerType::getUnqual(getBlockDescriptorType());
368
369 const llvm::IntegerType *IntTy = cast<llvm::IntegerType>(
370 getTypes().ConvertType(getContext().IntTy));
371
372 // struct __block_literal_generic {
373 // void *__isa;
374 // int __flags;
375 // int __reserved;
376 // void (*__invoke)(void *);
377 // struct __block_descriptor *__descriptor;
378 // void *__copy_func_helper_decl;
379 // void *__destroy_func_decl;
380 // };
Mike Stump60294662009-03-05 01:23:13 +0000381 GenericExtendedBlockLiteralType = llvm::StructType::get(PtrToInt8Ty,
Mike Stumpd55240e2009-02-19 01:01:04 +0000382 IntTy,
383 IntTy,
Mike Stump60294662009-03-05 01:23:13 +0000384 PtrToInt8Ty,
Mike Stumpd55240e2009-02-19 01:01:04 +0000385 BlockDescPtrTy,
Mike Stump60294662009-03-05 01:23:13 +0000386 PtrToInt8Ty,
387 PtrToInt8Ty,
Mike Stumpd55240e2009-02-19 01:01:04 +0000388 NULL);
389
390 getModule().addTypeName("struct.__block_literal_extended_generic",
391 GenericExtendedBlockLiteralType);
392
393 return GenericExtendedBlockLiteralType;
394}
395
Mike Stumpc4ae9632009-02-13 15:32:32 +0000396/// getBlockFunctionType - Given a BlockPointerType, will return the
Anders Carlssond2a889b2009-02-12 00:39:25 +0000397/// function type for the block, including the first block literal argument.
398static QualType getBlockFunctionType(ASTContext &Ctx,
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000399 const BlockPointerType *BPT) {
Douglas Gregor4fa58902009-02-26 23:50:07 +0000400 const FunctionProtoType *FTy = cast<FunctionProtoType>(BPT->getPointeeType());
Mike Stumpc4ae9632009-02-13 15:32:32 +0000401
Anders Carlssond2a889b2009-02-12 00:39:25 +0000402 llvm::SmallVector<QualType, 8> Types;
403 Types.push_back(Ctx.getPointerType(Ctx.VoidTy));
Mike Stumpc4ae9632009-02-13 15:32:32 +0000404
Douglas Gregor4fa58902009-02-26 23:50:07 +0000405 for (FunctionProtoType::arg_type_iterator i = FTy->arg_type_begin(),
Anders Carlssond2a889b2009-02-12 00:39:25 +0000406 e = FTy->arg_type_end(); i != e; ++i)
407 Types.push_back(*i);
Mike Stumpc4ae9632009-02-13 15:32:32 +0000408
Anders Carlssond2a889b2009-02-12 00:39:25 +0000409 return Ctx.getFunctionType(FTy->getResultType(),
Mike Stumpc4ae9632009-02-13 15:32:32 +0000410 &Types[0], Types.size(),
Anders Carlssond2a889b2009-02-12 00:39:25 +0000411 FTy->isVariadic(), 0);
412}
413
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000414RValue CodeGenFunction::EmitBlockCallExpr(const CallExpr* E) {
Mike Stumpc4ae9632009-02-13 15:32:32 +0000415 const BlockPointerType *BPT =
Anders Carlssond2a889b2009-02-12 00:39:25 +0000416 E->getCallee()->getType()->getAsBlockPointerType();
Mike Stumpc4ae9632009-02-13 15:32:32 +0000417
Anders Carlssond2a889b2009-02-12 00:39:25 +0000418 llvm::Value *Callee = EmitScalarExpr(E->getCallee());
419
420 // Get a pointer to the generic block literal.
421 const llvm::Type *BlockLiteralTy =
Mike Stump0dffa462009-02-13 15:25:34 +0000422 llvm::PointerType::getUnqual(CGM.getGenericBlockLiteralType());
Anders Carlssond2a889b2009-02-12 00:39:25 +0000423
424 // Bitcast the callee to a block literal.
Mike Stumpc4ae9632009-02-13 15:32:32 +0000425 llvm::Value *BlockLiteral =
Anders Carlssond2a889b2009-02-12 00:39:25 +0000426 Builder.CreateBitCast(Callee, BlockLiteralTy, "block.literal");
427
428 // Get the function pointer from the literal.
429 llvm::Value *FuncPtr = Builder.CreateStructGEP(BlockLiteral, 3, "tmp");
Mike Stump39bcc612009-02-22 13:27:11 +0000430 llvm::Value *Func = Builder.CreateLoad(FuncPtr, false, "tmp");
Anders Carlssond2a889b2009-02-12 00:39:25 +0000431
432 // Cast the function pointer to the right type.
Mike Stumpc4ae9632009-02-13 15:32:32 +0000433 const llvm::Type *BlockFTy =
Anders Carlssond2a889b2009-02-12 00:39:25 +0000434 ConvertType(getBlockFunctionType(getContext(), BPT));
435 const llvm::Type *BlockFTyPtr = llvm::PointerType::getUnqual(BlockFTy);
436 Func = Builder.CreateBitCast(Func, BlockFTyPtr);
437
Mike Stumpc4ae9632009-02-13 15:32:32 +0000438 BlockLiteral =
439 Builder.CreateBitCast(BlockLiteral,
Anders Carlssond2a889b2009-02-12 00:39:25 +0000440 llvm::PointerType::getUnqual(llvm::Type::Int8Ty),
441 "tmp");
Mike Stumpc4ae9632009-02-13 15:32:32 +0000442
Anders Carlssond2a889b2009-02-12 00:39:25 +0000443 // Add the block literal.
444 QualType VoidPtrTy = getContext().getPointerType(getContext().VoidTy);
445 CallArgList Args;
446 Args.push_back(std::make_pair(RValue::get(BlockLiteral), VoidPtrTy));
Mike Stumpc4ae9632009-02-13 15:32:32 +0000447
Anders Carlssond2a889b2009-02-12 00:39:25 +0000448 // And the rest of the arguments.
Mike Stumpc4ae9632009-02-13 15:32:32 +0000449 for (CallExpr::const_arg_iterator i = E->arg_begin(), e = E->arg_end();
Anders Carlssond2a889b2009-02-12 00:39:25 +0000450 i != e; ++i)
Mike Stumpc4ae9632009-02-13 15:32:32 +0000451 Args.push_back(std::make_pair(EmitAnyExprToTemp(*i),
Anders Carlssond2a889b2009-02-12 00:39:25 +0000452 i->getType()));
Mike Stumpc4ae9632009-02-13 15:32:32 +0000453
Anders Carlssond2a889b2009-02-12 00:39:25 +0000454 // And call the block.
Mike Stumpc4ae9632009-02-13 15:32:32 +0000455 return EmitCall(CGM.getTypes().getFunctionInfo(E->getType(), Args),
Anders Carlssond2a889b2009-02-12 00:39:25 +0000456 Func, Args);
457}
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000458
Mike Stumpad9605d2009-03-04 03:23:46 +0000459llvm::Value *CodeGenFunction::GetAddrOfBlockDecl(const BlockDeclRefExpr *E) {
460 uint64_t &offset = BlockDecls[E->getDecl()];
461
462 const llvm::Type *Ty;
463 Ty = CGM.getTypes().ConvertType(E->getDecl()->getType());
464
465 // FIXME: add support for copy/dispose helpers.
Mike Stumpb3a6fac2009-03-04 13:17:22 +0000466 if (!Enable__block && E->isByRef())
Mike Stumpad9605d2009-03-04 03:23:46 +0000467 ErrorUnsupported(E, "__block variable in block literal");
468 else if (E->getType()->isBlockPointerType())
469 ErrorUnsupported(E, "block pointer in block literal");
Mike Stump1bdbf632009-03-05 08:32:30 +0000470 else if (E->getDecl()->getAttr<ObjCNSObjectAttr>() ||
Mike Stumpad9605d2009-03-04 03:23:46 +0000471 getContext().isObjCNSObjectType(E->getType()))
472 ErrorUnsupported(E, "__attribute__((NSObject)) variable in block "
473 "literal");
474 else if (getContext().isObjCObjectPointerType(E->getType()))
475 ErrorUnsupported(E, "Objective-C variable in block literal");
476
477 // See if we have already allocated an offset for this variable.
478 if (offset == 0) {
Mike Stump1bdbf632009-03-05 08:32:30 +0000479 // Don't run the expensive check, unless we have to.
480 if (!BlockHasCopyDispose && BlockRequiresCopying(E->getType()))
481 BlockHasCopyDispose = true;
Mike Stumpad9605d2009-03-04 03:23:46 +0000482 // if not, allocate one now.
483 offset = getBlockOffset(E);
484 }
485
486 llvm::Value *BlockLiteral = LoadBlockStruct();
487 llvm::Value *V = Builder.CreateGEP(BlockLiteral,
488 llvm::ConstantInt::get(llvm::Type::Int64Ty,
489 offset),
Mike Stumpf13eac12009-03-04 22:48:06 +0000490 "block.literal");
Mike Stumpad9605d2009-03-04 03:23:46 +0000491 if (E->isByRef()) {
492 bool needsCopyDispose = BlockRequiresCopying(E->getType());
493 uint64_t Align = getContext().getDeclAlignInBytes(E->getDecl());
494 const llvm::Type *PtrStructTy
495 = llvm::PointerType::get(BuildByRefType(E->getType(), Align), 0);
496 Ty = PtrStructTy;
497 Ty = llvm::PointerType::get(Ty, 0);
498 V = Builder.CreateBitCast(V, Ty);
499 V = Builder.CreateLoad(V, false);
500 V = Builder.CreateStructGEP(V, 1, "forwarding");
501 V = Builder.CreateLoad(V, false);
502 V = Builder.CreateBitCast(V, PtrStructTy);
503 V = Builder.CreateStructGEP(V, needsCopyDispose*2 + 4, "x");
504 } else {
505 Ty = llvm::PointerType::get(Ty, 0);
506 V = Builder.CreateBitCast(V, Ty);
507 }
508 return V;
509}
510
Mike Stump084ba462009-02-14 22:16:35 +0000511llvm::Constant *
Mike Stumpd6d0ebe2009-03-04 18:47:42 +0000512BlockModule::GetAddrOfGlobalBlock(const BlockExpr *BE, const char * n) {
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000513 // Generate the block descriptor.
514 const llvm::Type *UnsignedLongTy = Types.ConvertType(Context.UnsignedLongTy);
Mike Stump7b7cd8b2009-02-13 16:01:35 +0000515 const llvm::IntegerType *IntTy = cast<llvm::IntegerType>(
516 getTypes().ConvertType(getContext().IntTy));
Mike Stumpc4ae9632009-02-13 15:32:32 +0000517
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000518 llvm::Constant *DescriptorFields[2];
Mike Stumpc4ae9632009-02-13 15:32:32 +0000519
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000520 // Reserved
521 DescriptorFields[0] = llvm::Constant::getNullValue(UnsignedLongTy);
Mike Stumpc4ae9632009-02-13 15:32:32 +0000522
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000523 // Block literal size. For global blocks we just use the size of the generic
524 // block literal struct.
Mike Stumpc4ae9632009-02-13 15:32:32 +0000525 uint64_t BlockLiteralSize =
Mike Stump0dffa462009-02-13 15:25:34 +0000526 TheTargetData.getTypeStoreSizeInBits(getGenericBlockLiteralType()) / 8;
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000527 DescriptorFields[1] = llvm::ConstantInt::get(UnsignedLongTy,BlockLiteralSize);
Mike Stumpc4ae9632009-02-13 15:32:32 +0000528
529 llvm::Constant *DescriptorStruct =
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000530 llvm::ConstantStruct::get(&DescriptorFields[0], 2);
Mike Stumpc4ae9632009-02-13 15:32:32 +0000531
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000532 llvm::GlobalVariable *Descriptor =
533 new llvm::GlobalVariable(DescriptorStruct->getType(), true,
Mike Stumpc4ae9632009-02-13 15:32:32 +0000534 llvm::GlobalVariable::InternalLinkage,
535 DescriptorStruct, "__block_descriptor_global",
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000536 &getModule());
Mike Stumpc4ae9632009-02-13 15:32:32 +0000537
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000538 // Generate the constants for the block literal.
539 llvm::Constant *LiteralFields[5];
Mike Stumpc4ae9632009-02-13 15:32:32 +0000540
Mike Stump084ba462009-02-14 22:16:35 +0000541 CodeGenFunction::BlockInfo Info(0, n);
Mike Stumpf1711822009-02-25 23:33:13 +0000542 uint64_t subBlockSize, subBlockAlign;
Mike Stump2b6933f2009-02-28 09:07:16 +0000543 llvm::SmallVector<const Expr *, 8> subBlockDeclRefDecls;
Mike Stump1bdbf632009-03-05 08:32:30 +0000544 bool subBlockHasCopyDispose;
Mike Stumpfca5da02009-02-21 20:00:35 +0000545 llvm::Function *Fn
Mike Stumpd6d0ebe2009-03-04 18:47:42 +0000546 = CodeGenFunction(CGM).GenerateBlockFunction(BE, Info, subBlockSize,
547 subBlockAlign,
Mike Stump1bdbf632009-03-05 08:32:30 +0000548 subBlockDeclRefDecls,
549 subBlockHasCopyDispose);
Mike Stumpfca5da02009-02-21 20:00:35 +0000550 assert(subBlockSize == BlockLiteralSize
551 && "no imports allowed for global block");
Mike Stump1bdbf632009-03-05 08:32:30 +0000552 assert(!subBlockHasCopyDispose && "no imports allowed for global block");
Mike Stumpc4ae9632009-02-13 15:32:32 +0000553
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000554 // isa
Mike Stump5f87e9d2009-02-13 17:23:42 +0000555 LiteralFields[0] = getNSConcreteGlobalBlock();
Mike Stumpc4ae9632009-02-13 15:32:32 +0000556
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000557 // Flags
Mike Stump1bdbf632009-03-05 08:32:30 +0000558 LiteralFields[1] =
Anders Carlsson63810c62009-03-01 21:09:29 +0000559 llvm::ConstantInt::get(IntTy, BLOCK_IS_GLOBAL | BLOCK_HAS_DESCRIPTOR);
Mike Stumpc4ae9632009-02-13 15:32:32 +0000560
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000561 // Reserved
Mike Stump7b7cd8b2009-02-13 16:01:35 +0000562 LiteralFields[2] = llvm::Constant::getNullValue(IntTy);
Mike Stumpc4ae9632009-02-13 15:32:32 +0000563
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000564 // Function
565 LiteralFields[3] = Fn;
Mike Stumpc4ae9632009-02-13 15:32:32 +0000566
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000567 // Descriptor
568 LiteralFields[4] = Descriptor;
Mike Stumpc4ae9632009-02-13 15:32:32 +0000569
570 llvm::Constant *BlockLiteralStruct =
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000571 llvm::ConstantStruct::get(&LiteralFields[0], 5);
Mike Stumpc4ae9632009-02-13 15:32:32 +0000572
573 llvm::GlobalVariable *BlockLiteral =
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000574 new llvm::GlobalVariable(BlockLiteralStruct->getType(), true,
Mike Stumpc4ae9632009-02-13 15:32:32 +0000575 llvm::GlobalVariable::InternalLinkage,
576 BlockLiteralStruct, "__block_literal_global",
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000577 &getModule());
Mike Stumpc4ae9632009-02-13 15:32:32 +0000578
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000579 return BlockLiteral;
580}
581
Mike Stumpfca5da02009-02-21 20:00:35 +0000582llvm::Value *CodeGenFunction::LoadBlockStruct() {
583 return Builder.CreateLoad(LocalDeclMap[getBlockStructDecl()], "self");
584}
585
Mike Stump1bdbf632009-03-05 08:32:30 +0000586llvm::Function *
587CodeGenFunction::GenerateBlockFunction(const BlockExpr *BExpr,
588 const BlockInfo& Info,
589 uint64_t &Size,
590 uint64_t &Align,
591 llvm::SmallVector<const Expr *, 8> &subBlockDeclRefDecls,
592 bool &subBlockHasCopyDispose) {
Douglas Gregor4fa58902009-02-26 23:50:07 +0000593 const FunctionProtoType *FTy =
Chris Lattner8130e7f2009-02-28 19:01:03 +0000594 cast<FunctionProtoType>(BExpr->getFunctionType());
Mike Stumpc4ae9632009-02-13 15:32:32 +0000595
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000596 FunctionArgList Args;
Mike Stumpc4ae9632009-02-13 15:32:32 +0000597
Chris Lattner8130e7f2009-02-28 19:01:03 +0000598 const BlockDecl *BD = BExpr->getBlockDecl();
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000599
600 // FIXME: This leaks
Mike Stumpc4ae9632009-02-13 15:32:32 +0000601 ImplicitParamDecl *SelfDecl =
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000602 ImplicitParamDecl::Create(getContext(), 0,
603 SourceLocation(), 0,
604 getContext().getPointerType(getContext().VoidTy));
Mike Stumpc4ae9632009-02-13 15:32:32 +0000605
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000606 Args.push_back(std::make_pair(SelfDecl, SelfDecl->getType()));
Mike Stumpfca5da02009-02-21 20:00:35 +0000607 BlockStructDecl = SelfDecl;
Mike Stumpc4ae9632009-02-13 15:32:32 +0000608
609 for (BlockDecl::param_iterator i = BD->param_begin(),
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000610 e = BD->param_end(); i != e; ++i)
Mike Stump459207f2009-02-17 23:25:52 +0000611 Args.push_back(std::make_pair(*i, (*i)->getType()));
Mike Stumpc4ae9632009-02-13 15:32:32 +0000612
613 const CGFunctionInfo &FI =
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000614 CGM.getTypes().getFunctionInfo(FTy->getResultType(), Args);
615
Mike Stump084ba462009-02-14 22:16:35 +0000616 std::string Name = std::string("__") + Info.Name + "_block_invoke_";
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000617 CodeGenTypes &Types = CGM.getTypes();
618 const llvm::FunctionType *LTy = Types.GetFunctionType(FI, FTy->isVariadic());
Mike Stumpc4ae9632009-02-13 15:32:32 +0000619
620 llvm::Function *Fn =
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000621 llvm::Function::Create(LTy, llvm::GlobalValue::InternalLinkage,
622 Name,
623 &CGM.getModule());
Mike Stumpc4ae9632009-02-13 15:32:32 +0000624
625 StartFunction(BD, FTy->getResultType(), Fn, Args,
Chris Lattner8130e7f2009-02-28 19:01:03 +0000626 BExpr->getBody()->getLocEnd());
627 EmitStmt(BExpr->getBody());
628 FinishFunction(cast<CompoundStmt>(BExpr->getBody())->getRBracLoc());
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000629
Mike Stumpf1711822009-02-25 23:33:13 +0000630 // The runtime needs a minimum alignment of a void *.
631 uint64_t MinAlign = getContext().getTypeAlign(getContext().VoidPtrTy) / 8;
632 BlockOffset = llvm::RoundUpToAlignment(BlockOffset, MinAlign);
633
Mike Stumpfca5da02009-02-21 20:00:35 +0000634 Size = BlockOffset;
Mike Stumpf1711822009-02-25 23:33:13 +0000635 Align = BlockAlign;
636 subBlockDeclRefDecls = BlockDeclRefDecls;
Mike Stump1bdbf632009-03-05 08:32:30 +0000637 subBlockHasCopyDispose |= BlockHasCopyDispose;
Anders Carlsson1f1cd392009-02-12 17:55:02 +0000638 return Fn;
639}
Mike Stump2b6933f2009-02-28 09:07:16 +0000640
641uint64_t CodeGenFunction::getBlockOffset(const BlockDeclRefExpr *BDRE) {
642 const ValueDecl *D = dyn_cast<ValueDecl>(BDRE->getDecl());
643
644 uint64_t Size = getContext().getTypeSize(D->getType()) / 8;
645 uint64_t Align = getContext().getDeclAlignInBytes(D);
646
647 if (BDRE->isByRef()) {
648 Size = getContext().getTypeSize(getContext().VoidPtrTy) / 8;
649 Align = getContext().getTypeAlign(getContext().VoidPtrTy) / 8;
650 }
651
652 assert ((Align > 0) && "alignment must be 1 byte or more");
653
654 uint64_t OldOffset = BlockOffset;
655
656 // Ensure proper alignment, even if it means we have to have a gap
657 BlockOffset = llvm::RoundUpToAlignment(BlockOffset, Align);
658 BlockAlign = std::max(Align, BlockAlign);
Mike Stump1bdbf632009-03-05 08:32:30 +0000659
Mike Stump2b6933f2009-02-28 09:07:16 +0000660 uint64_t Pad = BlockOffset - OldOffset;
661 if (Pad) {
662 llvm::ArrayType::get(llvm::Type::Int8Ty, Pad);
663 QualType PadTy = getContext().getConstantArrayType(getContext().CharTy,
664 llvm::APInt(32, Pad),
665 ArrayType::Normal, 0);
666 ValueDecl *PadDecl = VarDecl::Create(getContext(), 0, SourceLocation(),
667 0, QualType(PadTy), VarDecl::None,
668 SourceLocation());
669 Expr *E;
670 E = new (getContext()) DeclRefExpr(PadDecl, PadDecl->getType(),
671 SourceLocation(), false, false);
672 BlockDeclRefDecls.push_back(E);
673 }
674 BlockDeclRefDecls.push_back(BDRE);
675
676 BlockOffset += Size;
677 return BlockOffset-Size;
678}
Mike Stumpad9605d2009-03-04 03:23:46 +0000679
Mike Stumpa79696d2009-03-04 18:57:26 +0000680llvm::Value *BlockFunction::BuildCopyHelper(int flag) {
Mike Stumpad9605d2009-03-04 03:23:46 +0000681 // FIXME: implement
682 llvm::Value *V = llvm::ConstantInt::get(llvm::Type::Int32Ty, 43);
683 V = Builder.CreateIntToPtr(V, PtrToInt8Ty, "tmp");
684 V = Builder.CreateBitCast(V, PtrToInt8Ty, "tmp");
685 return V;
686}
687
Mike Stumpa79696d2009-03-04 18:57:26 +0000688llvm::Value *BlockFunction::BuildDestroyHelper(int flag) {
Mike Stumpad9605d2009-03-04 03:23:46 +0000689 // FIXME: implement
690 llvm::Value *V = llvm::ConstantInt::get(llvm::Type::Int32Ty, 44);
691 V = Builder.CreateIntToPtr(V, PtrToInt8Ty, "tmp");
692 V = Builder.CreateBitCast(V, PtrToInt8Ty, "tmp");
693 return V;
694}
Mike Stump60294662009-03-05 01:23:13 +0000695
696llvm::Value *BlockFunction::getBlockObjectDispose() {
697 if (CGM.BlockObjectDispose == 0) {
698 const llvm::FunctionType *FTy;
699 std::vector<const llvm::Type*> ArgTys;
700 const llvm::Type *ResultType = llvm::Type::VoidTy;
701 ArgTys.push_back(PtrToInt8Ty);
702 ArgTys.push_back(llvm::Type::Int32Ty);
703 FTy = llvm::FunctionType::get(ResultType, ArgTys, false);
Mike Stump1bdbf632009-03-05 08:32:30 +0000704 CGM.BlockObjectDispose
Mike Stump60294662009-03-05 01:23:13 +0000705 = CGM.CreateRuntimeFunction(FTy, "_Block_object_dispose");
706 }
707 return CGM.BlockObjectDispose;
708}
709
710void BlockFunction::BuildBlockRelease(const VarDecl &D, llvm::Value *DeclPtr) {
711 llvm::Value *F = getBlockObjectDispose();
712 llvm::Value *N, *V;
713 V = Builder.CreateStructGEP(DeclPtr, 1, "forwarding");
714 V = Builder.CreateLoad(V, false);
715 V = Builder.CreateBitCast(V, PtrToInt8Ty);
716 N = llvm::ConstantInt::get(llvm::Type::Int32Ty, BLOCK_FIELD_IS_BYREF);
717 Builder.CreateCall2(F, V, N);
718}
Mike Stump1bdbf632009-03-05 08:32:30 +0000719
720ASTContext &BlockFunction::getContext() const { return CGM.getContext(); }