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 /// Location for this EmitContext
278 /// Used to "flag" the resolution process to only lookup types,
279 /// and nothing else. This is an out-of-band communication
280 /// path to SimpleName from the cast operation.
282 public bool OnlyLookupTypes;
285 /// Inside an enum definition, we do not resolve enumeration values
286 /// to their enumerations, but rather to the underlying type/value
287 /// This is so EnumVal + EnumValB can be evaluated.
289 /// There is no "E operator + (E x, E y)", so during an enum evaluation
290 /// we relax the rules
292 public bool InEnumContext;
294 public EmitContext (TypeContainer parent, DeclSpace ds, Location l, ILGenerator ig,
295 Type return_type, int code_flags, bool is_constructor)
299 TypeContainer = parent;
301 CheckState = RootContext.Checked;
302 ConstantCheckState = true;
304 IsStatic = (code_flags & Modifiers.STATIC) != 0;
305 ReturnType = return_type;
306 IsConstructor = is_constructor;
308 ContainerType = parent.TypeBuilder;
309 InUnsafe = ((parent.ModFlags | code_flags) & Modifiers.UNSAFE) != 0;
310 OnlyLookupTypes = false;
313 if (ReturnType == TypeManager.void_type)
317 public EmitContext (TypeContainer tc, Location l, ILGenerator ig,
318 Type return_type, int code_flags, bool is_constructor)
319 : this (tc, tc, l, ig, return_type, code_flags, is_constructor)
323 public EmitContext (TypeContainer tc, Location l, ILGenerator ig,
324 Type return_type, int code_flags)
325 : this (tc, tc, l, ig, return_type, code_flags, false)
329 public void EmitTopBlock (Block block, Location loc)
331 bool has_ret = false;
333 // Console.WriteLine ("Emitting: " + loc);
335 if (CodeGen.SymbolWriter != null)
339 int errors = Report.Errors;
341 block.EmitMeta (this, block);
343 if (Report.Errors == errors){
344 if (!block.Resolve (this))
347 has_ret = block.Emit (this);
349 if (Report.Errors == errors){
350 if (RootContext.WarningLevel >= 3)
351 block.UsageWarning ();
356 if (ReturnType != null && !has_ret){
358 // FIXME: we need full flow analysis to implement this
359 // correctly and emit an error instead of a warning.
362 Report.Error (161, loc, "Not all code paths return a value");
366 if (return_value != null){
367 ig.MarkLabel (ReturnLabel);
368 ig.Emit (OpCodes.Ldloc, return_value);
369 ig.Emit (OpCodes.Ret);
373 ig.Emit (OpCodes.Ret);
379 /// This is called immediately before emitting an IL opcode to tell the symbol
380 /// writer to which source line this opcode belongs.
382 public void Mark (Location loc)
384 if (!Location.IsNull (loc)) {
385 ISymbolDocumentWriter doc = loc.SymbolDocument;
388 ig.MarkSequencePoint (doc, loc.Row, 0, loc.Row, 0);
393 /// Returns a temporary storage for a variable of type t as
394 /// a local variable in the current body.
396 public LocalBuilder GetTemporaryStorage (Type t)
398 LocalBuilder location;
400 if (temporary_storage != null){
401 location = (LocalBuilder) temporary_storage [t];
402 if (location != null)
406 location = ig.DeclareLocal (t);
411 public void FreeTemporaryStorage (LocalBuilder b)
417 /// Current loop begin and end labels.
419 public Label LoopBegin, LoopEnd;
422 /// Whether we are inside a loop and break/continue are possible.
427 /// Default target in a switch statement. Only valid if
430 public Label DefaultTarget;
433 /// If this is non-null, points to the current switch statement
435 public Switch Switch;
438 /// ReturnValue creates on demand the LocalBuilder for the
439 /// return value from the function. By default this is not
440 /// used. This is only required when returns are found inside
441 /// Try or Catch statements.
443 public LocalBuilder TemporaryReturn ()
445 if (return_value == null){
446 return_value = ig.DeclareLocal (ReturnType);
447 ReturnLabel = ig.DefineLabel ();
454 /// A dynamic This that is shared by all variables in a emitcontext.
455 /// Created on demand.
457 public Expression my_this;
458 public Expression This {
461 my_this = new This (loc).Resolve (this);