1/*
2 * Copyright (C) 2012-2018 Apple Inc. All rights reserved.
3 * Copyright (C) 2015-2016 Yusuke Suzuki <utatane.tea@gmail.com>.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 *
14 * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS''
15 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
16 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
17 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS
18 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
19 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
20 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
21 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
22 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
23 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
24 * THE POSSIBILITY OF SUCH DAMAGE.
25 */
26
27#pragma once
28
29#include "JSString.h"
30#include "PrivateName.h"
31
32namespace JSC {
33
34class Symbol final : public JSCell {
35public:
36 typedef JSCell Base;
37 static const unsigned StructureFlags = Base::StructureFlags | StructureIsImmortal | OverridesToThis;
38
39 DECLARE_EXPORT_INFO;
40
41 static const bool needsDestruction = true;
42
43 static Structure* createStructure(VM& vm, JSGlobalObject* globalObject, JSValue prototype)
44 {
45 return Structure::create(vm, globalObject, prototype, TypeInfo(SymbolType, StructureFlags), info());
46 }
47
48 static Symbol* create(VM&);
49 static Symbol* createWithDescription(VM&, const String&);
50 JS_EXPORT_PRIVATE static Symbol* create(VM&, SymbolImpl& uid);
51
52 PrivateName privateName() const { return m_privateName; }
53 String descriptiveString() const;
54 String description() const;
55
56 JSValue toPrimitive(ExecState*, PreferredPrimitiveType) const;
57 bool getPrimitiveNumber(ExecState*, double& number, JSValue&) const;
58 JSObject* toObject(ExecState*, JSGlobalObject*) const;
59 double toNumber(ExecState*) const;
60
61 static ptrdiff_t offsetOfSymbolImpl()
62 {
63 // PrivateName is just a Ref<SymbolImpl> which can just be used as a SymbolImpl*.
64 return OBJECT_OFFSETOF(Symbol, m_privateName);
65 }
66
67protected:
68 static void destroy(JSCell*);
69
70 Symbol(VM&);
71 Symbol(VM&, const String&);
72 Symbol(VM&, SymbolImpl& uid);
73
74 void finishCreation(VM&);
75
76 PrivateName m_privateName;
77};
78
79Symbol* asSymbol(JSValue);
80
81inline Symbol* asSymbol(JSValue value)
82{
83 ASSERT(value.asCell()->isSymbol());
84 return jsCast<Symbol*>(value.asCell());
85}
86
87} // namespace JSC
88