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 /// Whether we are emitting a field initializer
218 public bool IsFieldInitializer;
221 /// The value that is allowed to be returned or NULL if there is no
224 public Type ReturnType;
227 /// Points to the Type (extracted from the TypeContainer) that
228 /// declares this body of code
230 public Type ContainerType;
233 /// Whether this is generating code for a constructor
235 public bool IsConstructor;
238 /// Whether we're control flow analysis enabled
240 public bool DoFlowAnalysis;
243 /// Keeps track of the Type to LocalBuilder temporary storage created
244 /// to store structures (used to compute the address of the structure
245 /// value on structure method invocations)
247 public Hashtable temporary_storage;
249 public Block CurrentBlock;
252 /// The location where we store the return value.
254 LocalBuilder return_value;
257 /// The location where return has to jump to return the
260 public Label ReturnLabel;
263 /// If we already defined the ReturnLabel
265 public bool HasReturnLabel;
268 /// Whether we are in a Finally block
270 public bool InFinally;
273 /// Whether we are in a Try block
278 /// Whether we are in a Catch block
283 /// Whether we are inside an unsafe block
285 public bool InUnsafe;
288 /// Whether we break from a loop or not
293 /// Location for this EmitContext
298 /// Used to "flag" the resolution process to only lookup types,
299 /// and nothing else. This is an out-of-band communication
300 /// path to SimpleName from the cast operation.
302 public bool OnlyLookupTypes;
305 /// Used to flag that it is ok to define types recursively, as the
306 /// expressions are being evaluated as part of the type lookup
307 /// during the type resolution process
309 public bool ResolvingTypeTree;
312 /// Inside an enum definition, we do not resolve enumeration values
313 /// to their enumerations, but rather to the underlying type/value
314 /// This is so EnumVal + EnumValB can be evaluated.
316 /// There is no "E operator + (E x, E y)", so during an enum evaluation
317 /// we relax the rules
319 public bool InEnumContext;
321 protected Stack FlowStack;
323 public EmitContext (TypeContainer parent, DeclSpace ds, Location l, ILGenerator ig,
324 Type return_type, int code_flags, bool is_constructor)
328 TypeContainer = parent;
330 CheckState = RootContext.Checked;
331 ConstantCheckState = true;
333 IsStatic = (code_flags & Modifiers.STATIC) != 0;
334 ReturnType = return_type;
335 IsConstructor = is_constructor;
339 // Can only be null for the ResolveType contexts.
340 ContainerType = parent.TypeBuilder;
341 if (parent.UnsafeContext)
344 InUnsafe = (code_flags & Modifiers.UNSAFE) != 0;
346 OnlyLookupTypes = false;
349 FlowStack = new Stack ();
351 if (ReturnType == TypeManager.void_type)
355 public EmitContext (TypeContainer tc, Location l, ILGenerator ig,
356 Type return_type, int code_flags, bool is_constructor)
357 : this (tc, tc, l, ig, return_type, code_flags, is_constructor)
361 public EmitContext (TypeContainer tc, Location l, ILGenerator ig,
362 Type return_type, int code_flags)
363 : this (tc, tc, l, ig, return_type, code_flags, false)
367 public FlowBranching CurrentBranching {
369 return (FlowBranching) FlowStack.Peek ();
374 // Starts a new code branching. This inherits the state of all local
375 // variables and parameters from the current branching.
377 public FlowBranching StartFlowBranching (FlowBranchingType type, Location loc)
379 FlowBranching cfb = new FlowBranching (CurrentBranching, type, null, loc);
381 FlowStack.Push (cfb);
387 // Starts a new code branching for block `block'.
389 public FlowBranching StartFlowBranching (Block block)
392 FlowBranchingType type;
394 if (CurrentBranching.Type == FlowBranchingType.SWITCH)
395 type = FlowBranchingType.SWITCH_SECTION;
397 type = FlowBranchingType.BLOCK;
399 cfb = new FlowBranching (CurrentBranching, type, block, block.StartLocation);
401 FlowStack.Push (cfb);
407 // Ends a code branching. Merges the state of locals and parameters
408 // from all the children of the ending branching.
410 public FlowReturns EndFlowBranching ()
412 FlowBranching cfb = (FlowBranching) FlowStack.Pop ();
414 return CurrentBranching.MergeChild (cfb);
418 // Kills the current code branching. This throws away any changed state
419 // information and should only be used in case of an error.
421 public void KillFlowBranching ()
423 FlowBranching cfb = (FlowBranching) FlowStack.Pop ();
427 // Checks whether the local variable `vi' is already initialized
428 // at the current point of the method's control flow.
429 // If this method returns false, the caller must report an
432 public bool IsVariableAssigned (VariableInfo vi)
435 return CurrentBranching.IsVariableAssigned (vi);
441 // Marks the local variable `vi' as being initialized at the current
442 // current point of the method's control flow.
444 public void SetVariableAssigned (VariableInfo vi)
447 CurrentBranching.SetVariableAssigned (vi);
451 // Checks whether the parameter `number' is already initialized
452 // at the current point of the method's control flow.
453 // If this method returns false, the caller must report an
454 // error 165. This is only necessary for `out' parameters and the
455 // call will always succeed for non-`out' parameters.
457 public bool IsParameterAssigned (int number)
460 return CurrentBranching.IsParameterAssigned (number);
466 // Marks the parameter `number' as being initialized at the current
467 // current point of the method's control flow. This is only necessary
468 // for `out' parameters.
470 public void SetParameterAssigned (int number)
473 CurrentBranching.SetParameterAssigned (number);
476 public void EmitTopBlock (Block block, InternalParameters ip, Location loc)
478 bool has_ret = false;
480 // Console.WriteLine ("Emitting: " + loc);
482 if (CodeGen.SymbolWriter != null)
486 int errors = Report.Errors;
488 block.EmitMeta (this, block);
490 if (Report.Errors == errors){
491 bool old_do_flow_analysis = DoFlowAnalysis;
492 DoFlowAnalysis = true;
494 FlowBranching cfb = new FlowBranching (block, ip, loc);
495 FlowStack.Push (cfb);
497 if (!block.Resolve (this)) {
499 DoFlowAnalysis = old_do_flow_analysis;
503 cfb = (FlowBranching) FlowStack.Pop ();
504 cfb.MergeTopBlock ();
506 DoFlowAnalysis = old_do_flow_analysis;
508 has_ret = block.Emit (this);
510 if (Report.Errors == errors){
511 if (RootContext.WarningLevel >= 3)
512 block.UsageWarning ();
517 if (ReturnType != null && !has_ret){
519 // FIXME: we need full flow analysis to implement this
520 // correctly and emit an error instead of a warning.
523 Report.Error (161, loc, "Not all code paths return a value");
528 ig.MarkLabel (ReturnLabel);
529 if (return_value != null){
530 ig.Emit (OpCodes.Ldloc, return_value);
531 ig.Emit (OpCodes.Ret);
534 if (!has_ret || HasReturnLabel)
535 ig.Emit (OpCodes.Ret);
541 /// This is called immediately before emitting an IL opcode to tell the symbol
542 /// writer to which source line this opcode belongs.
544 public void Mark (Location loc)
546 if (!Location.IsNull (loc)) {
547 ISymbolDocumentWriter doc = loc.SymbolDocument;
550 ig.MarkSequencePoint (doc, loc.Row, 0, loc.Row, 0);
555 /// Returns a temporary storage for a variable of type t as
556 /// a local variable in the current body.
558 public LocalBuilder GetTemporaryStorage (Type t)
560 LocalBuilder location;
562 if (temporary_storage != null){
563 location = (LocalBuilder) temporary_storage [t];
564 if (location != null)
568 location = ig.DeclareLocal (t);
573 public void FreeTemporaryStorage (LocalBuilder b)
579 /// Current loop begin and end labels.
581 public Label LoopBegin, LoopEnd;
584 /// Whether we are inside a loop and break/continue are possible.
589 /// This is incremented each time we enter a try/catch block and
590 /// decremented if we leave it.
592 public int TryCatchLevel;
595 /// The TryCatchLevel at the begin of the current loop.
597 public int LoopBeginTryCatchLevel;
600 /// Default target in a switch statement. Only valid if
603 public Label DefaultTarget;
606 /// If this is non-null, points to the current switch statement
608 public Switch Switch;
611 /// ReturnValue creates on demand the LocalBuilder for the
612 /// return value from the function. By default this is not
613 /// used. This is only required when returns are found inside
614 /// Try or Catch statements.
616 public LocalBuilder TemporaryReturn ()
618 if (return_value == null){
619 return_value = ig.DeclareLocal (ReturnType);
620 ReturnLabel = ig.DefineLabel ();
621 HasReturnLabel = true;
628 /// A dynamic This that is shared by all variables in a emitcontext.
629 /// Created on demand.
631 public Expression my_this;
632 public Expression This {
635 my_this = new This (loc).Resolve (this);