src/Types.h
author David Anderson <dvander@alliedmods.net>
Sat Dec 22 16:21:43 2012 -0800 (2012-12-22)
changeset 225 e89c6980e8ff
parent 222 0cde1379b29f
child 233 bbb498ccb4ac
permissions -rw-r--r--
Add ref-expr test.
dvander@44
     1
/* vim: set ts=4 sw=4 tw=99 et:
dvander@44
     2
 *
dvander@0
     3
 * Copyright (C) 2012 David Anderson
dvander@0
     4
 *
dvander@0
     5
 * This file is part of JITCraft.
dvander@0
     6
 *
dvander@0
     7
 * JITCraft is free software: you can redistribute it and/or modify it under
dvander@0
     8
 * the terms of the GNU General Public License as published by the Free
dvander@0
     9
 * Software Foundation, either version 3 of the License, or (at your option)
dvander@0
    10
 * any later version.
dvander@0
    11
 * 
dvander@0
    12
 * Foobar is distributed in the hope that it will be useful, but WITHOUT ANY
dvander@0
    13
 * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
dvander@0
    14
 * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
dvander@0
    15
 *
dvander@0
    16
 * You should have received a copy of the GNU General Public License along with
dvander@0
    17
 * JITCraft. If not, see http://www.gnu.org/licenses/.
dvander@0
    18
 */
dvander@0
    19
#ifndef _include_jc_types_h_
dvander@0
    20
#define _include_jc_types_h_
dvander@0
    21
dvander@11
    22
#include "Heap.h"
dvander@13
    23
#include "Barriers.h"
dvander@14
    24
#include "FixedArray.h"
dvander@195
    25
#include "compiler/Token.h"
dvander@0
    26
dvander@59
    27
namespace ke {
dvander@0
    28
dvander@54
    29
class String;
dvander@148
    30
class Descriptor;
dvander@195
    31
class StructMap;
dvander@209
    32
class ArrayMap;
dvander@54
    33
dvander@187
    34
#define MAX_ARRAY_DEPTH     5
dvander@187
    35
dvander@0
    36
enum PrimitiveType
dvander@0
    37
{
dvander@145
    38
    // A boolean type semantically represents 0 or 1. As an optimization, its
dvander@145
    39
    // internal storage type is the same as int32, and any non-zero value
dvander@145
    40
    // compares positively to "true".
dvander@145
    41
    PrimitiveType_Bool,
dvander@145
    42
dvander@145
    43
    // A character is an arbitrary 8-bit value. Characters are not supported
dvander@145
    44
    // as a normal storage class; they may only be used for arrays. When read
dvander@145
    45
    // from an array, they are immediately sign extended to 32 bits. Integers
dvander@145
    46
    // stored into an char array are truncated to 8 bits.
dvander@21
    47
    PrimitiveType_Char,         // signed, 8-bit character
dvander@145
    48
dvander@145
    49
    // Enumerations and untyped variables are stored as signed, 32-bit integers.
dvander@145
    50
    PrimitiveType_Int32,
dvander@145
    51
dvander@145
    52
    // Floating point values are 32-bit IEEE-754 floats. This is required ro
dvander@145
    53
    // SourcePawn 1 compatibility.
dvander@145
    54
    PrimitiveType_Float,
dvander@145
    55
dvander@145
    56
    // This is a native-sized integer type (32-bit on 32-bit systems, 64-bit
dvander@145
    57
    // on 64-bit systems), and does not exist in language semantics.
dvander@145
    58
    PrimitiveType_Native,
dvander@145
    59
dvander@11
    60
    PrimitiveTypes_Total
dvander@0
    61
};
dvander@0
    62
dvander@12
    63
class Type : public Object
dvander@0
    64
{
dvander@195
    65
  protected:
dvander@0
    66
    enum Kind {
dvander@167
    67
        // A primitive is a plain-old-data type.
dvander@0
    68
        PRIMITIVE,
dvander@167
    69
dvander@167
    70
        // An array is a fixed-length vector of any other type.
dvander@14
    71
        ARRAY,
dvander@188
    72
        EXTERNAL_ARRAY,
dvander@167
    73
dvander@167
    74
        // A reference type may only be specified on parameters, and
dvander@167
    75
        // references may only be computed to primitives or enums.
dvander@14
    76
        REFERENCE,
dvander@167
    77
dvander@167
    78
        // A function type encapsulates a function signature.
dvander@68
    79
        FUNCTION,
dvander@167
    80
dvander@167
    81
        // Void is an internal type used to specify that a function returns no
dvander@167
    82
        // value.
dvander@145
    83
        VOID,
dvander@167
    84
dvander@167
    85
        // Enums are plain-old-data with int32 storage. They allow for extra
dvander@167
    86
        // type checking that would not be possible with integers.
dvander@146
    87
        ENUM,
dvander@167
    88
dvander@167
    89
        // Structs are composite records that may contain primitives, arrays,
dvander@167
    90
        // functions, enums, and other structs.
dvander@167
    91
        STRUCT,
dvander@167
    92
dvander@167
    93
        // Unchecked is a magic type that has implicit, bitwise coercion to
dvander@167
    94
        // int32, float, bool, or an enum.
dvander@167
    95
        UNCHECKED
dvander@0
    96
    };
dvander@0
    97
dvander@11
    98
  private:
dvander@11
    99
    Kind kind() {
dvander@13
   100
        return kind_;
dvander@11
   101
    }
dvander@11
   102
dvander@212
   103
  public:   
dvander@71
   104
    static Type *NewVoid(Zone *zone);
dvander@167
   105
    static Type *NewUnchecked(Zone *zone);
dvander@12
   106
    static Type *NewPrimitive(Zone *zone, PrimitiveType type);
dvander@145
   107
    static Type *NewEnum(Zone *zone, Handle<String> name);
dvander@0
   108
dvander@63
   109
    static bool Compare(Type *left, Type *right);
dvander@63
   110
dvander@11
   111
    static Type *cast(Object *obj) {
dvander@195
   112
        assert(!obj ||
dvander@195
   113
               obj->is(MapKind_Type) ||
dvander@195
   114
               obj->is(MapKind_FunctionType) ||
dvander@209
   115
               obj->is(MapKind_StructType) ||
dvander@222
   116
               obj->is(MapKind_ArrayType) ||
dvander@222
   117
               obj->is(MapKind_ReferenceType));
dvander@11
   118
        return (Type *)obj;
dvander@0
   119
    }
dvander@11
   120
dvander@11
   121
    bool isPrimitive() {
dvander@11
   122
        return kind() == PRIMITIVE;
dvander@11
   123
    }
dvander@11
   124
    bool isArray() {
dvander@188
   125
        return kind() == ARRAY || kind() == EXTERNAL_ARRAY;
dvander@0
   126
    }
dvander@14
   127
    bool isReference() {
dvander@14
   128
        return kind() == REFERENCE;
dvander@14
   129
    }
dvander@14
   130
    bool isFunction() {
dvander@195
   131
        return kind() == FUNCTION;
dvander@68
   132
    }
dvander@71
   133
    bool isVoid() {
dvander@71
   134
        return kind() == VOID;
dvander@71
   135
    }
dvander@167
   136
    bool isUnchecked() {
dvander@167
   137
        return kind() == UNCHECKED;
dvander@167
   138
    }
dvander@147
   139
    bool isStruct() {
dvander@147
   140
        return kind() == STRUCT;
dvander@147
   141
    }
dvander@11
   142
    PrimitiveType primitive() {
dvander@0
   143
        assert(isPrimitive());
dvander@13
   144
        return primitive_;
dvander@0
   145
    }
dvander@168
   146
    bool isPod() {
dvander@168
   147
        return isPrimitive() || isEnum() || isUnchecked();
dvander@168
   148
    }
dvander@145
   149
    PrimitiveType pod() {
dvander@168
   150
        assert(isPod());
dvander@145
   151
        return isPrimitive()
dvander@152
   152
               ? (primitive() == PrimitiveType_Bool)
dvander@152
   153
                 ? PrimitiveType_Int32
dvander@152
   154
                 : primitive()
dvander@145
   155
               : PrimitiveType_Int32;
dvander@145
   156
    }
dvander@212
   157
    bool isChar() {
dvander@212
   158
        return isPrimitive() && primitive() == PrimitiveType_Char;
dvander@212
   159
    }
dvander@11
   160
    bool isFloat() {
dvander@4
   161
        return isPrimitive() && primitive() == PrimitiveType_Float;
dvander@4
   162
    }
dvander@20
   163
    bool isInt32() {
dvander@4
   164
        return isPrimitive() && primitive() == PrimitiveType_Int32;
dvander@4
   165
    }
dvander@145
   166
    bool isInt32OrEnum() {
dvander@145
   167
        return isInt32() || isEnum();
dvander@145
   168
    }
dvander@147
   169
    bool isBool() {
dvander@147
   170
        return isPrimitive() && primitive() == PrimitiveType_Bool;
dvander@147
   171
    }
dvander@188
   172
    bool isExternalArray() {
dvander@188
   173
        return kind() == EXTERNAL_ARRAY;
dvander@188
   174
    }
dvander@47
   175
    bool isTraceable() {
dvander@47
   176
        return !isPrimitive();
dvander@47
   177
    }
dvander@67
   178
    bool isConst() {
dvander@188
   179
        assert(isPrimitive() ||
dvander@188
   180
               isArray() ||
dvander@188
   181
               isReference());
dvander@67
   182
        return const_;
dvander@67
   183
    }
dvander@145
   184
    bool isEnum() {
dvander@145
   185
        return kind() == ENUM;
dvander@145
   186
    }
dvander@145
   187
dvander@145
   188
    String *name() {
dvander@147
   189
        assert(isEnum() || isStruct());
dvander@145
   190
        return name_;
dvander@145
   191
    }
dvander@147
   192
dvander@44
   193
    // GC Descriptor.
dvander@145
   194
    static inline size_t offsetOfName() {
dvander@145
   195
        return OFFSETOF(Type, name_);
dvander@54
   196
    }
dvander@44
   197
    // End GC Descriptor.
dvander@44
   198
dvander@195
   199
  protected:
dvander@13
   200
    Kind kind_;
dvander@13
   201
    PrimitiveType primitive_;
dvander@0
   202
dvander@67
   203
    // Primitives, arrays, and references.
dvander@67
   204
    bool const_;
dvander@67
   205
dvander@209
   206
    // Enums and structs only.
dvander@209
   207
    Barriered<String> name_;
dvander@209
   208
};
dvander@209
   209
dvander@222
   210
class ReferenceType : public Type
dvander@222
   211
{
dvander@222
   212
  public:
dvander@222
   213
    static ReferenceType *New(Zone *zone, Handle<Type> contained);
dvander@222
   214
    
dvander@222
   215
    Type *contained() {
dvander@222
   216
        return contained_;
dvander@222
   217
    }
dvander@222
   218
dvander@222
   219
    // GC Descriptor.
dvander@222
   220
    static inline size_t offsetOfContained() {
dvander@222
   221
        return OFFSETOF(ReferenceType, contained_);
dvander@222
   222
    }
dvander@222
   223
    // End GC Descriptor.
dvander@222
   224
dvander@222
   225
    static ReferenceType *cast(Object *obj) {
dvander@222
   226
        assert(!obj || obj->is(MapKind_ReferenceType));
dvander@222
   227
        return (ReferenceType *)obj;
dvander@222
   228
    }
dvander@222
   229
dvander@222
   230
  private:
dvander@222
   231
    Barriered<Type> contained_;
dvander@222
   232
};
dvander@222
   233
dvander@209
   234
class ArrayType : public Type
dvander@209
   235
{
dvander@209
   236
  public:
dvander@212
   237
    static const int DYNAMIC_ARRAY_SIZE = -1;
dvander@212
   238
dvander@209
   239
    static ArrayType *New(Zone *zone, Handle<Type> contained, int elements);
dvander@209
   240
    static ArrayType *NewExternal(Zone *zone, Handle<Type> contained);
dvander@209
   241
dvander@209
   242
    Type *innermost() {
dvander@209
   243
        assert(isArray());
dvander@209
   244
        Type *temp = contained();
dvander@209
   245
        while (temp->isArray())
dvander@209
   246
            temp = ArrayType::cast(temp)->contained();
dvander@209
   247
        return temp;
dvander@209
   248
    }
dvander@209
   249
dvander@209
   250
    Type *contained() {
dvander@209
   251
        return contained_;
dvander@209
   252
    }
dvander@209
   253
    bool isFixedLength() {
dvander@209
   254
        assert(isArray());
dvander@209
   255
        return elements_ > 0;
dvander@209
   256
    }
dvander@209
   257
    bool isCharArray() {
dvander@209
   258
        return contained()->isPrimitive() &&
dvander@209
   259
               contained()->primitive() == PrimitiveType_Char;
dvander@209
   260
    }
dvander@209
   261
    unsigned fixedLength() {
dvander@209
   262
        assert(isFixedLength());
dvander@209
   263
        return elements_;
dvander@209
   264
    }
dvander@209
   265
    unsigned levels() {
dvander@209
   266
        assert(isArray());
dvander@209
   267
        return levels_;
dvander@209
   268
    }
dvander@209
   269
    bool hasInlineElements() {
dvander@209
   270
        assert(isArray());
dvander@209
   271
dvander@209
   272
        // We don't allocate traceable elements inline, since there's no
dvander@209
   273
        // point to the optimization; we're going to be allocating lots of
dvander@209
   274
        // objects anyway (in theory).
dvander@209
   275
        return isFixedLength() && !contained()->isTraceable();
dvander@209
   276
    }
dvander@209
   277
dvander@209
   278
    // Arrays of this type can be created with this cached map.
dvander@209
   279
    ArrayMap *newMap() {
dvander@209
   280
        return newMap_;
dvander@209
   281
    }
dvander@209
   282
    void setNewMap(ArrayMap *map) {
dvander@209
   283
        assert(!newMap());
dvander@209
   284
        newMap_ = map;
dvander@209
   285
    }
dvander@209
   286
dvander@209
   287
    // GC Descriptor.
dvander@209
   288
    static inline size_t offsetOfContained() {
dvander@209
   289
        return OFFSETOF(ArrayType, contained_);
dvander@209
   290
    }
dvander@209
   291
    static inline size_t offsetOfNewMap() {
dvander@209
   292
        return OFFSETOF(ArrayType, newMap_);
dvander@209
   293
    }
dvander@209
   294
    // End GC Descriptor.
dvander@209
   295
dvander@209
   296
    static ArrayType *cast(Object *obj) {
dvander@209
   297
        assert(!obj || obj->is(MapKind_ArrayType));
dvander@209
   298
        return (ArrayType *)obj;
dvander@209
   299
    }
dvander@209
   300
dvander@209
   301
  private:
dvander@13
   302
    int32 elements_;
dvander@13
   303
    unsigned levels_;
dvander@13
   304
    Barriered<Type> contained_;
dvander@209
   305
    Barriered<ArrayMap> newMap_;
dvander@195
   306
};
dvander@195
   307
dvander@195
   308
class StructType : public Type
dvander@195
   309
{
dvander@195
   310
  public:
dvander@195
   311
    static StructType *New(Zone *zone, Handle<String> name, Handle<FixedArray> fields);
dvander@195
   312
dvander@195
   313
    FixedArray *fields() {
dvander@195
   314
        assert(isStruct());
dvander@195
   315
        return fields_;
dvander@195
   316
    }
dvander@195
   317
    Descriptor *lookupField(Handle<String> name, unsigned *index = NULL);
dvander@195
   318
dvander@195
   319
    // Objects of this type can be created with this cached map.
dvander@195
   320
    StructMap *newMap() {
dvander@195
   321
        return newMap_;
dvander@195
   322
    }
dvander@195
   323
    void setNewMap(StructMap *map) {
dvander@195
   324
        assert(!newMap());
dvander@195
   325
        newMap_ = map;
dvander@195
   326
    }
dvander@195
   327
dvander@195
   328
    // GC Descriptor.
dvander@195
   329
    static inline size_t offsetOfFields() {
dvander@195
   330
        return OFFSETOF(StructType, fields_);
dvander@195
   331
    }
dvander@195
   332
    static inline size_t offsetOfNewMap() {
dvander@195
   333
        return OFFSETOF(StructType, newMap_);
dvander@195
   334
    }
dvander@195
   335
    // End GC Descriptor.
dvander@195
   336
dvander@195
   337
    static StructType *cast(Object *obj) {
dvander@195
   338
        assert(!obj || obj->is(MapKind_StructType));
dvander@195
   339
        return (StructType *)obj;
dvander@195
   340
    }
dvander@195
   341
dvander@195
   342
  private:
dvander@195
   343
    // Structs only.
dvander@195
   344
    Barriered<FixedArray> fields_;
dvander@195
   345
    Barriered<StructMap> newMap_;
dvander@195
   346
};
dvander@195
   347
dvander@195
   348
class FunctionType : public Type
dvander@195
   349
{
dvander@195
   350
  public:
dvander@195
   351
    static FunctionType *New(Zone *zone, TokenKind kind);
dvander@195
   352
dvander@195
   353
    Type *parameterAt(size_t i) {
dvander@195
   354
        return Type::cast(parameters()->at(i));
dvander@195
   355
    }
dvander@195
   356
    Type *returnType() {
dvander@195
   357
        assert(isFunction());
dvander@195
   358
        return returnType_;
dvander@195
   359
    }
dvander@195
   360
    FixedArray *parameters() {
dvander@195
   361
        assert(isFunction());
dvander@195
   362
        return parameters_;
dvander@195
   363
    }
dvander@195
   364
    FixedArray *defaults() {
dvander@195
   365
        assert(isFunction());
dvander@195
   366
        return defaults_;
dvander@195
   367
    }
dvander@195
   368
    bool isNative() {
dvander@195
   369
        return token_ == TOK_NATIVE;
dvander@195
   370
    }
dvander@195
   371
    bool isForward() {
dvander@195
   372
        return token_ == TOK_FORWARD;
dvander@195
   373
    }
dvander@195
   374
    bool isNativeVariadic() {
dvander@195
   375
        assert(isNative());
dvander@195
   376
        return variadicNative_;
dvander@195
   377
    }
dvander@195
   378
    void setReturnType(Handle<Type> returnType) {
dvander@195
   379
        assert(!returnType_);
dvander@195
   380
        returnType_ = returnType;
dvander@195
   381
    }
dvander@195
   382
    void setParameterTypes(Handle<FixedArray> types) {
dvander@195
   383
        assert(!parameters_);
dvander@195
   384
        parameters_ = types;
dvander@195
   385
    }
dvander@195
   386
    TokenKind token() {
dvander@195
   387
        return token_;
dvander@195
   388
    }
dvander@195
   389
dvander@195
   390
    // GC Descriptor.
dvander@195
   391
    static inline size_t offsetOfReturnType() {
dvander@195
   392
        return OFFSETOF(FunctionType, returnType_);
dvander@195
   393
    }
dvander@195
   394
    static inline size_t offsetOfParameters() {
dvander@195
   395
        return OFFSETOF(FunctionType, parameters_);
dvander@195
   396
    }
dvander@195
   397
    static inline size_t offsetOfDefaults() {
dvander@195
   398
        return OFFSETOF(FunctionType, defaults_);
dvander@195
   399
    }
dvander@195
   400
    // End GC Descriptor.
dvander@195
   401
dvander@195
   402
    static FunctionType *cast(Object *obj) {
dvander@195
   403
        assert(!obj || obj->is(MapKind_FunctionType));
dvander@195
   404
        return (FunctionType *)obj;
dvander@195
   405
    }
dvander@195
   406
dvander@195
   407
  private:
dvander@14
   408
    // Functions only.
dvander@14
   409
    Barriered<Type> returnType_;
dvander@14
   410
    Barriered<FixedArray> parameters_;
dvander@168
   411
    Barriered<FixedArray> defaults_;
dvander@195
   412
    TokenKind token_;
dvander@68
   413
    bool variadicNative_;
dvander@0
   414
};
dvander@0
   415
dvander@2
   416
class BoxedPrimitive
dvander@2
   417
{
dvander@2
   418
    PrimitiveType type_;
dvander@2
   419
    union {
dvander@2
   420
        int i_;
dvander@172
   421
        float f_;
dvander@2
   422
    };
dvander@2
   423
dvander@2
   424
  public:
dvander@2
   425
    static BoxedPrimitive Int(int i) {
dvander@2
   426
        BoxedPrimitive b;
dvander@2
   427
        b.type_ = PrimitiveType_Int32;
dvander@2
   428
        b.i_ = i;
dvander@2
   429
        return b;
dvander@2
   430
    }
dvander@172
   431
    static BoxedPrimitive Float(float f) {
dvander@168
   432
        BoxedPrimitive b;
dvander@172
   433
        b.type_ = PrimitiveType_Float;
dvander@172
   434
        b.f_ = f;
dvander@168
   435
        return b;
dvander@168
   436
    }
dvander@2
   437
dvander@2
   438
    PrimitiveType type() const {
dvander@2
   439
        return type_;
dvander@2
   440
    }
dvander@2
   441
    int toInt() const {
dvander@2
   442
        assert(type() == PrimitiveType_Int32);
dvander@2
   443
        return i_;
dvander@2
   444
    }
dvander@172
   445
    float toFloat() const {
dvander@172
   446
        assert(type() == PrimitiveType_Float);
dvander@172
   447
        return f_;
dvander@168
   448
    }
dvander@2
   449
};
dvander@2
   450
dvander@195
   451
const char *GetTypeName(Type *type);
dvander@195
   452
dvander@0
   453
}
dvander@0
   454
dvander@0
   455
#endif // _include_jc_types_h_