blob: cdbb22db80327207adbc086431c5a31bd9eae788 [file] [log] [blame]
// Copyright 2017 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.
#include "src/common/assert-scope.h"
#include "src/objects/string.h"
#include "src/roots/roots.h"
// Has to be the last include (doesn't have include guards):
#include "src/objects/object-macros.h"
namespace v8 {
namespace internal {
// A generic key for lookups into the string table, which allows heteromorphic
// lookup and on-demand creation of new strings.
class StringTableKey {
virtual ~StringTableKey() = default;
inline StringTableKey(uint32_t hash_field, int length);
// The individual keys will have their own AsHandle, we shouldn't call the
// base version.
Handle<String> AsHandle(Isolate* isolate) = delete;
uint32_t hash_field() const {
DCHECK_NE(0, hash_field_);
return hash_field_;
virtual bool IsMatch(String string) = 0;
inline uint32_t hash() const;
int length() const { return length_; }
inline void set_hash_field(uint32_t hash_field);
uint32_t hash_field_ = 0;
int length_;
class SeqOneByteString;
// StringTable, for internalizing strings. The Lookup methods are designed to be
// thread-safe, in combination with GC safepoints.
// The string table layout is defined by its Data implementation class, see
// StringTable::Data for details.
class V8_EXPORT_PRIVATE StringTable {
static constexpr Smi empty_element() { return Smi::FromInt(0); }
static constexpr Smi deleted_element() { return Smi::FromInt(1); }
explicit StringTable(Isolate* isolate);
int Capacity() const;
int NumberOfElements() const;
// Find string in the string table. If it is not there yet, it is
// added. The return value is the string found.
Handle<String> LookupString(Isolate* isolate, Handle<String> key);
// Find string in the string table, using the given key. If the string is not
// there yet, it is created (by the key) and added. The return value is the
// string found.
template <typename StringTableKey, typename LocalIsolate>
Handle<String> LookupKey(LocalIsolate* isolate, StringTableKey* key);
// {raw_string} must be a tagged String pointer.
// Returns a tagged pointer: either a Smi if the string is an array index, an
// internalized string, or a Smi sentinel.
static Address TryStringToIndexOrLookupExisting(Isolate* isolate,
Address raw_string);
void Print(IsolateRoot isolate) const;
size_t GetCurrentMemoryUsage() const;
// The following methods must be called either while holding the write lock,
// or while in a Heap safepoint.
void IterateElements(RootVisitor* visitor);
void DropOldData();
void NotifyElementsRemoved(int count);
class Data;
Data* EnsureCapacity(IsolateRoot isolate, int additional_elements);
std::atomic<Data*> data_;
// Write mutex is mutable so that readers of concurrently mutated values (e.g.
// NumberOfElements) are allowed to lock it while staying const.
mutable base::Mutex write_mutex_;
#ifdef DEBUG
Isolate* isolate_;
} // namespace internal
} // namespace v8
#include "src/objects/object-macros-undef.h"