mcs/mcs/const.cs

   1 //
   2 // const.cs: Constant declarations.
   3 //
   4 // Author:
   5 //   Miguel de Icaza (miguel@ximian.com)
   6 //   Marek Safar (marek.safar@seznam.cz)
   7 //
   8 // (C) 2001 Ximian, Inc.
   9 //
  10 //
  11
  12 //
  13 // This is needed because the following situation arises:
  14 //
  15 //     The FieldBuilder is declared with the real type for an enumeration
  16 //
  17 //     When we attempt to set the value for the constant, the FieldBuilder.SetConstant
  18 //     function aborts because it requires its argument to be of the same type
  19 //
  20
  21 namespace Mono.CSharp {
  22
  23         using System;
  24         using System.Reflection;
  25         using System.Reflection.Emit;
  26         using System.Collections;
  27
  28         public class Const : FieldMember {
  29                 public Expression Expr;
  30                 EmitContext const_ec;
  31
  32                 bool resolved = false;
  33                 object ConstantValue = null;
  34
  35                 bool in_transit = false;
  36
  37                 public const int AllowedModifiers =
  38                         Modifiers.NEW |
  39                         Modifiers.PUBLIC |
  40                         Modifiers.PROTECTED |
  41                         Modifiers.INTERNAL |
  42                         Modifiers.PRIVATE;
  43
  44                 public Const (TypeContainer parent, Expression constant_type, string name,
  45                               Expression expr, int mod_flags, Attributes attrs, Location loc)
  46                         : base (parent, constant_type, mod_flags, AllowedModifiers,
  47                                 new MemberName (name), null, attrs, loc)
  48                 {
  49                         Expr = expr;
  50                         ModFlags |= Modifiers.STATIC;
  51                 }
  52
  53 #if DEBUG
  54                 void dump_tree (Type t)
  55                 {
  56                         Console.WriteLine ("Dumping hierarchy");
  57                         while (t != null){
  58                                 Console.WriteLine ("   " + t.FullName + " " +
  59                                         (t.GetType ().IsEnum ? "yes" : "no"));
  60                                 t = t.BaseType;
  61                         }
  62                 }
  63 #endif
  64
  65                 protected override bool CheckBase ()
  66                 {
  67                         // Constant.Define can be called when the parent type hasn't yet been populated
  68                         // and it's base types need not have been populated.  So, we defer this check
  69                         // to the second time Define () is called on this member.
  70                         if (Parent.BaseCache == null)
  71                                 return true;
  72                         return base.CheckBase ();
  73                 }
  74
  75                 /// <summary>
  76                 ///   Defines the constant in the @parent
  77                 /// </summary>
  78                 public override bool Define ()
  79                 {
  80                         // Make Define () idempotent, but ensure that the error check happens.
  81                         if (FieldBuilder != null)
  82                                 return base.CheckBase ();
  83
  84                         if (!base.Define ())
  85                                 return false;
  86
  87                         const_ec = new EmitContext (Parent, Location, null, MemberType, ModFlags);
  88
  89                         Type ttype = MemberType;
  90                         while (ttype.IsArray)
  91                             ttype = TypeManager.GetElementType (ttype);
  92
  93                         if (!TypeManager.IsBuiltinType(ttype) && (!ttype.IsSubclassOf(TypeManager.enum_type)) && !(Expr is NullLiteral)){
  94                                 Report.Error (
  95                                         -3, Location,
  96                                         "Constant type is not valid (only system types are allowed)");
  97                                 return false;
  98                         }
  99
 100                         FieldAttributes field_attr = FieldAttributes.Static | Modifiers.FieldAttr (ModFlags);
 101                         // I don't know why but they emit decimal constant as InitOnly
 102                         if (ttype == TypeManager.decimal_type) {
 103                                 field_attr |= FieldAttributes.InitOnly;
 104                         }
 105                         else {
 106                                 field_attr |= FieldAttributes.Literal;
 107                         }
 108
 109                         FieldBuilder = Parent.TypeBuilder.DefineField (Name, MemberType, field_attr);
 110
 111                         TypeManager.RegisterConstant (FieldBuilder, this);
 112
 113                         return true;
 114                 }
 115
 116                 //
 117                 // Changes the type of the constant expression `expr' to the Type `type'
 118                 // Returns null on failure.
 119                 //
 120                 public static Constant ChangeType (Location loc, Constant expr, Type type)
 121                 {
 122                         if (type == TypeManager.object_type)
 123                                 return expr;
 124
 125                         bool fail;
 126
 127                         // from the null type to any reference-type.
 128                         if (expr.Type == TypeManager.null_type && !type.IsValueType && !TypeManager.IsEnumType (type))
 129                                 return NullLiteral.Null;
 130
 131                         if (!Convert.ImplicitStandardConversionExists (Convert.ConstantEC, expr, type)){
 132                                 Convert.Error_CannotImplicitConversion (loc, expr.Type, type);
 133                                 return null;
 134                         }
 135
 136                         // Special-case: The 0 literal can be converted to an enum value,
 137                         // and ImplicitStandardConversionExists will return true in that case.
 138                         if (expr.Type == TypeManager.int32_type && TypeManager.IsEnumType (type)){
 139                                 if (expr is IntLiteral && ((IntLiteral) expr).Value == 0)
 140                                         return new EnumConstant (expr, type);
 141                         }
 142
 143                         object constant_value = TypeManager.ChangeType (expr.GetValue (), type, out fail);
 144                         if (fail){
 145                                 Convert.Error_CannotImplicitConversion (loc, expr.Type, type);
 146
 147                                 //
 148                                 // We should always catch the error before this is ever
 149                                 // reached, by calling Convert.ImplicitStandardConversionExists
 150                                 //
 151                                 throw new Exception (
 152                                                      String.Format ("LookupConstantValue: This should never be reached {0} {1}", expr.Type, type));
 153                         }
 154
 155                         Constant retval;
 156                         if (type == TypeManager.int32_type)
 157                                 retval = new IntConstant ((int) constant_value);
 158                         else if (type == TypeManager.uint32_type)
 159                                 retval = new UIntConstant ((uint) constant_value);
 160                         else if (type == TypeManager.int64_type)
 161                                 retval = new LongConstant ((long) constant_value);
 162                         else if (type == TypeManager.uint64_type)
 163                                 retval = new ULongConstant ((ulong) constant_value);
 164                         else if (type == TypeManager.float_type)
 165                                 retval = new FloatConstant ((float) constant_value);
 166                         else if (type == TypeManager.double_type)
 167                                 retval = new DoubleConstant ((double) constant_value);
 168                         else if (type == TypeManager.string_type)
 169                                 retval = new StringConstant ((string) constant_value);
 170                         else if (type == TypeManager.short_type)
 171                                 retval = new ShortConstant ((short) constant_value);
 172                         else if (type == TypeManager.ushort_type)
 173                                 retval = new UShortConstant ((ushort) constant_value);
 174                         else if (type == TypeManager.sbyte_type)
 175                                 retval = new SByteConstant ((sbyte) constant_value);
 176                         else if (type == TypeManager.byte_type)
 177                                 retval = new ByteConstant ((byte) constant_value);
 178                         else if (type == TypeManager.char_type)
 179                                 retval = new CharConstant ((char) constant_value);
 180                         else if (type == TypeManager.bool_type)
 181                                 retval = new BoolConstant ((bool) constant_value);
 182                         else if (type == TypeManager.decimal_type)
 183                                 retval = new DecimalConstant ((decimal) constant_value);
 184                         else
 185                                 throw new Exception ("LookupConstantValue: Unhandled constant type: " + type);
 186
 187                         return retval;
 188                 }
 189
 190                 /// <summary>
 191                 ///  Looks up the value of a constant field. Defines it if it hasn't
 192                 ///  already been. Similar to LookupEnumValue in spirit.
 193                 /// </summary>
 194                 public bool LookupConstantValue (out object value)
 195                 {
 196                         if (resolved) {
 197                                 value = ConstantValue;
 198                                 return true;
 199                         }
 200
 201                         if (in_transit) {
 202                                 Report.Error (110, Location,
 203                                               "The evaluation of the constant value for `" +
 204                                               Name + "' involves a circular definition.");
 205                                 value = null;
 206                                 return false;
 207                         }
 208
 209                         in_transit = true;
 210                         int errors = Report.Errors;
 211
 212                         //
 213                         // We might have cleared Expr ourselves in a recursive definition
 214                         //
 215                         if (Expr == null){
 216                                 value = null;
 217                                 return false;
 218                         }
 219
 220                         Expr = Expr.Resolve (const_ec);
 221
 222                         in_transit = false;
 223
 224                         if (Expr == null) {
 225                                 if (errors == Report.Errors)
 226                                         Report.Error (150, Location, "A constant value is expected");
 227                                 value = null;
 228                                 return false;
 229                         }
 230
 231                         Expression real_expr = Expr;
 232
 233                         Constant ce = Expr as Constant;
 234                         if (ce == null){
 235                                 UnCheckedExpr un_expr = Expr as UnCheckedExpr;
 236                                 CheckedExpr ch_expr = Expr as CheckedExpr;
 237                                 EmptyCast ec_expr = Expr as EmptyCast;
 238
 239                                 if ((un_expr != null) && (un_expr.Expr is Constant))
 240                                         Expr = un_expr.Expr;
 241                                 else if ((ch_expr != null) && (ch_expr.Expr is Constant))
 242                                         Expr = ch_expr.Expr;
 243                                 else if ((ec_expr != null) && (ec_expr.Child is Constant))
 244                                         Expr = ec_expr.Child;
 245                                 else if (Expr is ArrayCreation){
 246                                         Report.Error (133, Location, "Arrays can not be constant");
 247                                 } else {
 248                                         if (errors == Report.Errors)
 249                                                 Report.Error (150, Location, "A constant value is expected");
 250                                         value = null;
 251                                         return false;
 252                                 }
 253
 254                                 ce = Expr as Constant;
 255                         }
 256
 257                         if (MemberType != real_expr.Type) {
 258                                 ce = ChangeType (Location, ce, MemberType);
 259                                 if (ce == null){
 260                                         value = null;
 261                                         return false;
 262                                 }
 263                                 Expr = ce;
 264                         }
 265
 266                         if (ce != null)
 267                                 ConstantValue = ce.GetValue ();
 268
 269                         if (MemberType.IsEnum){
 270                                 //
 271                                 // This sadly does not work for our user-defined enumerations types ;-(
 272                                 //
 273                                 try {
 274                                         ConstantValue = System.Enum.ToObject (
 275                                                 MemberType, ConstantValue);
 276                                 } catch (ArgumentException){
 277                                         Report.Error (
 278                                                 -16, Location,
 279                                                 ".NET SDK 1.0 does not permit to create the constant "+
 280                                                 " field from a user-defined enumeration");
 281                                 }
 282                         }
 283
 284                         if (ce is DecimalConstant) {
 285                                 Decimal d = ((DecimalConstant)ce).Value;
 286                                 int[] bits = Decimal.GetBits (d);
 287                                 object[] args = new object[] { (byte)(bits [3] >> 16), (byte)(bits [3] >> 31), (uint)bits [2], (uint)bits [1], (uint)bits [0] };
 288                                 CustomAttributeBuilder cab = new CustomAttributeBuilder (TypeManager.decimal_constant_attribute_ctor, args);
 289                                 FieldBuilder.SetCustomAttribute (cab);
 290                         }
 291                         else{
 292                                 FieldBuilder.SetConstant (ConstantValue);
 293                         }
 294
 295                         if (!TypeManager.RegisterFieldValue (FieldBuilder, ConstantValue))
 296                                 throw new Exception ("Cannot register const value");
 297
 298                         value = ConstantValue;
 299                         resolved = true;
 300                         return true;
 301                 }
 302
 303
 304                 /// <summary>
 305                 ///  Emits the field value by evaluating the expression
 306                 /// </summary>
 307                 public override void Emit ()
 308                 {
 309                         object value;
 310                         LookupConstantValue (out value);
 311                         base.Emit ();
 312                 }
 313         }
 314 }
 315
 316