// Copyright 2016 PDFium Authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. // Original code copyright 2014 Foxit Software Inc. http://www.foxitsoftware.com #ifndef CORE_FXCRT_STRING_VIEW_TEMPLATE_H_ #define CORE_FXCRT_STRING_VIEW_TEMPLATE_H_ #include #include #include #include #include "core/fxcrt/fx_system.h" #include "third_party/base/optional.h" #include "third_party/base/span.h" #include "third_party/base/stl_util.h" namespace fxcrt { // An immutable string with caller-provided storage which must outlive the // string itself. These are not necessarily nul-terminated, so that substring // extraction (via the Substr(), First(), and Last() methods) is copy-free. // // String view arguments should be passed by value, since they are small, // rather than const-ref, even if they are not modified. template class StringViewTemplate { public: using CharType = T; using UnsignedType = typename std::make_unsigned::type; using const_iterator = const CharType*; using const_reverse_iterator = std::reverse_iterator; constexpr StringViewTemplate() noexcept = default; constexpr StringViewTemplate(const StringViewTemplate& src) noexcept = default; // Deliberately implicit to avoid calling on every string literal. // NOLINTNEXTLINE(runtime/explicit) StringViewTemplate(const CharType* ptr) noexcept : m_Span(reinterpret_cast(ptr), ptr ? FXSYS_len(ptr) : 0) {} constexpr StringViewTemplate(const CharType* ptr, size_t len) noexcept : m_Span(reinterpret_cast(ptr), len) {} explicit constexpr StringViewTemplate( const pdfium::span& other) noexcept : m_Span(reinterpret_cast(other.data()), other.size()) {} template constexpr StringViewTemplate( const UnsignedType* ptr, size_t size, typename std::enable_if::value>::type* = 0) noexcept : m_Span(ptr, size) {} template StringViewTemplate( const pdfium::span other, typename std::enable_if::value>::type* = 0) noexcept : m_Span(other) {} // Deliberately implicit to avoid calling on every string literal. // |ch| must be an lvalue that outlives the StringViewTemplate. // NOLINTNEXTLINE(runtime/explicit) constexpr StringViewTemplate(CharType& ch) noexcept : m_Span(reinterpret_cast(&ch), 1) {} // Any changes to |vec| invalidate the string. template explicit StringViewTemplate( const std::vector& vec) noexcept : m_Span(!vec.empty() ? vec.data() : nullptr, vec.size()) {} StringViewTemplate& operator=(const CharType* src) { m_Span = pdfium::span( reinterpret_cast(src), src ? FXSYS_len(src) : 0); return *this; } StringViewTemplate& operator=(const StringViewTemplate& src) { m_Span = src.m_Span; return *this; } const_iterator begin() const { return reinterpret_cast(m_Span.begin()); } const_iterator end() const { return reinterpret_cast(m_Span.end()); } const_reverse_iterator rbegin() const { return const_reverse_iterator(end()); } const_reverse_iterator rend() const { return const_reverse_iterator(begin()); } bool operator==(const StringViewTemplate& other) const { return m_Span == other.m_Span; } bool operator==(const CharType* ptr) const { StringViewTemplate other(ptr); return *this == other; } bool operator!=(const CharType* ptr) const { return !(*this == ptr); } bool operator!=(const StringViewTemplate& other) const { return !(*this == other); } bool IsASCII() const { for (auto c : *this) { if (c <= 0 || c > 127) // Questionable signedness of |c|. return false; } return true; } bool EqualsASCII(const StringViewTemplate& that) const { size_t length = GetLength(); if (length != that.GetLength()) return false; for (size_t i = 0; i < length; ++i) { auto c = (*this)[i]; if (c <= 0 || c > 127 || c != that[i]) // Questionable signedness of |c|. return false; } return true; } bool EqualsASCIINoCase(const StringViewTemplate& that) const { size_t length = GetLength(); if (length != that.GetLength()) return false; for (size_t i = 0; i < length; ++i) { auto c = (*this)[i]; if (c <= 0 || c > 127 || tolower(c) != tolower(that[i])) return false; } return true; } uint32_t GetID() const { if (m_Span.empty()) return 0; uint32_t strid = 0; size_t size = std::min(static_cast(4), m_Span.size()); for (size_t i = 0; i < size; i++) strid = strid * 256 + m_Span[i]; return strid << ((4 - size) * 8); } pdfium::span raw_span() const { return m_Span; } pdfium::span span() const { return pdfium::make_span(reinterpret_cast(m_Span.data()), m_Span.size()); } const UnsignedType* raw_str() const { return m_Span.data(); } const CharType* unterminated_c_str() const { return reinterpret_cast(m_Span.data()); } size_t GetLength() const { return m_Span.size(); } bool IsEmpty() const { return m_Span.empty(); } bool IsValidIndex(size_t index) const { return index < m_Span.size(); } bool IsValidLength(size_t length) const { return length <= m_Span.size(); } const UnsignedType& operator[](const size_t index) const { return m_Span[index]; } UnsignedType Front() const { return !m_Span.empty() ? m_Span[0] : 0; } UnsignedType Back() const { return !m_Span.empty() ? m_Span[m_Span.size() - 1] : 0; } const CharType CharAt(const size_t index) const { return static_cast(m_Span[index]); } Optional Find(CharType ch) const { const auto* found = reinterpret_cast(FXSYS_chr( reinterpret_cast(m_Span.data()), ch, m_Span.size())); return found ? Optional(found - m_Span.data()) : Optional(); } bool Contains(CharType ch) const { return Find(ch).has_value(); } StringViewTemplate Substr(size_t first, size_t count) const { if (!m_Span.data()) return StringViewTemplate(); if (!IsValidIndex(first)) return StringViewTemplate(); if (count == 0 || !IsValidLength(count)) return StringViewTemplate(); if (!IsValidIndex(first + count - 1)) return StringViewTemplate(); return StringViewTemplate(m_Span.data() + first, count); } StringViewTemplate First(size_t count) const { if (count == 0 || !IsValidLength(count)) return StringViewTemplate(); return Substr(0, count); } StringViewTemplate Last(size_t count) const { if (count == 0 || !IsValidLength(count)) return StringViewTemplate(); return Substr(GetLength() - count, count); } StringViewTemplate TrimmedRight(CharType ch) const { if (IsEmpty()) return StringViewTemplate(); size_t pos = GetLength(); while (pos && CharAt(pos - 1) == ch) pos--; if (pos == 0) return StringViewTemplate(); return StringViewTemplate(m_Span.data(), pos); } bool operator<(const StringViewTemplate& that) const { int result = FXSYS_cmp(reinterpret_cast(m_Span.data()), reinterpret_cast(that.m_Span.data()), std::min(m_Span.size(), that.m_Span.size())); return result < 0 || (result == 0 && m_Span.size() < that.m_Span.size()); } bool operator>(const StringViewTemplate& that) const { int result = FXSYS_cmp(reinterpret_cast(m_Span.data()), reinterpret_cast(that.m_Span.data()), std::min(m_Span.size(), that.m_Span.size())); return result > 0 || (result == 0 && m_Span.size() > that.m_Span.size()); } protected: pdfium::span m_Span; private: void* operator new(size_t) throw() { return nullptr; } }; template inline bool operator==(const T* lhs, const StringViewTemplate& rhs) { return rhs == lhs; } template inline bool operator!=(const T* lhs, const StringViewTemplate& rhs) { return rhs != lhs; } template inline bool operator<(const T* lhs, const StringViewTemplate& rhs) { return rhs > lhs; } // Workaround for one of the cases external template classes are // failing in GCC before version 7 with -O0 #if !defined(__GNUC__) || __GNUC__ >= 7 extern template class StringViewTemplate; extern template class StringViewTemplate; #endif using ByteStringView = StringViewTemplate; using WideStringView = StringViewTemplate; } // namespace fxcrt using ByteStringView = fxcrt::ByteStringView; using WideStringView = fxcrt::WideStringView; #endif // CORE_FXCRT_STRING_VIEW_TEMPLATE_H_