// Copyright 2016 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 V8_INSPECTOR_STRING_UTIL_H_ #define V8_INSPECTOR_STRING_UTIL_H_ #include #include #include "../../third_party/inspector_protocol/crdtp/protocol_core.h" #include "include/v8-inspector.h" #include "src/base/logging.h" #include "src/base/macros.h" #include "src/inspector/string-16.h" namespace v8_inspector { namespace protocol { class Value; using String = v8_inspector::String16; class StringUtil { public: static String fromUTF8(const uint8_t* data, size_t length) { return String16::fromUTF8(reinterpret_cast(data), length); } static String fromUTF16LE(const uint16_t* data, size_t length) { return String16::fromUTF16LE(data, length); } static const uint8_t* CharactersLatin1(const String& s) { return nullptr; } static const uint8_t* CharactersUTF8(const String& s) { return nullptr; } static const uint16_t* CharactersUTF16(const String& s) { return s.characters16(); } static size_t CharacterCount(const String& s) { return s.length(); } }; // A read-only sequence of uninterpreted bytes with reference-counted storage. class V8_EXPORT Binary { public: Binary() = default; const uint8_t* data() const { return bytes_->data(); } size_t size() const { return bytes_->size(); } String toBase64() const; static Binary fromBase64(const String& base64, bool* success); static Binary fromSpan(const uint8_t* data, size_t size) { return Binary(std::make_shared>(data, data + size)); } private: std::shared_ptr> bytes_; explicit Binary(std::shared_ptr> bytes) : bytes_(bytes) {} }; } // namespace protocol v8::Local toV8String(v8::Isolate*, const String16&); v8::Local toV8StringInternalized(v8::Isolate*, const String16&); v8::Local toV8StringInternalized(v8::Isolate*, const char*); v8::Local toV8String(v8::Isolate*, const StringView&); // TODO(dgozman): rename to toString16. String16 toProtocolString(v8::Isolate*, v8::Local); String16 toProtocolStringWithTypeCheck(v8::Isolate*, v8::Local); String16 toString16(const StringView&); StringView toStringView(const String16&); template StringView toStringView(const char* str[N]) { return StringView(reinterpret_cast(str), N); } bool stringViewStartsWith(const StringView&, const char*); // Creates a string buffer instance which owns |str|, a 16 bit string. std::unique_ptr StringBufferFrom(String16 str); // Creates a string buffer instance which owns |str|, an 8 bit string. // 8 bit strings are used for LATIN1 text (which subsumes 7 bit ASCII, e.g. // our generated JSON), as well as for CBOR encoded binary messages. std::unique_ptr StringBufferFrom(std::vector str); String16 stackTraceIdToString(uintptr_t id); } // namespace v8_inspector // See third_party/inspector_protocol/crdtp/serializer_traits.h. namespace v8_crdtp { template <> struct ProtocolTypeTraits { static bool Deserialize(DeserializerState* state, v8_inspector::String16* value); static void Serialize(const v8_inspector::String16& value, std::vector* bytes); }; template <> struct ProtocolTypeTraits { static bool Deserialize(DeserializerState* state, v8_inspector::protocol::Binary* value); static void Serialize(const v8_inspector::protocol::Binary& value, std::vector* bytes); }; namespace detail { template <> struct MaybeTypedef { typedef ValueMaybe type; }; template <> struct MaybeTypedef { typedef ValueMaybe type; }; } // namespace detail } // namespace v8_crdtp #endif // V8_INSPECTOR_STRING_UTIL_H_