/* * Copyright (c) 2025, Tim Flynn * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include #include #include #include namespace AK { class [[nodiscard]] Utf16FlyString { AK_MAKE_DEFAULT_MOVABLE(Utf16FlyString); AK_MAKE_DEFAULT_COPYABLE(Utf16FlyString); public: constexpr Utf16FlyString() = default; static Utf16FlyString from_utf8(StringView); static Utf16FlyString from_utf8(String const& string) { return from_utf8_without_validation(string); } static Utf16FlyString from_utf8(FlyString const& string) { return from_utf8_without_validation(string); } static Utf16FlyString from_utf8_without_validation(StringView); static Utf16FlyString from_utf8_but_should_be_ported_to_utf16(StringView string) { return from_utf8_without_validation(string); } static Utf16FlyString from_utf16(Utf16View const&); template requires(IsOneOf, Utf16String, Utf16FlyString>) static Utf16FlyString from_utf16(T&&) = delete; Utf16FlyString(Utf16String const&); [[nodiscard]] ALWAYS_INLINE Utf16View view() const LIFETIME_BOUND { return m_data.utf16_view(); } ALWAYS_INLINE explicit operator Utf16String() const { return to_utf16_string(); } ALWAYS_INLINE operator Utf16View() const& LIFETIME_BOUND { return view(); } explicit operator Utf16View() const&& = delete; ALWAYS_INLINE Utf16String to_utf16_string() const { Detail::Utf16StringBase copy { m_data }; return Utf16String { move(copy) }; } ALWAYS_INLINE Utf16FlyString to_ascii_lowercase() const { auto view = m_data.utf16_view(); if (view.has_ascii_storage()) { if (!any_of(view.ascii_span(), is_ascii_upper_alpha)) return *this; } else { if (!any_of(view.utf16_span(), is_ascii_upper_alpha)) return *this; } return view.to_ascii_lowercase(); } ALWAYS_INLINE Utf16FlyString to_ascii_uppercase() const { auto view = m_data.utf16_view(); if (view.has_ascii_storage()) { if (!any_of(view.ascii_span(), is_ascii_lower_alpha)) return *this; } else { if (!any_of(view.utf16_span(), is_ascii_lower_alpha)) return *this; } return view.to_ascii_uppercase(); } ALWAYS_INLINE Utf16FlyString to_ascii_titlecase() const { return view().to_ascii_titlecase(); } template ALWAYS_INLINE Optional to_number(TrimWhitespace trim_whitespace = TrimWhitespace::Yes, int base = 10) const { return m_data.to_number(trim_whitespace, base); } ALWAYS_INLINE Utf16FlyString& operator=(Utf16String const& string) { *this = Utf16FlyString { string }; return *this; } [[nodiscard]] ALWAYS_INLINE bool operator==(Utf16FlyString const& other) const { return m_data.raw({}) == other.m_data.raw({}); } [[nodiscard]] ALWAYS_INLINE bool operator==(Utf16String const& other) const { return m_data == other; } [[nodiscard]] ALWAYS_INLINE bool operator==(Utf16View const& other) const { return m_data == other; } [[nodiscard]] ALWAYS_INLINE bool operator==(StringView other) const { return m_data == other; } [[nodiscard]] ALWAYS_INLINE int operator<=>(Utf16FlyString const& other) const { return m_data.operator<=>(other.m_data); } [[nodiscard]] ALWAYS_INLINE int operator<=>(Utf16View const& other) const { return m_data.operator<=>(other); } [[nodiscard]] ALWAYS_INLINE bool equals_ignoring_ascii_case(Utf16FlyString const& other) const { if (*this == other) return true; return m_data.equals_ignoring_ascii_case(other.m_data); } [[nodiscard]] ALWAYS_INLINE bool equals_ignoring_ascii_case(Utf16View const& other) const { return m_data.equals_ignoring_ascii_case(other); } template [[nodiscard]] ALWAYS_INLINE bool is_one_of(Ts&&... strings) const { return (this->operator==(forward(strings)) || ...); } template [[nodiscard]] ALWAYS_INLINE bool is_one_of_ignoring_ascii_case(Ts&&... strings) const { return (this->equals_ignoring_ascii_case(forward(strings)) || ...); } [[nodiscard]] ALWAYS_INLINE u32 hash() const { return m_data.hash(); } [[nodiscard]] ALWAYS_INLINE bool is_empty() const { return m_data.is_empty(); } [[nodiscard]] ALWAYS_INLINE bool is_ascii() const { return m_data.is_ascii(); } [[nodiscard]] ALWAYS_INLINE size_t length_in_code_units() const { return m_data.length_in_code_units(); } [[nodiscard]] ALWAYS_INLINE size_t length_in_code_points() const { return m_data.length_in_code_points(); } [[nodiscard]] ALWAYS_INLINE char16_t code_unit_at(size_t code_unit_offset) const { return m_data.code_unit_at(code_unit_offset); } [[nodiscard]] ALWAYS_INLINE u32 code_point_at(size_t code_unit_offset) const { return m_data.code_point_at(code_unit_offset); } [[nodiscard]] ALWAYS_INLINE size_t code_unit_offset_of(size_t code_point_offset) const { return m_data.code_unit_offset_of(code_point_offset); } [[nodiscard]] ALWAYS_INLINE size_t code_point_offset_of(size_t code_unit_offset) const { return m_data.code_point_offset_of(code_unit_offset); } constexpr Utf16FlyString(Badge>, nullptr_t) : m_data(Badge {}, nullptr) { } [[nodiscard]] constexpr bool is_invalid(Badge>) const { return m_data.raw({}) == 0; } // This is primarily interesting to unit tests. [[nodiscard]] static size_t number_of_utf16_fly_strings(); private: ALWAYS_INLINE explicit Utf16FlyString(Detail::Utf16StringBase data) : m_data(move(data)) { } template static Optional create_fly_string_from_cache(ViewType const&); Detail::Utf16StringBase m_data; }; template<> class Optional : public OptionalBase { template friend class Optional; public: using ValueType = Utf16FlyString; constexpr Optional() = default; template V> constexpr Optional(V) { } constexpr Optional(Optional const& other) : m_value(other.m_value) { } constexpr Optional(Optional&& other) : m_value(move(other.m_value)) { } template requires(!IsSame>) explicit(!IsConvertible) constexpr Optional(U&& value) requires(!IsSame, Optional> && IsConstructible) : m_value(forward(value)) { } template V> constexpr Optional& operator=(V) { clear(); return *this; } constexpr Optional& operator=(Optional const& other) { if (this != &other) m_value = other.m_value; return *this; } constexpr Optional& operator=(Optional&& other) { if (this != &other) m_value = other.m_value; return *this; } constexpr void clear() { m_value = empty_value; } [[nodiscard]] constexpr bool has_value() const { return !m_value.is_invalid({}); } [[nodiscard]] constexpr Utf16FlyString& value() & { VERIFY(has_value()); return m_value; } [[nodiscard]] constexpr Utf16FlyString const& value() const& { VERIFY(has_value()); return m_value; } [[nodiscard]] constexpr Utf16FlyString value() && { return release_value(); } [[nodiscard]] constexpr Utf16FlyString release_value() { VERIFY(has_value()); return exchange(m_value, empty_value); } private: static constexpr Utf16FlyString empty_value { {}, nullptr }; Utf16FlyString m_value { empty_value }; }; template<> struct Traits : public DefaultTraits { static unsigned hash(Utf16FlyString const& string) { return string.hash(); } static constexpr bool may_have_slow_equality_check() { return false; } }; template<> struct Formatter : Formatter { ErrorOr format(FormatBuilder& builder, Utf16FlyString const& string) { return Formatter::format(builder, string.to_utf16_string()); } }; namespace Detail { template<> inline constexpr bool IsHashCompatible = true; template<> inline constexpr bool IsHashCompatible = true; template<> inline constexpr bool IsHashCompatible = true; template<> inline constexpr bool IsHashCompatible = true; } } [[nodiscard]] ALWAYS_INLINE AK::Utf16FlyString operator""_utf16_fly_string(char const* string, size_t length) { AK::StringView view { string, length }; ASSERT(AK::Utf8View { view }.validate()); return AK::Utf16FlyString::from_utf8_without_validation(view); } [[nodiscard]] ALWAYS_INLINE AK::Utf16FlyString operator""_utf16_fly_string(char16_t const* string, size_t length) { return AK::Utf16FlyString::from_utf16({ string, length }); }