elements-kind.h 8.33 KB
Newer Older
1
// Copyright 2012 the V8 project authors. All rights reserved.
2 3
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
4 5 6 7

#ifndef V8_ELEMENTS_KIND_H_
#define V8_ELEMENTS_KIND_H_

8
#include "src/base/macros.h"
9
#include "src/checks.h"
10 11 12 13 14 15 16

namespace v8 {
namespace internal {

enum ElementsKind {
  // The "fast" kind for elements that only contain SMI values. Must be first
  // to make it possible to efficiently check maps for this kind.
17 18
  PACKED_SMI_ELEMENTS,
  HOLEY_SMI_ELEMENTS,
19 20

  // The "fast" kind for tagged values. Must be second to make it possible to
21
  // efficiently check maps for this and the PACKED_SMI_ELEMENTS kind
22
  // together at once.
23 24
  PACKED_ELEMENTS,
  HOLEY_ELEMENTS,
25 26

  // The "fast" kind for unwrapped, non-tagged double values.
27 28
  PACKED_DOUBLE_ELEMENTS,
  HOLEY_DOUBLE_ELEMENTS,
29 30 31

  // The "slow" kind.
  DICTIONARY_ELEMENTS,
32

33
  // Elements kind of the "arguments" object (only in sloppy mode).
34 35 36
  FAST_SLOPPY_ARGUMENTS_ELEMENTS,
  SLOW_SLOPPY_ARGUMENTS_ELEMENTS,

37 38 39 40 41 42
  // For string wrapper objects ("new String('...')"), the string's characters
  // are overlaid onto a regular elements backing store.
  FAST_STRING_WRAPPER_ELEMENTS,
  SLOW_STRING_WRAPPER_ELEMENTS,

  // Fixed typed arrays.
43 44 45 46 47 48 49 50 51
  UINT8_ELEMENTS,
  INT8_ELEMENTS,
  UINT16_ELEMENTS,
  INT16_ELEMENTS,
  UINT32_ELEMENTS,
  INT32_ELEMENTS,
  FLOAT32_ELEMENTS,
  FLOAT64_ELEMENTS,
  UINT8_CLAMPED_ELEMENTS,
52 53
  BIGUINT64_ELEMENTS,
  BIGINT64_ELEMENTS,
54

55 56 57 58
  // Sentinel ElementsKind for objects with no elements.
  NO_ELEMENTS,

  // Derived constants from ElementsKind.
59
  FIRST_ELEMENTS_KIND = PACKED_SMI_ELEMENTS,
60
  LAST_ELEMENTS_KIND = BIGINT64_ELEMENTS,
61 62
  FIRST_FAST_ELEMENTS_KIND = PACKED_SMI_ELEMENTS,
  LAST_FAST_ELEMENTS_KIND = HOLEY_DOUBLE_ELEMENTS,
63
  FIRST_FIXED_TYPED_ARRAY_ELEMENTS_KIND = UINT8_ELEMENTS,
64
  LAST_FIXED_TYPED_ARRAY_ELEMENTS_KIND = BIGINT64_ELEMENTS,
65
  TERMINAL_FAST_ELEMENTS_KIND = HOLEY_ELEMENTS
66 67 68
};

const int kElementsKindCount = LAST_ELEMENTS_KIND - FIRST_ELEMENTS_KIND + 1;
69 70
const int kFastElementsKindCount =
    LAST_FAST_ELEMENTS_KIND - FIRST_FAST_ELEMENTS_KIND + 1;
71

72 73
// The number to add to a packed elements kind to reach a holey elements kind
const int kFastElementsKindPackedToHoley =
74
    HOLEY_SMI_ELEMENTS - PACKED_SMI_ELEMENTS;
75

76
int ElementsKindToShiftSize(ElementsKind elements_kind);
77
int ElementsKindToByteSize(ElementsKind elements_kind);
78
int GetDefaultHeaderSizeForElementsKind(ElementsKind elements_kind);
79
const char* ElementsKindToString(ElementsKind kind);
80

81
inline ElementsKind GetInitialFastElementsKind() { return PACKED_SMI_ELEMENTS; }
82

83
ElementsKind GetFastElementsKindFromSequenceIndex(int sequence_number);
84 85
int GetSequenceIndexFromFastElementsKind(ElementsKind elements_kind);

86
ElementsKind GetNextTransitionElementsKind(ElementsKind elements_kind);
87

88 89 90 91
inline bool IsDictionaryElementsKind(ElementsKind kind) {
  return kind == DICTIONARY_ELEMENTS;
}

92
inline bool IsSloppyArgumentsElementsKind(ElementsKind kind) {
93 94
  return kind == FAST_SLOPPY_ARGUMENTS_ELEMENTS ||
         kind == SLOW_SLOPPY_ARGUMENTS_ELEMENTS;
95 96
}

97 98 99 100
inline bool IsStringWrapperElementsKind(ElementsKind kind) {
  return kind == FAST_STRING_WRAPPER_ELEMENTS ||
         kind == SLOW_STRING_WRAPPER_ELEMENTS;
}
101

102 103 104
inline bool IsFixedTypedArrayElementsKind(ElementsKind kind) {
  return kind >= FIRST_FIXED_TYPED_ARRAY_ELEMENTS_KIND &&
         kind <= LAST_FIXED_TYPED_ARRAY_ELEMENTS_KIND;
105 106
}

107 108
inline bool IsTerminalElementsKind(ElementsKind kind) {
  return kind == TERMINAL_FAST_ELEMENTS_KIND ||
109
         IsFixedTypedArrayElementsKind(kind);
110 111
}

112
inline bool IsFastElementsKind(ElementsKind kind) {
113
  STATIC_ASSERT(FIRST_FAST_ELEMENTS_KIND == 0);
114
  return kind <= HOLEY_DOUBLE_ELEMENTS;
115 116
}

117
inline bool IsTransitionElementsKind(ElementsKind kind) {
118
  return IsFastElementsKind(kind) || IsFixedTypedArrayElementsKind(kind) ||
119 120
         kind == FAST_SLOPPY_ARGUMENTS_ELEMENTS ||
         kind == FAST_STRING_WRAPPER_ELEMENTS;
121 122
}

123
inline bool IsDoubleElementsKind(ElementsKind kind) {
124
  return kind == PACKED_DOUBLE_ELEMENTS || kind == HOLEY_DOUBLE_ELEMENTS;
125 126 127
}


128 129 130 131 132
inline bool IsFixedFloatElementsKind(ElementsKind kind) {
  return kind == FLOAT32_ELEMENTS || kind == FLOAT64_ELEMENTS;
}


133
inline bool IsDoubleOrFloatElementsKind(ElementsKind kind) {
134
  return IsDoubleElementsKind(kind) || IsFixedFloatElementsKind(kind);
135 136
}

137
inline bool IsSmiOrObjectElementsKind(ElementsKind kind) {
138 139
  return kind == PACKED_SMI_ELEMENTS || kind == HOLEY_SMI_ELEMENTS ||
         kind == PACKED_ELEMENTS || kind == HOLEY_ELEMENTS;
140 141
}

142
inline bool IsSmiElementsKind(ElementsKind kind) {
143
  return kind == PACKED_SMI_ELEMENTS || kind == HOLEY_SMI_ELEMENTS;
144 145
}

146
inline bool IsFastNumberElementsKind(ElementsKind kind) {
147
  return IsSmiElementsKind(kind) || IsDoubleElementsKind(kind);
148 149
}

150
inline bool IsObjectElementsKind(ElementsKind kind) {
151
  return kind == PACKED_ELEMENTS || kind == HOLEY_ELEMENTS;
152 153
}

154
inline bool IsHoleyElementsKind(ElementsKind kind) {
155 156
  return kind == HOLEY_SMI_ELEMENTS || kind == HOLEY_DOUBLE_ELEMENTS ||
         kind == HOLEY_ELEMENTS;
157 158
}

159
inline bool IsHoleyOrDictionaryElementsKind(ElementsKind kind) {
160
  return IsHoleyElementsKind(kind) || kind == DICTIONARY_ELEMENTS;
161 162 163 164
}


inline bool IsFastPackedElementsKind(ElementsKind kind) {
165 166
  return kind == PACKED_SMI_ELEMENTS || kind == PACKED_DOUBLE_ELEMENTS ||
         kind == PACKED_ELEMENTS;
167 168 169 170
}


inline ElementsKind GetPackedElementsKind(ElementsKind holey_kind) {
171 172
  if (holey_kind == HOLEY_SMI_ELEMENTS) {
    return PACKED_SMI_ELEMENTS;
173
  }
174 175
  if (holey_kind == HOLEY_DOUBLE_ELEMENTS) {
    return PACKED_DOUBLE_ELEMENTS;
176
  }
177 178
  if (holey_kind == HOLEY_ELEMENTS) {
    return PACKED_ELEMENTS;
179 180 181 182 183 184
  }
  return holey_kind;
}


inline ElementsKind GetHoleyElementsKind(ElementsKind packed_kind) {
185 186
  if (packed_kind == PACKED_SMI_ELEMENTS) {
    return HOLEY_SMI_ELEMENTS;
187
  }
188 189
  if (packed_kind == PACKED_DOUBLE_ELEMENTS) {
    return HOLEY_DOUBLE_ELEMENTS;
190
  }
191 192
  if (packed_kind == PACKED_ELEMENTS) {
    return HOLEY_ELEMENTS;
193 194 195 196
  }
  return packed_kind;
}

197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233
inline bool UnionElementsKindUptoPackedness(ElementsKind* a_out,
                                            ElementsKind b) {
  // Assert that the union of two ElementKinds can be computed via std::max.
  static_assert(PACKED_SMI_ELEMENTS < HOLEY_SMI_ELEMENTS,
                "ElementsKind union not computable via std::max.");
  static_assert(PACKED_ELEMENTS < HOLEY_ELEMENTS,
                "ElementsKind union not computable via std::max.");
  static_assert(PACKED_DOUBLE_ELEMENTS < HOLEY_DOUBLE_ELEMENTS,
                "ElementsKind union not computable via std::max.");
  ElementsKind a = *a_out;
  switch (a) {
    case HOLEY_SMI_ELEMENTS:
    case PACKED_SMI_ELEMENTS:
      if (b == PACKED_SMI_ELEMENTS || b == HOLEY_SMI_ELEMENTS) {
        *a_out = std::max(a, b);
        return true;
      }
      break;
    case PACKED_ELEMENTS:
    case HOLEY_ELEMENTS:
      if (b == PACKED_ELEMENTS || b == HOLEY_ELEMENTS) {
        *a_out = std::max(a, b);
        return true;
      }
      break;
    case PACKED_DOUBLE_ELEMENTS:
    case HOLEY_DOUBLE_ELEMENTS:
      if (b == PACKED_DOUBLE_ELEMENTS || b == HOLEY_DOUBLE_ELEMENTS) {
        *a_out = std::max(a, b);
        return true;
      }
      break;
    default:
      break;
  }
  return false;
}
234

235
bool UnionElementsKindUptoSize(ElementsKind* a_out, ElementsKind b);
236

237
inline ElementsKind FastSmiToObjectElementsKind(ElementsKind from_kind) {
238
  DCHECK(IsSmiElementsKind(from_kind));
239
  return (from_kind == PACKED_SMI_ELEMENTS) ? PACKED_ELEMENTS : HOLEY_ELEMENTS;
240 241 242 243 244 245
}


inline bool IsSimpleMapChangeTransition(ElementsKind from_kind,
                                        ElementsKind to_kind) {
  return (GetHoleyElementsKind(from_kind) == to_kind) ||
246
         (IsSmiElementsKind(from_kind) && IsObjectElementsKind(to_kind));
247 248 249 250 251 252 253
}


bool IsMoreGeneralElementsKindTransition(ElementsKind from_kind,
                                         ElementsKind to_kind);


254 255 256 257 258 259 260 261 262
inline ElementsKind GetMoreGeneralElementsKind(ElementsKind from_kind,
                                               ElementsKind to_kind) {
  if (IsMoreGeneralElementsKindTransition(from_kind, to_kind)) {
    return to_kind;
  }
  return from_kind;
}


263 264
inline bool IsTransitionableFastElementsKind(ElementsKind from_kind) {
  return IsFastElementsKind(from_kind) &&
265
         from_kind != TERMINAL_FAST_ELEMENTS_KIND;
266 267
}

268
inline bool ElementsKindEqual(ElementsKind a, ElementsKind b) { return a == b; }
269

270 271
}  // namespace internal
}  // namespace v8
272 273

#endif  // V8_ELEMENTS_KIND_H_