src/Types.h
author David Anderson <dvander@alliedmods.net>
Sat Nov 17 23:11:38 2012 -0800 (2012-11-17)
changeset 209 5cbec15fadfe
parent 195 c1ba166f3fc4
child 212 443d24cfdf2d
permissions -rw-r--r--
Split ArrayType from Type.
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@0
   103
  public:
dvander@184
   104
    static const int DYNAMIC_ARRAY_SIZE = -1;
dvander@11
   105
    
dvander@71
   106
    static Type *NewVoid(Zone *zone);
dvander@167
   107
    static Type *NewUnchecked(Zone *zone);
dvander@12
   108
    static Type *NewPrimitive(Zone *zone, PrimitiveType type);
dvander@67
   109
    static Type *NewReference(Zone *zone, Handle<Type> contained, bool isConst);
dvander@145
   110
    static Type *NewEnum(Zone *zone, Handle<String> name);
dvander@0
   111
dvander@63
   112
    static bool Compare(Type *left, Type *right);
dvander@63
   113
dvander@11
   114
    static Type *cast(Object *obj) {
dvander@195
   115
        assert(!obj ||
dvander@195
   116
               obj->is(MapKind_Type) ||
dvander@195
   117
               obj->is(MapKind_FunctionType) ||
dvander@209
   118
               obj->is(MapKind_StructType) ||
dvander@209
   119
               obj->is(MapKind_ArrayType));
dvander@11
   120
        return (Type *)obj;
dvander@0
   121
    }
dvander@11
   122
dvander@11
   123
    bool isPrimitive() {
dvander@11
   124
        return kind() == PRIMITIVE;
dvander@11
   125
    }
dvander@11
   126
    bool isArray() {
dvander@188
   127
        return kind() == ARRAY || kind() == EXTERNAL_ARRAY;
dvander@0
   128
    }
dvander@14
   129
    bool isReference() {
dvander@14
   130
        return kind() == REFERENCE;
dvander@14
   131
    }
dvander@14
   132
    bool isFunction() {
dvander@195
   133
        return kind() == FUNCTION;
dvander@68
   134
    }
dvander@71
   135
    bool isVoid() {
dvander@71
   136
        return kind() == VOID;
dvander@71
   137
    }
dvander@167
   138
    bool isUnchecked() {
dvander@167
   139
        return kind() == UNCHECKED;
dvander@167
   140
    }
dvander@147
   141
    bool isStruct() {
dvander@147
   142
        return kind() == STRUCT;
dvander@147
   143
    }
dvander@11
   144
    PrimitiveType primitive() {
dvander@0
   145
        assert(isPrimitive());
dvander@13
   146
        return primitive_;
dvander@0
   147
    }
dvander@168
   148
    bool isPod() {
dvander@168
   149
        return isPrimitive() || isEnum() || isUnchecked();
dvander@168
   150
    }
dvander@145
   151
    PrimitiveType pod() {
dvander@168
   152
        assert(isPod());
dvander@145
   153
        return isPrimitive()
dvander@152
   154
               ? (primitive() == PrimitiveType_Bool)
dvander@152
   155
                 ? PrimitiveType_Int32
dvander@152
   156
                 : primitive()
dvander@145
   157
               : PrimitiveType_Int32;
dvander@145
   158
    }
dvander@11
   159
    bool isFloat() {
dvander@4
   160
        return isPrimitive() && primitive() == PrimitiveType_Float;
dvander@4
   161
    }
dvander@20
   162
    bool isInt32() {
dvander@4
   163
        return isPrimitive() && primitive() == PrimitiveType_Int32;
dvander@4
   164
    }
dvander@145
   165
    bool isInt32OrEnum() {
dvander@145
   166
        return isInt32() || isEnum();
dvander@145
   167
    }
dvander@147
   168
    bool isBool() {
dvander@147
   169
        return isPrimitive() && primitive() == PrimitiveType_Bool;
dvander@147
   170
    }
dvander@188
   171
    bool isExternalArray() {
dvander@188
   172
        return kind() == EXTERNAL_ARRAY;
dvander@188
   173
    }
dvander@47
   174
    bool isTraceable() {
dvander@47
   175
        return !isPrimitive();
dvander@47
   176
    }
dvander@67
   177
    bool isConst() {
dvander@188
   178
        assert(isPrimitive() ||
dvander@188
   179
               isArray() ||
dvander@188
   180
               isReference());
dvander@67
   181
        return const_;
dvander@67
   182
    }
dvander@145
   183
    bool isEnum() {
dvander@145
   184
        return kind() == ENUM;
dvander@145
   185
    }
dvander@145
   186
dvander@145
   187
    String *name() {
dvander@147
   188
        assert(isEnum() || isStruct());
dvander@145
   189
        return name_;
dvander@145
   190
    }
dvander@209
   191
    Type *contained_ref() {
dvander@195
   192
        assert(false);
dvander@195
   193
        return NULL;
dvander@148
   194
    }
dvander@147
   195
dvander@44
   196
    // GC Descriptor.
dvander@145
   197
    static inline size_t offsetOfName() {
dvander@145
   198
        return OFFSETOF(Type, name_);
dvander@54
   199
    }
dvander@44
   200
    // End GC Descriptor.
dvander@44
   201
dvander@195
   202
  protected:
dvander@13
   203
    Kind kind_;
dvander@13
   204
    PrimitiveType primitive_;
dvander@0
   205
dvander@67
   206
    // Primitives, arrays, and references.
dvander@67
   207
    bool const_;
dvander@67
   208
dvander@209
   209
    // Enums and structs only.
dvander@209
   210
    Barriered<String> name_;
dvander@209
   211
};
dvander@209
   212
dvander@209
   213
class ArrayType : public Type
dvander@209
   214
{
dvander@209
   215
  public:
dvander@209
   216
    static ArrayType *New(Zone *zone, Handle<Type> contained, int elements);
dvander@209
   217
    static ArrayType *NewExternal(Zone *zone, Handle<Type> contained);
dvander@209
   218
dvander@209
   219
    Type *innermost() {
dvander@209
   220
        assert(isArray());
dvander@209
   221
        Type *temp = contained();
dvander@209
   222
        while (temp->isArray())
dvander@209
   223
            temp = ArrayType::cast(temp)->contained();
dvander@209
   224
        return temp;
dvander@209
   225
    }
dvander@209
   226
dvander@209
   227
    Type *contained() {
dvander@209
   228
        return contained_;
dvander@209
   229
    }
dvander@209
   230
    bool isFixedLength() {
dvander@209
   231
        assert(isArray());
dvander@209
   232
        return elements_ > 0;
dvander@209
   233
    }
dvander@209
   234
    bool isCharArray() {
dvander@209
   235
        return contained()->isPrimitive() &&
dvander@209
   236
               contained()->primitive() == PrimitiveType_Char;
dvander@209
   237
    }
dvander@209
   238
    unsigned fixedLength() {
dvander@209
   239
        assert(isFixedLength());
dvander@209
   240
        return elements_;
dvander@209
   241
    }
dvander@209
   242
    unsigned levels() {
dvander@209
   243
        assert(isArray());
dvander@209
   244
        return levels_;
dvander@209
   245
    }
dvander@209
   246
    bool hasInlineElements() {
dvander@209
   247
        assert(isArray());
dvander@209
   248
dvander@209
   249
        // We don't allocate traceable elements inline, since there's no
dvander@209
   250
        // point to the optimization; we're going to be allocating lots of
dvander@209
   251
        // objects anyway (in theory).
dvander@209
   252
        return isFixedLength() && !contained()->isTraceable();
dvander@209
   253
    }
dvander@209
   254
dvander@209
   255
    // Arrays of this type can be created with this cached map.
dvander@209
   256
    ArrayMap *newMap() {
dvander@209
   257
        return newMap_;
dvander@209
   258
    }
dvander@209
   259
    void setNewMap(ArrayMap *map) {
dvander@209
   260
        assert(!newMap());
dvander@209
   261
        newMap_ = map;
dvander@209
   262
    }
dvander@209
   263
dvander@209
   264
    // GC Descriptor.
dvander@209
   265
    static inline size_t offsetOfContained() {
dvander@209
   266
        return OFFSETOF(ArrayType, contained_);
dvander@209
   267
    }
dvander@209
   268
    static inline size_t offsetOfNewMap() {
dvander@209
   269
        return OFFSETOF(ArrayType, newMap_);
dvander@209
   270
    }
dvander@209
   271
    // End GC Descriptor.
dvander@209
   272
dvander@209
   273
    static ArrayType *cast(Object *obj) {
dvander@209
   274
        assert(!obj || obj->is(MapKind_ArrayType));
dvander@209
   275
        return (ArrayType *)obj;
dvander@209
   276
    }
dvander@209
   277
dvander@209
   278
  private:
dvander@13
   279
    int32 elements_;
dvander@13
   280
    unsigned levels_;
dvander@13
   281
    Barriered<Type> contained_;
dvander@209
   282
    Barriered<ArrayMap> newMap_;
dvander@195
   283
};
dvander@195
   284
dvander@195
   285
class StructType : public Type
dvander@195
   286
{
dvander@195
   287
  public:
dvander@195
   288
    static StructType *New(Zone *zone, Handle<String> name, Handle<FixedArray> fields);
dvander@195
   289
dvander@195
   290
    FixedArray *fields() {
dvander@195
   291
        assert(isStruct());
dvander@195
   292
        return fields_;
dvander@195
   293
    }
dvander@195
   294
    Descriptor *lookupField(Handle<String> name, unsigned *index = NULL);
dvander@195
   295
dvander@195
   296
    // Objects of this type can be created with this cached map.
dvander@195
   297
    StructMap *newMap() {
dvander@195
   298
        return newMap_;
dvander@195
   299
    }
dvander@195
   300
    void setNewMap(StructMap *map) {
dvander@195
   301
        assert(!newMap());
dvander@195
   302
        newMap_ = map;
dvander@195
   303
    }
dvander@195
   304
dvander@195
   305
    // GC Descriptor.
dvander@195
   306
    static inline size_t offsetOfFields() {
dvander@195
   307
        return OFFSETOF(StructType, fields_);
dvander@195
   308
    }
dvander@195
   309
    static inline size_t offsetOfNewMap() {
dvander@195
   310
        return OFFSETOF(StructType, newMap_);
dvander@195
   311
    }
dvander@195
   312
    // End GC Descriptor.
dvander@195
   313
dvander@195
   314
    static StructType *cast(Object *obj) {
dvander@195
   315
        assert(!obj || obj->is(MapKind_StructType));
dvander@195
   316
        return (StructType *)obj;
dvander@195
   317
    }
dvander@195
   318
dvander@195
   319
  private:
dvander@195
   320
    // Structs only.
dvander@195
   321
    Barriered<FixedArray> fields_;
dvander@195
   322
    Barriered<StructMap> newMap_;
dvander@195
   323
};
dvander@195
   324
dvander@195
   325
class FunctionType : public Type
dvander@195
   326
{
dvander@195
   327
  public:
dvander@195
   328
    static FunctionType *New(Zone *zone, TokenKind kind);
dvander@195
   329
dvander@195
   330
    Type *parameterAt(size_t i) {
dvander@195
   331
        return Type::cast(parameters()->at(i));
dvander@195
   332
    }
dvander@195
   333
    Type *returnType() {
dvander@195
   334
        assert(isFunction());
dvander@195
   335
        return returnType_;
dvander@195
   336
    }
dvander@195
   337
    FixedArray *parameters() {
dvander@195
   338
        assert(isFunction());
dvander@195
   339
        return parameters_;
dvander@195
   340
    }
dvander@195
   341
    FixedArray *defaults() {
dvander@195
   342
        assert(isFunction());
dvander@195
   343
        return defaults_;
dvander@195
   344
    }
dvander@195
   345
    bool isNative() {
dvander@195
   346
        return token_ == TOK_NATIVE;
dvander@195
   347
    }
dvander@195
   348
    bool isForward() {
dvander@195
   349
        return token_ == TOK_FORWARD;
dvander@195
   350
    }
dvander@195
   351
    bool isNativeVariadic() {
dvander@195
   352
        assert(isNative());
dvander@195
   353
        return variadicNative_;
dvander@195
   354
    }
dvander@195
   355
    void setReturnType(Handle<Type> returnType) {
dvander@195
   356
        assert(!returnType_);
dvander@195
   357
        returnType_ = returnType;
dvander@195
   358
    }
dvander@195
   359
    void setParameterTypes(Handle<FixedArray> types) {
dvander@195
   360
        assert(!parameters_);
dvander@195
   361
        parameters_ = types;
dvander@195
   362
    }
dvander@195
   363
    TokenKind token() {
dvander@195
   364
        return token_;
dvander@195
   365
    }
dvander@195
   366
dvander@195
   367
    // GC Descriptor.
dvander@195
   368
    static inline size_t offsetOfReturnType() {
dvander@195
   369
        return OFFSETOF(FunctionType, returnType_);
dvander@195
   370
    }
dvander@195
   371
    static inline size_t offsetOfParameters() {
dvander@195
   372
        return OFFSETOF(FunctionType, parameters_);
dvander@195
   373
    }
dvander@195
   374
    static inline size_t offsetOfDefaults() {
dvander@195
   375
        return OFFSETOF(FunctionType, defaults_);
dvander@195
   376
    }
dvander@195
   377
    // End GC Descriptor.
dvander@195
   378
dvander@195
   379
    static FunctionType *cast(Object *obj) {
dvander@195
   380
        assert(!obj || obj->is(MapKind_FunctionType));
dvander@195
   381
        return (FunctionType *)obj;
dvander@195
   382
    }
dvander@195
   383
dvander@195
   384
  private:
dvander@14
   385
    // Functions only.
dvander@14
   386
    Barriered<Type> returnType_;
dvander@14
   387
    Barriered<FixedArray> parameters_;
dvander@168
   388
    Barriered<FixedArray> defaults_;
dvander@195
   389
    TokenKind token_;
dvander@68
   390
    bool variadicNative_;
dvander@0
   391
};
dvander@0
   392
dvander@2
   393
class BoxedPrimitive
dvander@2
   394
{
dvander@2
   395
    PrimitiveType type_;
dvander@2
   396
    union {
dvander@2
   397
        int i_;
dvander@172
   398
        float f_;
dvander@2
   399
    };
dvander@2
   400
dvander@2
   401
  public:
dvander@2
   402
    static BoxedPrimitive Int(int i) {
dvander@2
   403
        BoxedPrimitive b;
dvander@2
   404
        b.type_ = PrimitiveType_Int32;
dvander@2
   405
        b.i_ = i;
dvander@2
   406
        return b;
dvander@2
   407
    }
dvander@172
   408
    static BoxedPrimitive Float(float f) {
dvander@168
   409
        BoxedPrimitive b;
dvander@172
   410
        b.type_ = PrimitiveType_Float;
dvander@172
   411
        b.f_ = f;
dvander@168
   412
        return b;
dvander@168
   413
    }
dvander@2
   414
dvander@2
   415
    PrimitiveType type() const {
dvander@2
   416
        return type_;
dvander@2
   417
    }
dvander@2
   418
    int toInt() const {
dvander@2
   419
        assert(type() == PrimitiveType_Int32);
dvander@2
   420
        return i_;
dvander@2
   421
    }
dvander@172
   422
    float toFloat() const {
dvander@172
   423
        assert(type() == PrimitiveType_Float);
dvander@172
   424
        return f_;
dvander@168
   425
    }
dvander@2
   426
};
dvander@2
   427
dvander@195
   428
const char *GetTypeName(Type *type);
dvander@195
   429
dvander@0
   430
}
dvander@0
   431
dvander@0
   432
#endif // _include_jc_types_h_