/* * 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_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&); static Utf16FlyString from_utf16_without_validation(Utf16View const&); template requires(IsOneOf, Utf16String, Utf16FlyString>) static Utf16FlyString from_utf16(T&&) = delete; Utf16FlyString(Utf16String const&); [[nodiscard]] ALWAYS_INLINE Utf16View view() const { return m_data.utf16_view(); } ALWAYS_INLINE explicit operator Utf16String() const { return to_utf16_string(); } 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) const { return m_data.to_number(trim_whitespace); } 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 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); } // 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<> struct Traits : public DefaultTraits { static unsigned hash(Utf16FlyString const& string) { return string.hash(); } }; template<> struct Formatter : Formatter { ErrorOr format(FormatBuilder& builder, Utf16FlyString const& string) { return Formatter::format(builder, string.to_utf16_string()); } }; } [[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) { AK::Utf16View view { string, length }; ASSERT(view.validate()); return AK::Utf16FlyString::from_utf16_without_validation(view); }