2 // codegen.cs: The code generator
5 // Miguel de Icaza (miguel@ximian.com)
7 // (C) 2001 Ximian, Inc.
11 using System.Collections;
12 using System.Reflection;
13 using System.Reflection.Emit;
14 using System.Diagnostics.SymbolStore;
16 namespace Mono.CSharp {
19 /// Code generator class.
21 public class CodeGen {
22 static AppDomain current_domain;
23 public static AssemblyBuilder AssemblyBuilder;
24 public static ModuleBuilder ModuleBuilder;
26 static public ISymbolWriter SymbolWriter;
28 public static string Basename (string name)
30 int pos = name.LastIndexOf ("/");
33 return name.Substring (pos + 1);
35 pos = name.LastIndexOf ("\\");
37 return name.Substring (pos + 1);
42 public static string Dirname (string name)
44 int pos = name.LastIndexOf ("/");
47 return name.Substring (0, pos);
49 pos = name.LastIndexOf ("\\");
51 return name.Substring (0, pos);
56 static string TrimExt (string name)
58 int pos = name.LastIndexOf (".");
60 return name.Substring (0, pos);
63 static public string FileName;
66 // This routine initializes the Mono runtime SymbolWriter.
68 static void InitMonoSymbolWriter (string basename, string[] debug_args)
70 string symbol_output = basename + "-debug.s";
72 Type itype = SymbolWriter.GetType ();
76 Type[] arg_types = new Type [2];
77 arg_types [0] = typeof (string);
78 arg_types [1] = typeof (string[]);
80 MethodInfo initialize = itype.GetMethod ("Initialize", arg_types);
81 if (initialize == null)
84 object[] args = new object [2];
85 args [0] = symbol_output;
86 args [1] = debug_args;
88 initialize.Invoke (SymbolWriter, args);
92 // Initializes the symbol writer
94 static void InitializeSymbolWriter (string basename, string[] args)
96 SymbolWriter = ModuleBuilder.GetSymWriter ();
99 // If we got an ISymbolWriter instance, initialize it.
101 if (SymbolWriter == null)
105 // Due to lacking documentation about the first argument of the
106 // Initialize method, we cannot use Microsoft's default symbol
109 // If we're using the mono symbol writer, the SymbolWriter object
110 // is of type MonoSymbolWriter - but that's defined in a dynamically
111 // loaded DLL - that's why we're doing a comparision based on the type
112 // name here instead of using `SymbolWriter is MonoSymbolWriter'.
114 Type sym_type = ((object) SymbolWriter).GetType ();
116 switch (sym_type.Name){
117 case "MonoSymbolWriter":
118 InitMonoSymbolWriter (basename, args);
123 -18, "Cannot generate debugging information on this platform");
129 // Initializes the code generator variables
131 static public void Init (string name, string output, bool want_debugging_support,
137 an = new AssemblyName ();
138 an.Name = TrimExt (Basename (name));
139 current_domain = AppDomain.CurrentDomain;
140 AssemblyBuilder = current_domain.DefineDynamicAssembly (
141 an, AssemblyBuilderAccess.RunAndSave, Dirname (name));
144 // Pass a path-less name to DefineDynamicModule. Wonder how
145 // this copes with output in different directories then.
146 // FIXME: figure out how this copes with --output /tmp/blah
148 // If the third argument is true, the ModuleBuilder will dynamically
149 // load the default symbol writer.
151 ModuleBuilder = AssemblyBuilder.DefineDynamicModule (
152 Basename (name), Basename (output), want_debugging_support);
154 if (want_debugging_support)
155 InitializeSymbolWriter (an.Name, debug_args);
158 static public void Save (string name)
161 AssemblyBuilder.Save (Basename (name));
162 } catch (System.IO.IOException io){
163 Report.Error (16, "Coult not write to file `"+name+"', cause: " + io.Message);
167 static public void SaveSymbols ()
169 if (SymbolWriter != null) {
170 // If we have a symbol writer, call its Close() method to write
171 // the symbol file to disk.
173 // When using Mono's default symbol writer, the Close() method must
174 // be called after the assembly has already been written to disk since
175 // it opens the assembly and reads its metadata.
176 SymbolWriter.Close ();
182 /// An Emit Context is created for each body of code (from methods,
183 /// properties bodies, indexer bodies or constructor bodies)
185 public class EmitContext {
186 public DeclSpace DeclSpace;
187 public TypeContainer TypeContainer;
188 public ILGenerator ig;
191 /// This variable tracks the `checked' state of the compilation,
192 /// it controls whether we should generate code that does overflow
193 /// checking, or if we generate code that ignores overflows.
195 /// The default setting comes from the command line option to generate
196 /// checked or unchecked code plus any source code changes using the
197 /// checked/unchecked statements or expressions. Contrast this with
198 /// the ConstantCheckState flag.
201 public bool CheckState;
204 /// The constant check state is always set to `true' and cant be changed
205 /// from the command line. The source code can change this setting with
206 /// the `checked' and `unchecked' statements and expressions.
208 public bool ConstantCheckState;
211 /// Whether we are emitting code inside a static or instance method
213 public bool IsStatic;
216 /// The value that is allowed to be returned or NULL if there is no
219 public Type ReturnType;
222 /// Points to the Type (extracted from the TypeContainer) that
223 /// declares this body of code
225 public Type ContainerType;
228 /// Whether this is generating code for a constructor
230 public bool IsConstructor;
233 /// Keeps track of the Type to LocalBuilder temporary storage created
234 /// to store structures (used to compute the address of the structure
235 /// value on structure method invocations)
237 public Hashtable temporary_storage;
239 public Block CurrentBlock;
242 /// The location where we store the return value.
244 LocalBuilder return_value;
247 /// The location where return has to jump to return the
250 public Label ReturnLabel;
253 /// Whether we are in a Finally block
255 public bool InFinally;
258 /// Whether we are in a Try block
263 /// Whether we are in a Catch block
268 /// Whether we are inside an unsafe block
270 public bool InUnsafe;
273 /// Whether we break from a loop or not
278 /// Location for this EmitContext
283 /// Used to "flag" the resolution process to only lookup types,
284 /// and nothing else. This is an out-of-band communication
285 /// path to SimpleName from the cast operation.
287 public bool OnlyLookupTypes;
290 /// Used to flag that it is ok to define types recursively, as the
291 /// expressions are being evaluated as part of the type lookup
292 /// during the type resolution process
294 public bool ResolvingTypeTree;
297 /// Inside an enum definition, we do not resolve enumeration values
298 /// to their enumerations, but rather to the underlying type/value
299 /// This is so EnumVal + EnumValB can be evaluated.
301 /// There is no "E operator + (E x, E y)", so during an enum evaluation
302 /// we relax the rules
304 public bool InEnumContext;
306 public EmitContext (TypeContainer parent, DeclSpace ds, Location l, ILGenerator ig,
307 Type return_type, int code_flags, bool is_constructor)
311 TypeContainer = parent;
313 CheckState = RootContext.Checked;
314 ConstantCheckState = true;
316 IsStatic = (code_flags & Modifiers.STATIC) != 0;
317 ReturnType = return_type;
318 IsConstructor = is_constructor;
322 // Can only be null for the ResolveType contexts.
323 ContainerType = parent.TypeBuilder;
324 InUnsafe = ((parent.ModFlags | code_flags) & Modifiers.UNSAFE) != 0;
326 OnlyLookupTypes = false;
329 if (ReturnType == TypeManager.void_type)
333 public EmitContext (TypeContainer tc, Location l, ILGenerator ig,
334 Type return_type, int code_flags, bool is_constructor)
335 : this (tc, tc, l, ig, return_type, code_flags, is_constructor)
339 public EmitContext (TypeContainer tc, Location l, ILGenerator ig,
340 Type return_type, int code_flags)
341 : this (tc, tc, l, ig, return_type, code_flags, false)
345 public void EmitTopBlock (Block block, Location loc)
347 bool has_ret = false;
349 // Console.WriteLine ("Emitting: " + loc);
351 if (CodeGen.SymbolWriter != null)
355 int errors = Report.Errors;
357 block.EmitMeta (this, block);
359 if (Report.Errors == errors){
360 if (!block.Resolve (this))
363 has_ret = block.Emit (this);
365 if (Report.Errors == errors){
366 if (RootContext.WarningLevel >= 3)
367 block.UsageWarning ();
372 if (ReturnType != null && !has_ret){
374 // FIXME: we need full flow analysis to implement this
375 // correctly and emit an error instead of a warning.
378 Report.Error (161, loc, "Not all code paths return a value");
382 if (return_value != null){
383 ig.MarkLabel (ReturnLabel);
384 ig.Emit (OpCodes.Ldloc, return_value);
385 ig.Emit (OpCodes.Ret);
389 ig.Emit (OpCodes.Ret);
395 /// This is called immediately before emitting an IL opcode to tell the symbol
396 /// writer to which source line this opcode belongs.
398 public void Mark (Location loc)
400 if (!Location.IsNull (loc)) {
401 ISymbolDocumentWriter doc = loc.SymbolDocument;
404 ig.MarkSequencePoint (doc, loc.Row, 0, loc.Row, 0);
409 /// Returns a temporary storage for a variable of type t as
410 /// a local variable in the current body.
412 public LocalBuilder GetTemporaryStorage (Type t)
414 LocalBuilder location;
416 if (temporary_storage != null){
417 location = (LocalBuilder) temporary_storage [t];
418 if (location != null)
422 location = ig.DeclareLocal (t);
427 public void FreeTemporaryStorage (LocalBuilder b)
433 /// Current loop begin and end labels.
435 public Label LoopBegin, LoopEnd;
438 /// Whether we are inside a loop and break/continue are possible.
443 /// Default target in a switch statement. Only valid if
446 public Label DefaultTarget;
449 /// If this is non-null, points to the current switch statement
451 public Switch Switch;
454 /// ReturnValue creates on demand the LocalBuilder for the
455 /// return value from the function. By default this is not
456 /// used. This is only required when returns are found inside
457 /// Try or Catch statements.
459 public LocalBuilder TemporaryReturn ()
461 if (return_value == null){
462 return_value = ig.DeclareLocal (ReturnType);
463 ReturnLabel = ig.DefineLabel ();
470 /// A dynamic This that is shared by all variables in a emitcontext.
471 /// Created on demand.
473 public Expression my_this;
474 public Expression This {
477 my_this = new This (loc).Resolve (this);