123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129 |
- // Copyright 2021 the V8 project authors. All rights reserved.
- // Use of this source code is governed by a BSD-style license that can be
- // found in the LICENSE file.
- #ifndef INCLUDE_V8_CONTAINER_H_
- #define INCLUDE_V8_CONTAINER_H_
- #include <stddef.h>
- #include <stdint.h>
- #include "v8-local-handle.h" // NOLINT(build/include_directory)
- #include "v8-object.h" // NOLINT(build/include_directory)
- #include "v8config.h" // NOLINT(build/include_directory)
- namespace v8 {
- class Context;
- class Isolate;
- /**
- * An instance of the built-in array constructor (ECMA-262, 15.4.2).
- */
- class V8_EXPORT Array : public Object {
- public:
- uint32_t Length() const;
- /**
- * Creates a JavaScript array with the given length. If the length
- * is negative the returned array will have length 0.
- */
- static Local<Array> New(Isolate* isolate, int length = 0);
- /**
- * Creates a JavaScript array out of a Local<Value> array in C++
- * with a known length.
- */
- static Local<Array> New(Isolate* isolate, Local<Value>* elements,
- size_t length);
- V8_INLINE static Array* Cast(Value* value) {
- #ifdef V8_ENABLE_CHECKS
- CheckCast(value);
- #endif
- return static_cast<Array*>(value);
- }
- private:
- Array();
- static void CheckCast(Value* obj);
- };
- /**
- * An instance of the built-in Map constructor (ECMA-262, 6th Edition, 23.1.1).
- */
- class V8_EXPORT Map : public Object {
- public:
- size_t Size() const;
- void Clear();
- V8_WARN_UNUSED_RESULT MaybeLocal<Value> Get(Local<Context> context,
- Local<Value> key);
- V8_WARN_UNUSED_RESULT MaybeLocal<Map> Set(Local<Context> context,
- Local<Value> key,
- Local<Value> value);
- V8_WARN_UNUSED_RESULT Maybe<bool> Has(Local<Context> context,
- Local<Value> key);
- V8_WARN_UNUSED_RESULT Maybe<bool> Delete(Local<Context> context,
- Local<Value> key);
- /**
- * Returns an array of length Size() * 2, where index N is the Nth key and
- * index N + 1 is the Nth value.
- */
- Local<Array> AsArray() const;
- /**
- * Creates a new empty Map.
- */
- static Local<Map> New(Isolate* isolate);
- V8_INLINE static Map* Cast(Value* value) {
- #ifdef V8_ENABLE_CHECKS
- CheckCast(value);
- #endif
- return static_cast<Map*>(value);
- }
- private:
- Map();
- static void CheckCast(Value* obj);
- };
- /**
- * An instance of the built-in Set constructor (ECMA-262, 6th Edition, 23.2.1).
- */
- class V8_EXPORT Set : public Object {
- public:
- size_t Size() const;
- void Clear();
- V8_WARN_UNUSED_RESULT MaybeLocal<Set> Add(Local<Context> context,
- Local<Value> key);
- V8_WARN_UNUSED_RESULT Maybe<bool> Has(Local<Context> context,
- Local<Value> key);
- V8_WARN_UNUSED_RESULT Maybe<bool> Delete(Local<Context> context,
- Local<Value> key);
- /**
- * Returns an array of the keys in this Set.
- */
- Local<Array> AsArray() const;
- /**
- * Creates a new empty Set.
- */
- static Local<Set> New(Isolate* isolate);
- V8_INLINE static Set* Cast(Value* value) {
- #ifdef V8_ENABLE_CHECKS
- CheckCast(value);
- #endif
- return static_cast<Set*>(value);
- }
- private:
- Set();
- static void CheckCast(Value* obj);
- };
- } // namespace v8
- #endif // INCLUDE_V8_CONTAINER_H_
|