Home | History | Annotate | Download | only in runtime
      1 // Copyright 2014 the V8 project authors. All rights reserved.
      2 // Use of this source code is governed by a BSD-style license that can be
      3 // found in the LICENSE file.
      4 
      5 #ifndef V8_RUNTIME_RUNTIME_UTILS_H_
      6 #define V8_RUNTIME_RUNTIME_UTILS_H_
      7 
      8 #include "src/base/logging.h"
      9 #include "src/runtime/runtime.h"
     10 
     11 namespace v8 {
     12 namespace internal {
     13 
     14 #ifdef DEBUG
     15 
     16 #define RUNTIME_ASSERT(value)                      \
     17   do {                                             \
     18     if (!(value)) {                                \
     19       V8_RuntimeError(__FILE__, __LINE__, #value); \
     20       return isolate->ThrowIllegalOperation();     \
     21     }                                              \
     22   } while (0)
     23 
     24 #else
     25 
     26 #define RUNTIME_ASSERT(value)                  \
     27   do {                                         \
     28     if (!(value)) {                            \
     29       return isolate->ThrowIllegalOperation(); \
     30     }                                          \
     31   } while (0)
     32 
     33 #endif
     34 
     35 // Cast the given object to a value of the specified type and store
     36 // it in a variable with the given name.  If the object is not of the
     37 // expected type call IllegalOperation and return.
     38 #define CONVERT_ARG_CHECKED(Type, name, index) \
     39   RUNTIME_ASSERT(args[index]->Is##Type());     \
     40   Type* name = Type::cast(args[index]);
     41 
     42 #define CONVERT_ARG_HANDLE_CHECKED(Type, name, index) \
     43   RUNTIME_ASSERT(args[index]->Is##Type());            \
     44   Handle<Type> name = args.at<Type>(index);
     45 
     46 #define CONVERT_NUMBER_ARG_HANDLE_CHECKED(name, index) \
     47   RUNTIME_ASSERT(args[index]->IsNumber());             \
     48   Handle<Object> name = args.at<Object>(index);
     49 
     50 // Cast the given object to a boolean and store it in a variable with
     51 // the given name.  If the object is not a boolean call IllegalOperation
     52 // and return.
     53 #define CONVERT_BOOLEAN_ARG_CHECKED(name, index) \
     54   RUNTIME_ASSERT(args[index]->IsBoolean());      \
     55   bool name = args[index]->IsTrue(isolate);
     56 
     57 // Cast the given argument to a Smi and store its value in an int variable
     58 // with the given name.  If the argument is not a Smi call IllegalOperation
     59 // and return.
     60 #define CONVERT_SMI_ARG_CHECKED(name, index) \
     61   RUNTIME_ASSERT(args[index]->IsSmi());      \
     62   int name = args.smi_at(index);
     63 
     64 // Cast the given argument to a double and store it in a variable with
     65 // the given name.  If the argument is not a number (as opposed to
     66 // the number not-a-number) call IllegalOperation and return.
     67 #define CONVERT_DOUBLE_ARG_CHECKED(name, index) \
     68   RUNTIME_ASSERT(args[index]->IsNumber());      \
     69   double name = args.number_at(index);
     70 
     71 
     72 // Cast the given argument to a size_t and store its value in a variable with
     73 // the given name.  If the argument is not a size_t call IllegalOperation and
     74 // return.
     75 #define CONVERT_SIZE_ARG_CHECKED(name, index)            \
     76   RUNTIME_ASSERT(args[index]->IsNumber());               \
     77   Handle<Object> name##_object = args.at<Object>(index); \
     78   size_t name = 0;                                       \
     79   RUNTIME_ASSERT(TryNumberToSize(isolate, *name##_object, &name));
     80 
     81 
     82 // Call the specified converter on the object *comand store the result in
     83 // a variable of the specified type with the given name.  If the
     84 // object is not a Number call IllegalOperation and return.
     85 #define CONVERT_NUMBER_CHECKED(type, name, Type, obj) \
     86   RUNTIME_ASSERT(obj->IsNumber());                    \
     87   type name = NumberTo##Type(obj);
     88 
     89 
     90 // Cast the given argument to PropertyDetails and store its value in a
     91 // variable with the given name.  If the argument is not a Smi call
     92 // IllegalOperation and return.
     93 #define CONVERT_PROPERTY_DETAILS_CHECKED(name, index) \
     94   RUNTIME_ASSERT(args[index]->IsSmi());               \
     95   PropertyDetails name = PropertyDetails(Smi::cast(args[index]));
     96 
     97 
     98 // Assert that the given argument has a valid value for a LanguageMode
     99 // and store it in a LanguageMode variable with the given name.
    100 #define CONVERT_LANGUAGE_MODE_ARG_CHECKED(name, index)        \
    101   RUNTIME_ASSERT(args[index]->IsSmi());                       \
    102   RUNTIME_ASSERT(is_valid_language_mode(args.smi_at(index))); \
    103   LanguageMode name = static_cast<LanguageMode>(args.smi_at(index));
    104 
    105 
    106 // Assert that the given argument is a number within the Int32 range
    107 // and convert it to int32_t.  If the argument is not an Int32 call
    108 // IllegalOperation and return.
    109 #define CONVERT_INT32_ARG_CHECKED(name, index) \
    110   RUNTIME_ASSERT(args[index]->IsNumber());     \
    111   int32_t name = 0;                            \
    112   RUNTIME_ASSERT(args[index]->ToInt32(&name));
    113 
    114 
    115 // Cast the given argument to PropertyAttributes and store its value in a
    116 // variable with the given name.  If the argument is not a Smi call or the
    117 // enum value is out of range, call IllegalOperation and return.
    118 #define CONVERT_PROPERTY_ATTRIBUTES_CHECKED(name, index)                   \
    119   RUNTIME_ASSERT(args[index]->IsSmi());                                    \
    120   RUNTIME_ASSERT(                                                          \
    121       (args.smi_at(index) & ~(READ_ONLY | DONT_ENUM | DONT_DELETE)) == 0); \
    122   PropertyAttributes name = static_cast<PropertyAttributes>(args.smi_at(index));
    123 
    124 
    125 // A mechanism to return a pair of Object pointers in registers (if possible).
    126 // How this is achieved is calling convention-dependent.
    127 // All currently supported x86 compiles uses calling conventions that are cdecl
    128 // variants where a 64-bit value is returned in two 32-bit registers
    129 // (edx:eax on ia32, r1:r0 on ARM).
    130 // In AMD-64 calling convention a struct of two pointers is returned in rdx:rax.
    131 // In Win64 calling convention, a struct of two pointers is returned in memory,
    132 // allocated by the caller, and passed as a pointer in a hidden first parameter.
    133 #ifdef V8_HOST_ARCH_64_BIT
    134 struct ObjectPair {
    135   Object* x;
    136   Object* y;
    137 };
    138 
    139 
    140 static inline ObjectPair MakePair(Object* x, Object* y) {
    141   ObjectPair result = {x, y};
    142   // Pointers x and y returned in rax and rdx, in AMD-x64-abi.
    143   // In Win64 they are assigned to a hidden first argument.
    144   return result;
    145 }
    146 #elif V8_TARGET_ARCH_X64 && V8_TARGET_ARCH_32_BIT
    147 // For x32 a 128-bit struct return is done as rax and rdx from the ObjectPair
    148 // are used in the full codegen and Crankshaft compiler. An alternative is
    149 // using uint64_t and modifying full codegen and Crankshaft compiler.
    150 struct ObjectPair {
    151   Object* x;
    152   uint32_t x_upper;
    153   Object* y;
    154   uint32_t y_upper;
    155 };
    156 
    157 
    158 static inline ObjectPair MakePair(Object* x, Object* y) {
    159   ObjectPair result = {x, 0, y, 0};
    160   // Pointers x and y returned in rax and rdx, in x32-abi.
    161   return result;
    162 }
    163 #else
    164 typedef uint64_t ObjectPair;
    165 static inline ObjectPair MakePair(Object* x, Object* y) {
    166 #if defined(V8_TARGET_LITTLE_ENDIAN)
    167   return reinterpret_cast<uint32_t>(x) |
    168          (reinterpret_cast<ObjectPair>(y) << 32);
    169 #elif defined(V8_TARGET_BIG_ENDIAN)
    170   return reinterpret_cast<uint32_t>(y) |
    171          (reinterpret_cast<ObjectPair>(x) << 32);
    172 #else
    173 #error Unknown endianness
    174 #endif
    175 }
    176 #endif
    177 
    178 
    179 // A mechanism to return a triple of Object pointers. In all calling
    180 // conventions, a struct of two pointers is returned in memory,
    181 // allocated by the caller, and passed as a pointer in a hidden first parameter.
    182 struct ObjectTriple {
    183   Object* x;
    184   Object* y;
    185   Object* z;
    186 };
    187 
    188 static inline ObjectTriple MakeTriple(Object* x, Object* y, Object* z) {
    189   ObjectTriple result = {x, y, z};
    190   // ObjectTriple is assigned to a hidden first argument.
    191   return result;
    192 }
    193 
    194 }  // namespace internal
    195 }  // namespace v8
    196 
    197 #endif  // V8_RUNTIME_RUNTIME_UTILS_H_
    198