// 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 <stdint.h> #include <memory> #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<const char*>(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<std::vector<uint8_t>>(data, data + size)); } private: std::shared_ptr<std::vector<uint8_t>> bytes_; explicit Binary(std::shared_ptr<std::vector<uint8_t>> bytes) : bytes_(bytes) {} }; } // namespace protocol v8::Local<v8::String> toV8String(v8::Isolate*, const String16&); v8::Local<v8::String> toV8StringInternalized(v8::Isolate*, const String16&); v8::Local<v8::String> toV8StringInternalized(v8::Isolate*, const char*); v8::Local<v8::String> toV8String(v8::Isolate*, const StringView&); // TODO(dgozman): rename to toString16. String16 toProtocolString(v8::Isolate*, v8::Local<v8::String>); String16 toProtocolStringWithTypeCheck(v8::Isolate*, v8::Local<v8::Value>); String16 toString16(const StringView&); StringView toStringView(const String16&); template <size_t N> StringView toStringView(const char* str[N]) { return StringView(reinterpret_cast<const uint8_t*>(str), N); } bool stringViewStartsWith(const StringView&, const char*); // Creates a string buffer instance which owns |str|, a 16 bit string. std::unique_ptr<StringBuffer> 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<StringBuffer> StringBufferFrom(std::vector<uint8_t> str); String16 stackTraceIdToString(uintptr_t id); } // namespace v8_inspector // See third_party/inspector_protocol/crdtp/serializer_traits.h. namespace v8_crdtp { template <> struct ProtocolTypeTraits<v8_inspector::String16> { static bool Deserialize(DeserializerState* state, v8_inspector::String16* value); static void Serialize(const v8_inspector::String16& value, std::vector<uint8_t>* bytes); }; template <> struct ProtocolTypeTraits<v8_inspector::protocol::Binary> { static bool Deserialize(DeserializerState* state, v8_inspector::protocol::Binary* value); static void Serialize(const v8_inspector::protocol::Binary& value, std::vector<uint8_t>* bytes); }; namespace detail { template <> struct MaybeTypedef<v8_inspector::String16> { typedef ValueMaybe<v8_inspector::String16> type; }; template <> struct MaybeTypedef<v8_inspector::protocol::Binary> { typedef ValueMaybe<v8_inspector::protocol::Binary> type; }; } // namespace detail } // namespace v8_crdtp #endif // V8_INSPECTOR_STRING_UTIL_H_