#pragma once #include #include #include #include #include #include #include namespace AK { // String is a convenience wrapper around StringImpl, suitable for passing // around as a value type. It's basically the same as passing around a // RetainPtr, with a bit of syntactic sugar. // // Note that StringImpl is an immutable object that cannot shrink or grow. // Its allocation size is snugly tailored to the specific string it contains. // Copying a String is very efficient, since the internal StringImpl is // retainable and so copying only requires modifying the retain count. // // There are three main ways to construct a new String: // // s = String("some literal"); // // s = String::format("%d little piggies", m_piggies); // // StringBuilder builder; // builder.append("abc"); // builder.append("123"); // s = builder.to_string(); class String { public: ~String() {} String() {} String(const StringView& view) { if (view.m_impl) m_impl = *view.m_impl; else m_impl = StringImpl::create(view.characters(), view.length()); } String(const String& other) : m_impl(const_cast(other).m_impl.copy_ref()) { } String(String&& other) : m_impl(move(other.m_impl)) { } String(const char* cstring, ShouldChomp shouldChomp = NoChomp) : m_impl(StringImpl::create(cstring, shouldChomp)) { } String(const char* cstring, int length, ShouldChomp shouldChomp = NoChomp) : m_impl(StringImpl::create(cstring, length, shouldChomp)) { } String(const StringImpl& impl) : m_impl(const_cast(impl)) { } String(const StringImpl* impl) : m_impl(const_cast(impl)) { } String(RetainPtr&& impl) : m_impl(move(impl)) { } String(Retained&& impl) : m_impl(move(impl)) { } enum class CaseSensitivity { CaseInsensitive, CaseSensitive, }; static String repeated(char, int count); bool matches(const StringView& pattern, CaseSensitivity = CaseSensitivity::CaseInsensitive) const; int to_int(bool& ok) const; unsigned to_uint(bool& ok) const; String to_lowercase() const { if (!m_impl) return String(); return m_impl->to_lowercase(); } String to_uppercase() const { if (!m_impl) return String(); return m_impl->to_uppercase(); } Vector split_limit(char separator, int limit) const; Vector split(char separator) const; String substring(int start, int length) const; Vector split_view(char separator) const; StringView substring_view(int start, int length) const; bool is_null() const { return !m_impl; } bool is_empty() const { return length() == 0; } int length() const { return m_impl ? m_impl->length() : 0; } const char* characters() const { return m_impl ? m_impl->characters() : nullptr; } char operator[](int i) const { ASSERT(m_impl); return (*m_impl)[i]; } bool starts_with(const StringView&) const; bool ends_with(const StringView&) const; bool operator==(const String&) const; bool operator!=(const String& other) const { return !(*this == other); } bool operator<(const String&) const; bool operator==(const char* cstring) const { if (is_null()) return !cstring; if (!cstring) return false; return !strcmp(characters(), cstring); } bool operator!=(const char* cstring) const { return !(*this == cstring); } String isolated_copy() const; static String empty(); StringImpl* impl() { return m_impl.ptr(); } const StringImpl* impl() const { return m_impl.ptr(); } String& operator=(String&& other) { if (this != &other) m_impl = move(other.m_impl); return *this; } String& operator=(const String& other) { if (this != &other) m_impl = const_cast(other).m_impl.copy_ref(); return *this; } ByteBuffer to_byte_buffer() const; template static String copy(const BufferType& buffer, ShouldChomp should_chomp = NoChomp) { if (buffer.is_null()) return {}; if (buffer.is_empty()) return empty(); return String((const char*)buffer.data(), buffer.size(), should_chomp); } static String format(const char*, ...); StringView view() const { return { characters(), length() }; } private: bool match_helper(const StringView& mask) const; RetainPtr m_impl; }; inline bool StringView::operator==(const String& string) const { if (string.is_null()) return !m_characters; if (!m_characters) return false; if (m_length != string.length()) return false; if (m_characters == string.characters()) return true; return !memcmp(m_characters, string.characters(), m_length); } template<> struct Traits { static unsigned hash(const String& s) { return s.impl() ? s.impl()->hash() : 0; } static void dump(const String& s) { kprintf("%s", s.characters()); } }; } using AK::String;