String.hpp

 
//
// TGUI - Texus' Graphical User Interface
// Copyright (C) 2012-2023 Bruno Van de Velde (vdv_b@tgui.eu)
//
// This software is provided 'as-is', without any express or implied warranty.
// In no event will the authors be held liable for any damages arising from the use of this software.
//
// Permission is granted to anyone to use this software for any purpose,
// including commercial applications, and to alter it and redistribute it freely,
// subject to the following restrictions:
//
// 1. The origin of this software must not be misrepresented;
// you must not claim that you wrote the original software.
// If you use this software in a product, an acknowledgment
// in the product documentation would be appreciated but is not required.
//
// 2. Altered source versions must be plainly marked as such,
// and must not be misrepresented as being the original software.
//
// 3. This notice may not be removed or altered from any source distribution.
//
 
 
#ifndef TGUI_STRING_HPP
#define TGUI_STRING_HPP
 
#include <TGUI/Config.hpp>
#include <TGUI/StringView.hpp>
#include <TGUI/Utf.hpp>
 
#if !TGUI_EXPERIMENTAL_USE_STD_MODULE
 #include <string>
 #include <vector>
 #include <cstring>
 #include <locale>
 #include <iomanip>
 #include <ostream>
 #include <sstream>
 #include <type_traits>
 #include <initializer_list>
#endif
 
#if TGUI_HAS_WINDOW_BACKEND_SFML
 #include <SFML/System/String.hpp>
#endif
 
 
TGUI_MODULE_EXPORT namespace tgui
{
 TGUI_NODISCARD TGUI_API bool isWhitespace(char character);
 
 
 TGUI_NODISCARD TGUI_API bool isWhitespace(char32_t character);
 
 
 TGUI_NODISCARD TGUI_API bool isAlpha(char32_t character);
 
 
 TGUI_NODISCARD TGUI_API bool isDigit(char32_t character);
 
 
 
 class TGUI_API String
 {
 private:
 std::u32string m_string;
 
#if TGUI_COMPILED_WITH_CPP_VER >= 17
 // Helper to check if template parameter is a string_view
 template <typename StringViewType>
 using IsStringViewType = std::enable_if_t<
 std::is_same_v<StringViewType, std::string_view>
#if defined(__cpp_lib_char8_t) && (__cpp_lib_char8_t >= 201811L)
 || std::is_same_v<StringViewType, std::u8string_view>
#endif
 || std::is_same_v<StringViewType, std::wstring_view>
 || std::is_same_v<StringViewType, std::u16string_view>
 || std::is_same_v<StringViewType, std::u32string_view>,
 void>;
#endif
 
 public:
 
#if TGUI_COMPILED_WITH_CPP_VER >= 17
 static constexpr auto npos = std::u32string_view::npos;
#else
 static const decltype(std::u32string::npos) npos;
#endif
 
 using iterator = std::u32string::iterator;
 using const_iterator = std::u32string::const_iterator;
 using reverse_iterator = std::u32string::reverse_iterator;
 using const_reverse_iterator = std::u32string::const_reverse_iterator;
 
 using value_type = char32_t;
 using reference = char32_t&;
 using const_reference = const char32_t&;
 
 
 public:
 
 TGUI_NODISCARD bool attemptToInt(int& result) const;
 
 
 TGUI_NODISCARD bool attemptToUInt(unsigned int& result) const;
 
 
 TGUI_NODISCARD bool attemptToFloat(float& result) const;
 
 
 TGUI_NODISCARD int toInt(int defaultValue = 0) const;
 
 
 TGUI_NODISCARD unsigned int toUInt(unsigned int defaultValue = 0) const;
 
 
 TGUI_NODISCARD float toFloat(float defaultValue = 0) const;
 
 
 TGUI_NODISCARD String trim() const;
 
 
 TGUI_NODISCARD String toLower() const;
 
 
 TGUI_NODISCARD String toUpper() const;
 
 
 TGUI_NODISCARD bool equalIgnoreCase(const String& other) const;
 
#ifndef TGUI_REMOVE_DEPRECATED_CODE
 TGUI_DEPRECATED("Use starts_with instead") TGUI_NODISCARD bool startsWith(const String& substring) const;
#endif
 
 TGUI_NODISCARD bool startsWithIgnoreCase(const String& substring) const;
 
#ifndef TGUI_REMOVE_DEPRECATED_CODE
 TGUI_DEPRECATED("Use ends_with instead") TGUI_NODISCARD bool endsWith(const String& substring) const;
#endif
 
 TGUI_NODISCARD bool endsWithIgnoreCase(const String& substring) const;
 
 
 String& replace(const String& searchFor, const String& replaceWith);
 
 
 void remove(const String& substring);
 
 
 TGUI_NODISCARD std::vector<String> split(const String& delimiter, bool trim = false) const;
 
 
 TGUI_NODISCARD static String join(const std::vector<String>& segments, const String& separator);
 
 
 template <typename T>
 TGUI_NODISCARD static String fromNumber(T value)
 {
 std::ostringstream oss;
 oss.imbue(std::locale::classic());
 oss << value;
 return {oss.str()};
 }
 
 
 template <typename T>
 TGUI_NODISCARD static String fromNumberRounded(T value, unsigned int decimals)
 {
 std::ostringstream oss;
 oss.imbue(std::locale::classic());
 oss << std::fixed << std::setprecision(static_cast<int>(decimals));
 oss << value;
 return {oss.str()};
 }
 
 public:
 
 String() = default;
 
 String(const std::string& str);
 String(const std::wstring& str);
 String(const std::u16string& str);
 String(const std::u32string& str);
 
 String(std::u32string&& str) :
 m_string{std::move(str)}
 {
 }
 
 String(char ansiChar);
 String(wchar_t wideChar);
 String(char16_t utfChar);
 String(char32_t utfChar);
 
 String(const char* str);
 String(const wchar_t* str);
 String(const char16_t* str);
 String(const char32_t* str) :
 m_string{str}
 {
 }
 
 // Constructor to initialize the string from a number (integer or float)
 template <typename T, typename = typename std::enable_if_t<std::is_arithmetic<T>::value, T>>
 explicit String(T number) :
 String{fromNumber(number)}
 {
 }
 
 String(std::size_t count, char ch);
 String(std::size_t count, wchar_t ch);
 String(std::size_t count, char16_t ch);
 String(std::size_t count, char32_t ch);
 
 String(const std::string& str, std::size_t pos);
 String(const std::wstring& str, std::size_t pos);
 String(const std::u16string& str, std::size_t pos);
 String(const std::u32string& str, std::size_t pos);
 
 String(const std::string& str, std::size_t pos, std::size_t count);
 String(const std::wstring& str, std::size_t pos, std::size_t count);
 String(const std::u16string& str, std::size_t pos, std::size_t count);
 String(const std::u32string& str, std::size_t pos, std::size_t count);
 
 String(const char* str, std::size_t count);
 String(const wchar_t* str, std::size_t count);
 String(const char16_t* str, std::size_t count);
 String(const char32_t* str, std::size_t count);
 
 explicit String(std::initializer_list<char> chars);
 explicit String(std::initializer_list<wchar_t> chars);
 explicit String(std::initializer_list<char16_t> chars);
 explicit String(std::initializer_list<char32_t> chars);
 
 // Constructors using iterators have to be explicit to prevent {"1", "2"} to be ambiguous between String and std::vector<String>.
 // The reason these constructors were considered a candicate to clang is due to a private constructor in the iterator class.
 // We can't accept string_view::const_iterator iterators, because it would lead to the same kind of ambiguity even when the
 // constructor is marked explicit (in GCC but not MSVC if we define the function normally, in MSVC but not GCC if we use a template).
 explicit String(std::string::const_iterator first, std::string::const_iterator last);
 explicit String(std::wstring::const_iterator first, std::wstring::const_iterator last);
 explicit String(std::u16string::const_iterator first, std::u16string::const_iterator last);
 explicit String(std::u32string::const_iterator first, std::u32string::const_iterator last);
 
#if TGUI_COMPILED_WITH_CPP_VER >= 17
 template <typename StringViewType, typename = IsStringViewType<StringViewType>>
 explicit String(const StringViewType& stringView) :
 String(stringView.data(), stringView.size())
 {
 }
 
 template <typename StringViewType, typename = IsStringViewType<StringViewType>>
 explicit String(const StringViewType& stringView, std::size_t pos, std::size_t count) :
 String(stringView.data() + pos, count)
 {
 }
#else
 template <typename CharType>
 explicit String(StringViewImpl<CharType> stringView) :
 String(stringView.data(), stringView.size())
 {
 }
 
 template <typename CharType>
 explicit String(StringViewImpl<CharType> stringView, std::size_t pos, std::size_t count) :
 String(stringView.data() + pos, count)
 {
 }
#endif
 
#if TGUI_HAS_WINDOW_BACKEND_SFML
 // This constructor has to be explicit or it will cause MSVC to no longer compile code that performs sf::String + std::string
 explicit String(const sf::String& str)
 : m_string{reinterpret_cast<const char32_t*>(str.toUtf32().c_str())}
 {
 }
 
 explicit operator sf::String() const
 {
 return sf::String::fromUtf32(m_string.begin(), m_string.end());
 }
#endif
 
 explicit operator std::string() const;
 explicit operator std::wstring() const;
 explicit operator std::u16string() const;
 explicit operator const std::u32string&() const
 {
 return m_string;
 }
 
 operator StringView() const noexcept
 {
#if TGUI_COMPILED_WITH_CPP_VER >= 17
 return m_string;
#else
 return StringView(m_string.data(), m_string.length());
#endif
 }
 
 TGUI_NODISCARD std::string toStdString() const;
 TGUI_NODISCARD std::wstring toWideString() const;
 TGUI_NODISCARD std::u16string toUtf16() const;
 TGUI_NODISCARD const std::u32string& toUtf32() const
 {
 return m_string;
 }
 
 String& assign(std::size_t count, char ch);
 String& assign(std::size_t count, wchar_t ch);
 String& assign(std::size_t count, char16_t ch);
 String& assign(std::size_t count, char32_t ch);
 
 String& assign(StringView sv);
 String& assign(const char32_t* str);
 String& assign(const std::u32string& str);
 String& assign(const String& str);
 
 String& assign(StringView sv, std::size_t pos, std::size_t count = npos);
 String& assign(const std::string& str, std::size_t pos, std::size_t count = npos);
 String& assign(const std::wstring& str, std::size_t pos, std::size_t count = npos);
 String& assign(const std::u16string& str, std::size_t pos, std::size_t count = npos);
 String& assign(const std::u32string& str, std::size_t pos, std::size_t count = npos);
 String& assign(const String& str, std::size_t pos, std::size_t count = npos);
 
 String& assign(std::u32string&& str);
 String& assign(String&& str);
 
 String& assign(const char* str, std::size_t count);
 String& assign(const wchar_t* str, std::size_t count);
 String& assign(const char16_t* str, std::size_t count);
 String& assign(const char32_t* str, std::size_t count);
 
 String& assign(std::initializer_list<char> chars);
 String& assign(std::initializer_list<wchar_t> chars);
 String& assign(std::initializer_list<char16_t> chars);
 String& assign(std::initializer_list<char32_t> chars);
 
 String& assign(std::string::const_iterator first, std::string::const_iterator last);
 String& assign(std::wstring::const_iterator first, std::wstring::const_iterator last);
 String& assign(std::u16string::const_iterator first, std::u16string::const_iterator last);
 String& assign(std::u32string::const_iterator first, std::u32string::const_iterator last);
 String& assign(StringView::const_iterator first, StringView::const_iterator last);
 
 TGUI_NODISCARD reference at(std::size_t pos);
 TGUI_NODISCARD const_reference at(std::size_t pos) const;
 
 TGUI_NODISCARD const_reference operator [](std::size_t index) const;
 TGUI_NODISCARD reference operator [](std::size_t index);
 
 TGUI_NODISCARD reference front();
 TGUI_NODISCARD const_reference front() const;
 
 TGUI_NODISCARD reference back();
 TGUI_NODISCARD const_reference back() const;
 
 TGUI_NODISCARD const char32_t* data() const noexcept
 {
 return m_string.data();
 }
 
 TGUI_NODISCARD char32_t* data() noexcept
 {
#if __cplusplus >= 201703L
 return m_string.data();
#else
 return &m_string[0];
#endif
 }
 
 TGUI_NODISCARD const char32_t* c_str() const noexcept
 {
 return m_string.c_str();
 }
 
 TGUI_NODISCARD iterator begin() noexcept;
 TGUI_NODISCARD const_iterator begin() const noexcept;
 TGUI_NODISCARD const_iterator cbegin() const noexcept;
 
 TGUI_NODISCARD iterator end() noexcept;
 TGUI_NODISCARD const_iterator end() const noexcept;
 TGUI_NODISCARD const_iterator cend() const noexcept;
 
 TGUI_NODISCARD reverse_iterator rbegin() noexcept;
 TGUI_NODISCARD const_reverse_iterator rbegin() const noexcept;
 TGUI_NODISCARD const_reverse_iterator crbegin() const noexcept;
 
 TGUI_NODISCARD reverse_iterator rend() noexcept;
 TGUI_NODISCARD const_reverse_iterator rend() const noexcept;
 TGUI_NODISCARD const_reverse_iterator crend() const noexcept;
 
 TGUI_NODISCARD bool empty() const noexcept
 {
 return m_string.empty();
 }
 
 TGUI_NODISCARD std::size_t size() const noexcept
 {
 return m_string.size();
 }
 
 TGUI_NODISCARD std::size_t length() const noexcept
 {
 return m_string.length();
 }
 
 TGUI_NODISCARD std::size_t max_size() const noexcept;
 
 void reserve(std::size_t newCap);
 TGUI_NODISCARD std::size_t capacity() const noexcept;
 void shrink_to_fit();
 
 void clear() noexcept;
 
 String& insert(std::size_t index, std::size_t count, char ch);
 String& insert(std::size_t index, std::size_t count, wchar_t ch);
 String& insert(std::size_t index, std::size_t count, char16_t ch);
 String& insert(std::size_t index, std::size_t count, char32_t ch);
 
 String& insert(std::size_t index, StringView sv);
 String& insert(std::size_t index, const char32_t* str);
 String& insert(std::size_t index, const std::u32string& str);
 String& insert(std::size_t index, const String& str);
 
 String& insert(std::size_t index, StringView sv, std::size_t pos, std::size_t count = npos);
 String& insert(std::size_t index, const std::string& str, std::size_t pos, std::size_t count = npos);
 String& insert(std::size_t index, const std::wstring& str, std::size_t pos, std::size_t count = npos);
 String& insert(std::size_t index, const std::u16string& str, std::size_t pos, std::size_t count = npos);
 String& insert(std::size_t index, const std::u32string& str, std::size_t pos, std::size_t count = npos);
 String& insert(std::size_t index, const String& str, std::size_t pos, std::size_t count = npos);
 
 String& insert(std::size_t index, const char* str, std::size_t count);
 String& insert(std::size_t index, const wchar_t* str, std::size_t count);
 String& insert(std::size_t index, const char16_t* str, std::size_t count);
 String& insert(std::size_t index, const char32_t* str, std::size_t count);
 
 iterator insert(const_iterator pos, char ch);
 iterator insert(const_iterator pos, wchar_t ch);
 iterator insert(const_iterator pos, char16_t ch);
 iterator insert(const_iterator pos, char32_t ch);
 
 iterator insert(const_iterator pos, std::size_t count, char ch);
 iterator insert(const_iterator pos, std::size_t count, wchar_t ch);
 iterator insert(const_iterator pos, std::size_t count, char16_t ch);
 iterator insert(const_iterator pos, std::size_t count, char32_t ch);
 
 iterator insert(const_iterator pos, std::initializer_list<char> chars);
 iterator insert(const_iterator pos, std::initializer_list<wchar_t> chars);
 iterator insert(const_iterator pos, std::initializer_list<char16_t> chars);
 iterator insert(const_iterator pos, std::initializer_list<char32_t> chars);
 
 iterator insert(const_iterator pos, std::string::const_iterator first, std::string::const_iterator last);
 iterator insert(const_iterator pos, std::wstring::const_iterator first, std::wstring::const_iterator last);
 iterator insert(const_iterator pos, std::u16string::const_iterator first, std::u16string::const_iterator last);
 iterator insert(const_iterator pos, std::u32string::const_iterator first, std::u32string::const_iterator last);
 iterator insert(const_iterator pos, StringView::const_iterator first, StringView::const_iterator last);
 
 String& erase(std::size_t index = 0, std::size_t count = npos);
 
 iterator erase(const_iterator position);
 iterator erase(const_iterator first, const_iterator last);
 
 void push_back(char ch);
 void push_back(wchar_t ch);
 void push_back(char16_t ch);
 void push_back(char32_t ch);
 
 void pop_back();
 
 String& append(std::size_t count, char ch);
 String& append(std::size_t count, wchar_t ch);
 String& append(std::size_t count, char16_t ch);
 String& append(std::size_t count, char32_t ch);
 
 String& append(StringView sv);
 String& append(const char32_t* str);
 String& append(const std::u32string& str);
 String& append(const String& str);
 
 String& append(StringView sv, std::size_t pos, std::size_t count = npos);
 String& append(const std::string& str, std::size_t pos, std::size_t count = npos);
 String& append(const std::wstring& str, std::size_t pos, std::size_t count = npos);
 String& append(const std::u16string& str, std::size_t pos, std::size_t count = npos);
 String& append(const std::u32string& str, std::size_t pos, std::size_t count = npos);
 String& append(const String& str, std::size_t pos, std::size_t count = npos);
 
 String& append(const char* str, std::size_t count);
 String& append(const wchar_t* str, std::size_t count);
 String& append(const char16_t* str, std::size_t count);
 String& append(const char32_t* str, std::size_t count);
 
 String& append(std::string::const_iterator first, std::string::const_iterator last);
 String& append(std::wstring::const_iterator first, std::wstring::const_iterator last);
 String& append(std::u16string::const_iterator first, std::u16string::const_iterator last);
 String& append(std::u32string::const_iterator first, std::u32string::const_iterator last);
 String& append(StringView::const_iterator first, StringView::const_iterator last);
 
 String& append(std::initializer_list<char> chars);
 String& append(std::initializer_list<wchar_t> chars);
 String& append(std::initializer_list<char16_t> chars);
 String& append(std::initializer_list<char32_t> chars);
 
 String& operator+=(const String& str);
 
 TGUI_NODISCARD int compare(StringView sv) const noexcept;
 TGUI_NODISCARD int compare(const char32_t* s) const;
 TGUI_NODISCARD int compare(const std::u32string& str) const noexcept;
 TGUI_NODISCARD int compare(const String& str) const noexcept;
 
 TGUI_NODISCARD int compare(std::size_t pos1, std::size_t count1, StringView sv) const;
 TGUI_NODISCARD int compare(std::size_t pos1, std::size_t count1, const char32_t* s) const;
 TGUI_NODISCARD int compare(std::size_t pos1, std::size_t count1, const std::u32string& str) const;
 TGUI_NODISCARD int compare(std::size_t pos1, std::size_t count1, const String& str) const;
 
 TGUI_NODISCARD int compare(std::size_t pos1, std::size_t count1, StringView sv, std::size_t pos2, std::size_t count2 = npos) const;
 TGUI_NODISCARD int compare(std::size_t pos1, std::size_t count1, const std::string& str, std::size_t pos2, std::size_t count2 = npos) const;
 TGUI_NODISCARD int compare(std::size_t pos1, std::size_t count1, const std::wstring& str, std::size_t pos2, std::size_t count2 = npos) const;
 TGUI_NODISCARD int compare(std::size_t pos1, std::size_t count1, const std::u16string& str, std::size_t pos2, std::size_t count2 = npos) const;
 TGUI_NODISCARD int compare(std::size_t pos1, std::size_t count1, const std::u32string& str, std::size_t pos2, std::size_t count2 = npos) const;
 TGUI_NODISCARD int compare(std::size_t pos1, std::size_t count1, const String& str, std::size_t pos2, std::size_t count2 = npos) const;
 
 TGUI_NODISCARD int compare(std::size_t pos1, std::size_t count1, const char* s, std::size_t count2) const;
 TGUI_NODISCARD int compare(std::size_t pos1, std::size_t count1, const wchar_t* s, std::size_t count2) const;
 TGUI_NODISCARD int compare(std::size_t pos1, std::size_t count1, const char16_t* s, std::size_t count2) const;
 TGUI_NODISCARD int compare(std::size_t pos1, std::size_t count1, const char32_t* s, std::size_t count2) const;
 
 String& replace(std::size_t pos, std::size_t count, StringView sv);
 String& replace(std::size_t pos, std::size_t count, const char32_t* cstr);
 String& replace(std::size_t pos, std::size_t count, const std::u32string& str);
 String& replace(std::size_t pos, std::size_t count, const String& str);
 
 String& replace(const_iterator first, const_iterator last, StringView sv);
 String& replace(const_iterator first, const_iterator last, const char32_t* cstr);
 String& replace(const_iterator first, const_iterator last, const std::u32string& str);
 String& replace(const_iterator first, const_iterator last, const String& str);
 
 String& replace(std::size_t pos, std::size_t count, StringView sv, std::size_t pos2, std::size_t count2 = npos);
 String& replace(std::size_t pos, std::size_t count, const std::string& str, std::size_t pos2, std::size_t count2 = npos);
 String& replace(std::size_t pos, std::size_t count, const std::wstring& str, std::size_t pos2, std::size_t count2 = npos);
 String& replace(std::size_t pos, std::size_t count, const std::u16string& str, std::size_t pos2, std::size_t count2 = npos);
 String& replace(std::size_t pos, std::size_t count, const std::u32string& str, std::size_t pos2, std::size_t count2 = npos);
 String& replace(std::size_t pos, std::size_t count, const String& str, std::size_t pos2, std::size_t count2 = npos);
 
 String& replace(const_iterator first, const_iterator last, std::string::const_iterator first2, std::string::const_iterator last2);
 String& replace(const_iterator first, const_iterator last, std::wstring::const_iterator first2, std::wstring::const_iterator last2);
 String& replace(const_iterator first, const_iterator last, std::u16string::const_iterator first2, std::u16string::const_iterator last2);
 String& replace(const_iterator first, const_iterator last, std::u32string::const_iterator first2, std::u32string::const_iterator last2);
 String& replace(const_iterator first, const_iterator last, StringView::const_iterator first2, StringView::const_iterator last2);
 
 String& replace(std::size_t pos, std::size_t count, const char* cstr, std::size_t count2);
 String& replace(std::size_t pos, std::size_t count, const wchar_t* cstr, std::size_t count2);
 String& replace(std::size_t pos, std::size_t count, const char16_t* cstr, std::size_t count2);
 String& replace(std::size_t pos, std::size_t count, const char32_t* cstr, std::size_t count2);
 
 String& replace(const_iterator first, const_iterator last, const char* cstr, std::size_t count2);
 String& replace(const_iterator first, const_iterator last, const wchar_t* cstr, std::size_t count2);
 String& replace(const_iterator first, const_iterator last, const char16_t* cstr, std::size_t count2);
 String& replace(const_iterator first, const_iterator last, const char32_t* cstr, std::size_t count2);
 
 String& replace(std::size_t pos, std::size_t count, std::size_t count2, char ch);
 String& replace(std::size_t pos, std::size_t count, std::size_t count2, wchar_t ch);
 String& replace(std::size_t pos, std::size_t count, std::size_t count2, char16_t ch);
 String& replace(std::size_t pos, std::size_t count, std::size_t count2, char32_t ch);
 
 String& replace(const_iterator first, const_iterator last, std::size_t count2, char ch);
 String& replace(const_iterator first, const_iterator last, std::size_t count2, wchar_t ch);
 String& replace(const_iterator first, const_iterator last, std::size_t count2, char16_t ch);
 String& replace(const_iterator first, const_iterator last, std::size_t count2, char32_t ch);
 
 String& replace(const_iterator first, const_iterator last, std::initializer_list<char> chars);
 String& replace(const_iterator first, const_iterator last, std::initializer_list<wchar_t> chars);
 String& replace(const_iterator first, const_iterator last, std::initializer_list<char16_t> chars);
 String& replace(const_iterator first, const_iterator last, std::initializer_list<char32_t> chars);
 
 TGUI_NODISCARD String substr(std::size_t pos = 0, std::size_t count = npos) const;
 
 std::size_t copy(char32_t* dest, std::size_t count, std::size_t pos = 0) const;
 
 void resize(std::size_t count);
 void resize(std::size_t count, char ch);
 void resize(std::size_t count, wchar_t ch);
 void resize(std::size_t count, char16_t ch);
 void resize(std::size_t count, char32_t ch);
 
 void swap(String& other);
 
 TGUI_NODISCARD bool contains(char c) const noexcept;
 TGUI_NODISCARD bool contains(wchar_t c) const noexcept;
 TGUI_NODISCARD bool contains(char16_t c) const noexcept;
 TGUI_NODISCARD bool contains(char32_t c) const noexcept;
 
 TGUI_NODISCARD bool contains(StringView sv) const noexcept;
 TGUI_NODISCARD bool contains(const char32_t* s) const;
 TGUI_NODISCARD bool contains(const std::u32string& s) const;
 TGUI_NODISCARD bool contains(const String& s) const;
 
 TGUI_NODISCARD std::size_t find(StringView sv, std::size_t pos = 0) const noexcept;
 TGUI_NODISCARD std::size_t find(const char32_t* s, std::size_t pos = 0) const;
 TGUI_NODISCARD std::size_t find(const std::u32string& str, std::size_t pos = 0) const noexcept;
 TGUI_NODISCARD std::size_t find(const String& str, std::size_t pos = 0) const noexcept;
 
 TGUI_NODISCARD std::size_t find(const char* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD std::size_t find(const wchar_t* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD std::size_t find(const char16_t* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD std::size_t find(const char32_t* s, std::size_t pos, std::size_t count) const;
 
 TGUI_NODISCARD std::size_t find(char ch, std::size_t pos = 0) const noexcept;
 TGUI_NODISCARD std::size_t find(wchar_t ch, std::size_t pos = 0) const noexcept;
 TGUI_NODISCARD std::size_t find(char16_t ch, std::size_t pos = 0) const noexcept;
 TGUI_NODISCARD std::size_t find(char32_t ch, std::size_t pos = 0) const noexcept;
 
 TGUI_NODISCARD std::size_t find_first_of(StringView sv, std::size_t pos = 0) const noexcept;
 TGUI_NODISCARD std::size_t find_first_of(const char32_t* s, std::size_t pos = 0) const;
 TGUI_NODISCARD std::size_t find_first_of(const std::u32string& str, std::size_t pos = 0) const noexcept;
 TGUI_NODISCARD std::size_t find_first_of(const String& str, std::size_t pos = 0) const noexcept;
 
 TGUI_NODISCARD std::size_t find_first_of(const char* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD std::size_t find_first_of(const wchar_t* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD std::size_t find_first_of(const char16_t* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD std::size_t find_first_of(const char32_t* s, std::size_t pos, std::size_t count) const;
 
 TGUI_NODISCARD std::size_t find_first_of(char ch, std::size_t pos = 0) const noexcept;
 TGUI_NODISCARD std::size_t find_first_of(wchar_t ch, std::size_t pos = 0) const noexcept;
 TGUI_NODISCARD std::size_t find_first_of(char16_t ch, std::size_t pos = 0) const noexcept;
 TGUI_NODISCARD std::size_t find_first_of(char32_t ch, std::size_t pos = 0) const noexcept;
 
 TGUI_NODISCARD std::size_t find_first_not_of(StringView sv, std::size_t pos = 0) const noexcept;
 TGUI_NODISCARD std::size_t find_first_not_of(const char32_t* s, std::size_t pos = 0) const;
 TGUI_NODISCARD std::size_t find_first_not_of(const std::u32string& str, std::size_t pos = 0) const noexcept;
 TGUI_NODISCARD std::size_t find_first_not_of(const String& str, std::size_t pos = 0) const noexcept;
 
 TGUI_NODISCARD std::size_t find_first_not_of(const char* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD std::size_t find_first_not_of(const wchar_t* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD std::size_t find_first_not_of(const char16_t* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD std::size_t find_first_not_of(const char32_t* s, std::size_t pos, std::size_t count) const;
 
 TGUI_NODISCARD std::size_t find_first_not_of(char ch, std::size_t pos = 0) const noexcept;
 TGUI_NODISCARD std::size_t find_first_not_of(wchar_t ch, std::size_t pos = 0) const noexcept;
 TGUI_NODISCARD std::size_t find_first_not_of(char16_t ch, std::size_t pos = 0) const noexcept;
 TGUI_NODISCARD std::size_t find_first_not_of(char32_t ch, std::size_t pos = 0) const noexcept;
 
 TGUI_NODISCARD std::size_t rfind(StringView sv, std::size_t pos = npos) const noexcept;
 TGUI_NODISCARD std::size_t rfind(const char32_t* s, std::size_t pos = npos) const;
 TGUI_NODISCARD std::size_t rfind(const std::u32string& str, std::size_t pos = npos) const noexcept;
 TGUI_NODISCARD std::size_t rfind(const String& str, std::size_t pos = npos) const noexcept;
 
 TGUI_NODISCARD std::size_t rfind(const char* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD std::size_t rfind(const wchar_t* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD std::size_t rfind(const char16_t* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD std::size_t rfind(const char32_t* s, std::size_t pos, std::size_t count) const;
 
 TGUI_NODISCARD std::size_t rfind(char ch, std::size_t pos = npos) const noexcept;
 TGUI_NODISCARD std::size_t rfind(wchar_t ch, std::size_t pos = npos) const noexcept;
 TGUI_NODISCARD std::size_t rfind(char16_t ch, std::size_t pos = npos) const noexcept;
 TGUI_NODISCARD std::size_t rfind(char32_t ch, std::size_t pos = npos) const noexcept;
 
 TGUI_NODISCARD std::size_t find_last_of(StringView sv, std::size_t pos = npos) const noexcept;
 TGUI_NODISCARD std::size_t find_last_of(const char32_t* s, std::size_t pos = npos) const;
 TGUI_NODISCARD std::size_t find_last_of(const std::u32string& str, std::size_t pos = npos) const noexcept;
 TGUI_NODISCARD std::size_t find_last_of(const String& str, std::size_t pos = npos) const noexcept;
 
 TGUI_NODISCARD std::size_t find_last_of(const char* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD std::size_t find_last_of(const wchar_t* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD std::size_t find_last_of(const char16_t* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD std::size_t find_last_of(const char32_t* s, std::size_t pos, std::size_t count) const;
 
 TGUI_NODISCARD std::size_t find_last_of(char ch, std::size_t pos = npos) const noexcept;
 TGUI_NODISCARD std::size_t find_last_of(wchar_t ch, std::size_t pos = npos) const noexcept;
 TGUI_NODISCARD std::size_t find_last_of(char16_t ch, std::size_t pos = npos) const noexcept;
 TGUI_NODISCARD std::size_t find_last_of(char32_t ch, std::size_t pos = npos) const noexcept;
 
 TGUI_NODISCARD std::size_t find_last_not_of(StringView sv, std::size_t pos = npos) const noexcept;
 TGUI_NODISCARD std::size_t find_last_not_of(const char32_t* s, std::size_t pos = npos) const;
 TGUI_NODISCARD std::size_t find_last_not_of(const std::u32string& str, std::size_t pos = npos) const noexcept;
 TGUI_NODISCARD std::size_t find_last_not_of(const String& str, std::size_t pos = npos) const noexcept;
 
 TGUI_NODISCARD std::size_t find_last_not_of(const char* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD std::size_t find_last_not_of(const wchar_t* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD std::size_t find_last_not_of(const char16_t* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD std::size_t find_last_not_of(const char32_t* s, std::size_t pos, std::size_t count) const;
 
 TGUI_NODISCARD std::size_t find_last_not_of(char ch, std::size_t pos = npos) const noexcept;
 TGUI_NODISCARD std::size_t find_last_not_of(wchar_t ch, std::size_t pos = npos) const noexcept;
 TGUI_NODISCARD std::size_t find_last_not_of(char16_t ch, std::size_t pos = npos) const noexcept;
 TGUI_NODISCARD std::size_t find_last_not_of(char32_t ch, std::size_t pos = npos) const noexcept;
 
 TGUI_NODISCARD inline bool starts_with(StringView sv) const noexcept;
 TGUI_NODISCARD inline bool starts_with(const char32_t* s) const;
 TGUI_NODISCARD inline bool starts_with(const std::u32string& s) const;
 TGUI_NODISCARD inline bool starts_with(const String& s) const;
 
 TGUI_NODISCARD inline bool starts_with(char ch) const noexcept;
 TGUI_NODISCARD inline bool starts_with(wchar_t ch) const noexcept;
 TGUI_NODISCARD inline bool starts_with(char16_t ch) const noexcept;
 TGUI_NODISCARD inline bool starts_with(char32_t ch) const noexcept;
 
 TGUI_NODISCARD inline bool ends_with(StringView sv) const noexcept;
 TGUI_NODISCARD inline bool ends_with(const char32_t* s) const;
 TGUI_NODISCARD inline bool ends_with(const std::u32string& s) const;
 TGUI_NODISCARD inline bool ends_with(const String& s) const;
 
 TGUI_NODISCARD inline bool ends_with(char ch) const noexcept;
 TGUI_NODISCARD inline bool ends_with(wchar_t ch) const noexcept;
 TGUI_NODISCARD inline bool ends_with(char16_t ch) const noexcept;
 TGUI_NODISCARD inline bool ends_with(char32_t ch) const noexcept;
 
 TGUI_NODISCARD std::size_t count(const char ch, const std::size_t pos = 0) const noexcept;
 TGUI_NODISCARD std::size_t count(const wchar_t ch, const std::size_t pos = 0) const noexcept;
 TGUI_NODISCARD std::size_t count(const char16_t ch, const std::size_t pos = 0) const noexcept;
 TGUI_NODISCARD std::size_t count(const char32_t ch, const std::size_t pos = 0) const noexcept;
 
 inline friend bool operator==(const String& left, StringView right);
 inline friend bool operator==(const String& left, const char32_t* right);
 inline friend bool operator==(const String& left, const std::u32string& right);
 inline friend bool operator==(const String& left, const String& right);
 
 inline friend bool operator!=(const String& left, StringView right);
 inline friend bool operator!=(const String& left, const char32_t* right);
 inline friend bool operator!=(const String& left, const std::u32string& right);
 inline friend bool operator!=(const String& left, const String& right);
 
 inline friend bool operator<(const String& left, StringView right);
 inline friend bool operator<(const String& left, const char32_t* right);
 inline friend bool operator<(const String& left, const std::u32string& right);
 inline friend bool operator<(const String& left, const String& right);
 
 inline friend bool operator<=(const String& left, StringView right);
 inline friend bool operator<=(const String& left, const char32_t* right);
 inline friend bool operator<=(const String& left, const std::u32string& right);
 inline friend bool operator<=(const String& left, const String& right);
 
 inline friend bool operator>(const String& left, StringView right);
 inline friend bool operator>(const String& left, const char32_t* right);
 inline friend bool operator>(const String& left, const std::u32string& right);
 inline friend bool operator>(const String& left, const String& right);
 
 inline friend bool operator>=(const String& left, StringView right);
 inline friend bool operator>=(const String& left, const char32_t* right);
 inline friend bool operator>=(const String& left, const std::u32string& right);
 inline friend bool operator>=(const String& left, const String& right);
 
 inline friend String operator+(const String& left, const String& right);
 inline friend String operator+(const String& left, String&& right);
 inline friend String operator+(String&& left, const String& right);
 inline friend String operator+(String&& left, String&& right);
 
#if defined(__cpp_lib_char8_t) && (__cpp_lib_char8_t >= 201811L)
 inline String(const std::u8string& str);
 inline String(char8_t utfChar);
 inline String(const char8_t* str);
 inline String(std::size_t count, char8_t ch);
 inline String(const std::u8string& str, std::size_t pos);
 inline String(const std::u8string& str, std::size_t pos, std::size_t count);
 inline String(const char8_t* str, std::size_t count);
 inline explicit String(std::initializer_list<char8_t> chars);
 inline explicit String(std::u8string::const_iterator first, std::u8string::const_iterator last);
 
 inline explicit operator std::u8string() const;
 
 TGUI_NODISCARD inline std::u8string toUtf8() const;
 
 inline String& assign(std::size_t count, char8_t ch);
 inline String& assign(const std::u8string& str, std::size_t pos, std::size_t count = npos);
 inline String& assign(const char8_t* str, std::size_t count);
 inline String& assign(std::initializer_list<char8_t> chars);
 inline String& assign(std::u8string::const_iterator first, std::u8string::const_iterator last);
 
 inline String& insert(std::size_t index, std::size_t count, char8_t ch);
 inline String& insert(std::size_t index, const std::u8string& str, std::size_t pos, std::size_t count = npos);
 inline String& insert(std::size_t index, const char8_t* str, std::size_t count);
 inline iterator insert(const_iterator pos, char8_t ch);
 inline iterator insert(const_iterator pos, std::size_t count, char8_t ch);
 inline iterator insert(const_iterator pos, std::initializer_list<char8_t> chars);
 inline iterator insert(const_iterator pos, std::u8string::const_iterator first, std::u8string::const_iterator last);
 
 inline String& append(std::size_t count, char8_t ch);
 inline String& append(const std::u8string& str, std::size_t pos, std::size_t count = npos);
 inline String& append(const char8_t* str, std::size_t count);
 inline String& append(std::initializer_list<char8_t> chars);
 inline String& append(std::u8string::const_iterator first, std::u8string::const_iterator last);
 
 TGUI_NODISCARD inline int compare(std::size_t pos1, std::size_t count1, const std::u8string& str, std::size_t pos2, std::size_t count2 = npos) const;
 TGUI_NODISCARD inline int compare(std::size_t pos1, std::size_t count1, const char8_t* s, std::size_t count2) const;
 
 inline String& replace(std::size_t pos, std::size_t count, const std::u8string& str, std::size_t pos2, std::size_t count2 = npos);
 inline String& replace(const_iterator first, const_iterator last, std::u8string::const_iterator first2, std::u8string::const_iterator last2);
 inline String& replace(std::size_t pos, std::size_t count, const char8_t* cstr, std::size_t count2);
 inline String& replace(const_iterator first, const_iterator last, const char8_t* cstr, std::size_t count2);
 inline String& replace(std::size_t pos, std::size_t count, std::size_t count2, char8_t ch);
 inline String& replace(const_iterator first, const_iterator last, std::size_t count2, char8_t ch);
 inline String& replace(const_iterator first, const_iterator last, std::initializer_list<char8_t> chars);
 
 inline void resize(std::size_t count, char8_t ch);
 
 TGUI_NODISCARD inline bool contains(char8_t c) const noexcept;
 
 TGUI_NODISCARD inline std::size_t find(const char8_t* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD inline std::size_t find(char8_t ch, std::size_t pos = 0) const noexcept;
 
 TGUI_NODISCARD inline std::size_t find_first_of(const char8_t* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD inline std::size_t find_first_of(char8_t ch, std::size_t pos = 0) const noexcept;
 
 TGUI_NODISCARD inline std::size_t find_first_not_of(const char8_t* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD inline std::size_t find_first_not_of(char8_t ch, std::size_t pos = 0) const noexcept;
 
 TGUI_NODISCARD inline std::size_t rfind(const char8_t* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD inline std::size_t rfind(char8_t ch, std::size_t pos = npos) const noexcept;
 
 TGUI_NODISCARD inline std::size_t find_last_of(const char8_t* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD inline std::size_t find_last_of(char8_t ch, std::size_t pos = npos) const noexcept;
 
 TGUI_NODISCARD inline std::size_t find_last_not_of(const char8_t* s, std::size_t pos, std::size_t count) const;
 TGUI_NODISCARD inline std::size_t find_last_not_of(char8_t ch, std::size_t pos = npos) const noexcept;
 
 TGUI_NODISCARD inline bool starts_with(char8_t ch) const noexcept;
 TGUI_NODISCARD inline bool ends_with(char8_t ch) const noexcept;
#endif
 };
 
 
 inline bool String::starts_with(StringView sv) const noexcept
 {
 return viewStartsWith(StringView(m_string), sv);
 }
 
 inline bool String::starts_with(const char32_t* s) const
 {
 return viewStartsWith(StringView(m_string), StringView(s));
 }
 
 inline bool String::starts_with(const std::u32string& s) const
 {
 return viewStartsWith(StringView(m_string), StringView(s));
 }
 
 inline bool String::starts_with(const String& s) const
 {
 return viewStartsWith(StringView(m_string), StringView(s));
 }
 
 inline bool String::starts_with(char ch) const noexcept
 {
 return viewStartsWith(StringView(m_string), static_cast<char32_t>(ch));
 }
 
 inline bool String::starts_with(wchar_t ch) const noexcept
 {
 return viewStartsWith(StringView(m_string), static_cast<char32_t>(ch));
 }
 
 inline bool String::starts_with(char16_t ch) const noexcept
 {
 return viewStartsWith(StringView(m_string), static_cast<char32_t>(ch));
 }
 
 inline bool String::starts_with(char32_t ch) const noexcept
 {
 return viewStartsWith(StringView(m_string), ch);
 }
 
 inline bool String::ends_with(StringView sv) const noexcept
 {
 return viewEndsWith(StringView(m_string), sv);
 }
 
 inline bool String::ends_with(const char32_t* s) const
 {
 return viewEndsWith(StringView(m_string), StringView(s));
 }
 
 inline bool String::ends_with(const std::u32string& s) const
 {
 return viewEndsWith(StringView(m_string), StringView(s));
 }
 
 inline bool String::ends_with(const String& s) const
 {
 return viewEndsWith(StringView(m_string), StringView(s));
 }
 
 inline bool String::ends_with(char ch) const noexcept
 {
 return viewEndsWith(StringView(m_string), static_cast<char32_t>(ch));
 }
 
 inline bool String::ends_with(wchar_t ch) const noexcept
 {
 return viewEndsWith(StringView(m_string), static_cast<char32_t>(ch));
 }
 
 inline bool String::ends_with(char16_t ch) const noexcept
 {
 return viewEndsWith(StringView(m_string), static_cast<char32_t>(ch));
 }
 
 inline bool String::ends_with(char32_t ch) const noexcept
 {
 return viewEndsWith(StringView(m_string), ch);
 }
 
 
 TGUI_NODISCARD inline bool operator==(const String& left, StringView right)
 {
 return StringView(left) == right;
 }
 
 TGUI_NODISCARD inline bool operator==(const String& left, const char32_t* right)
 {
 return StringView(left) == right;
 }
 
 TGUI_NODISCARD inline bool operator==(const String& left, const std::u32string& right)
 {
 return StringView(left) == right;
 }
 
 TGUI_NODISCARD inline bool operator==(const String& left, const String& right)
 {
 return left.m_string == right.m_string;
 }
 
 TGUI_NODISCARD inline bool operator!=(const String& left, StringView right)
 {
 return StringView(left) != right;
 }
 
 TGUI_NODISCARD inline bool operator!=(const String& left, const char32_t* right)
 {
 return StringView(left) != right;
 }
 
 TGUI_NODISCARD inline bool operator!=(const String& left, const std::u32string& right)
 {
 return StringView(left) != right;
 }
 
 TGUI_NODISCARD inline bool operator!=(const String& left, const String& right)
 {
 return left.m_string != right.m_string;
 }
 
 TGUI_NODISCARD inline bool operator<(const String& left, StringView right)
 {
 return StringView(left) < right;
 }
 
 TGUI_NODISCARD inline bool operator<(const String& left, const char32_t* right)
 {
 return StringView(left) < right;
 }
 
 TGUI_NODISCARD inline bool operator<(const String& left, const std::u32string& right)
 {
 return StringView(left) < right;
 }
 
 TGUI_NODISCARD inline bool operator<(const String& left, const String& right)
 {
 return left.m_string < right.m_string;
 }
 
 TGUI_NODISCARD inline bool operator<=(const String& left, StringView right)
 {
 return StringView(left) <= right;
 }
 
 TGUI_NODISCARD inline bool operator<=(const String& left, const char32_t* right)
 {
 return StringView(left) <= right;
 }
 
 TGUI_NODISCARD inline bool operator<=(const String& left, const std::u32string& right)
 {
 return StringView(left) <= right;
 }
 
 TGUI_NODISCARD inline bool operator<=(const String& left, const String& right)
 {
 return left.m_string <= right.m_string;
 }
 
 TGUI_NODISCARD inline bool operator>(const String& left, StringView right)
 {
 return StringView(left) > right;
 }
 
 TGUI_NODISCARD inline bool operator>(const String& left, const char32_t* right)
 {
 return StringView(left) > right;
 }
 
 TGUI_NODISCARD inline bool operator>(const String& left, const std::u32string& right)
 {
 return StringView(left) > right;
 }
 
 TGUI_NODISCARD inline bool operator>(const String& left, const String& right)
 {
 return left.m_string > right.m_string;
 }
 
 TGUI_NODISCARD inline bool operator>=(const String& left, StringView right)
 {
 return StringView(left) >= right;
 }
 
 TGUI_NODISCARD inline bool operator>=(const String& left, const char32_t* right)
 {
 return StringView(left) >= right;
 }
 
 TGUI_NODISCARD inline bool operator>=(const String& left, const std::u32string& right)
 {
 return StringView(left) >= right;
 }
 
 TGUI_NODISCARD inline bool operator>=(const String& left, const String& right)
 {
 return left.m_string >= right.m_string;
 }
 
 TGUI_NODISCARD inline String operator+(const String& left, const String& right)
 {
 return {left.m_string + right.m_string};
 }
 TGUI_NODISCARD inline String operator+(String&& left, String&& right)
 {
 return {std::move(left.m_string) + std::move(right.m_string)};
 }
 TGUI_NODISCARD inline String operator+(String&& left, const String& right)
 {
 return {std::move(left.m_string) + right.m_string};
 }
 TGUI_NODISCARD inline String operator+(const String& left, String&& right)
 {
 return {left.m_string + std::move(right.m_string)};
 }
 
 // We don't provide operator<< implmentations for basic_ostream<charX_t> streams because
 // even clang 15 can't compile them when using libc++.
 // We could define them for VS, GCC and for clang with libstdc++, but there is no real use for them.
 TGUI_API std::ostream& operator<<(std::ostream& os, const String& str);
 TGUI_API std::wostream& operator<<(std::wostream& os, const String& str);
 
 TGUI_API std::istream& operator>>(std::istream& os, String& str);
 TGUI_API std::wistream& operator>>(std::wistream& os, String& str);
 
 
 // UTF-8 function are defined in the header so that they can be enabled/disabled based on
 // the compiler settings without having to recompile TGUI with a different c++ standard.
#if defined(__cpp_lib_char8_t) && (__cpp_lib_char8_t >= 201811L)
 inline String::String(const std::u8string& str) :
 m_string(utf::convertUtf8toUtf32(str.begin(), str.end()))
 {
 }
 
 inline String::String(char8_t utfChar)
 : m_string(1, static_cast<char32_t>(utfChar))
 {
 }
 
 inline String::String(const char8_t* str)
 : String{utf::convertUtf8toUtf32(str, str + std::char_traits<char8_t>::length(str))}
 {
 }
 
 inline String::String(std::size_t count, char8_t ch)
 : m_string(count, static_cast<char32_t>(ch))
 {
 }
 
 inline String::String(const std::u8string& str, std::size_t pos)
 : String{std::u8string(str, pos)}
 {
 }
 
 inline String::String(const std::u8string& str, std::size_t pos, std::size_t count)
 : String{std::u8string(str, pos, count)}
 {
 }
 
 inline String::String(const char8_t* str, std::size_t count)
 : String{std::u8string{str, count}}
 {
 }
 
 inline String::String(std::initializer_list<char8_t> chars)
 : String(std::u8string(chars.begin(), chars.end()))
 {
 }
 
 inline String::String(std::u8string::const_iterator first, std::u8string::const_iterator last)
 : String{std::u8string(first, last)}
 {
 }
 
 inline String::operator std::u8string() const
 {
 return utf::convertUtf32toUtf8(m_string);
 }
 
 inline std::u8string String::toUtf8() const
 {
 return utf::convertUtf32toUtf8(m_string);
 }
 
 inline String& String::assign(const std::u8string& str, std::size_t pos, std::size_t count)
 {
 m_string.assign(String{str, pos, count}.m_string);
 return *this;
 }
 
 inline String& String::assign(const char8_t* str, std::size_t count)
 {
 m_string.assign(String{str, count}.m_string);
 return *this;
 }
 
 inline String& String::assign(std::size_t count, char8_t ch)
 {
 m_string.assign(count, static_cast<char32_t>(ch));
 return *this;
 }
 
 inline String& String::assign(std::initializer_list<char8_t> chars)
 {
 m_string.assign(String{chars}.m_string);
 return *this;
 }
 
 inline String& String::assign(std::u8string::const_iterator first, std::u8string::const_iterator last)
 {
 m_string.assign(String{first, last}.m_string);
 return *this;
 }
 
 inline String& String::insert(std::size_t index, std::size_t count, char8_t ch)
 {
 m_string.insert(index, count, static_cast<char32_t>(ch));
 return *this;
 }
 
 inline String& String::insert(std::size_t index, const std::u8string& str, std::size_t pos, std::size_t count)
 {
 m_string.insert(index, String{str, pos, count}.m_string);
 return *this;
 }
 
 inline String& String::insert(std::size_t index, const char8_t* str, std::size_t count)
 {
 m_string.insert(index, String{str, count}.m_string);
 return *this;
 }
 
 inline String::iterator String::insert(String::const_iterator pos, char8_t ch)
 {
 return m_string.insert(pos, static_cast<char32_t>(ch));
 }
 
 inline String::iterator String::insert(String::const_iterator pos, std::size_t count, char8_t ch)
 {
 return m_string.insert(pos, count, static_cast<char32_t>(ch));
 }
 
 inline String::iterator String::insert(String::const_iterator pos, std::initializer_list<char8_t> chars)
 {
 const std::u32string tmpStr(utf::convertUtf8toUtf32(chars.begin(), chars.end()));
 return m_string.insert(pos, tmpStr.begin(), tmpStr.end());
 }
 
 inline String::iterator String::insert(String::const_iterator pos, std::u8string::const_iterator first, std::u8string::const_iterator last)
 {
 const std::u32string tmpStr(utf::convertUtf8toUtf32(first, last));
 return m_string.insert(pos, tmpStr.begin(), tmpStr.end());
 }
 
 inline String& String::append(std::size_t count, char8_t ch)
 {
 m_string.append(count, static_cast<char32_t>(ch));
 return *this;
 }
 
 inline String& String::append(const std::u8string& str, std::size_t pos, std::size_t count)
 {
 m_string.append(String{str, pos, count}.m_string);
 return *this;
 }
 
 inline String& String::append(const char8_t* str, std::size_t count)
 {
 m_string.append(String{str, count}.m_string);
 return *this;
 }
 
 inline String& String::append(std::initializer_list<char8_t> chars)
 {
 m_string.append(String{chars}.m_string);
 return *this;
 }
 
 inline String& String::append(std::u8string::const_iterator first, std::u8string::const_iterator last)
 {
 m_string.append(String{first, last}.m_string);
 return *this;
 }
 
 inline int String::compare(std::size_t pos1, std::size_t count1, const std::u8string& str, std::size_t pos2, std::size_t count2) const
 {
 return m_string.compare(pos1, count1, String{str, pos2, count2}.m_string);
 }
 
 inline int String::compare(std::size_t pos1, std::size_t count1, const char8_t* s, std::size_t count2) const
 {
 return m_string.compare(pos1, count1, String{s, count2}.m_string);
 }
 
 inline String& String::replace(std::size_t pos, std::size_t count, const std::u8string& str, std::size_t pos2, std::size_t count2)
 {
 m_string.replace(pos, count, String{str, pos2, count2}.m_string);
 return *this;
 }
 
 inline String& String::replace(const_iterator first, const_iterator last, std::u8string::const_iterator first2, std::u8string::const_iterator last2)
 {
 m_string.replace(first, last, String{first2, last2}.m_string);
 return *this;
 }
 
 inline String& String::replace(std::size_t pos, std::size_t count, const char8_t* cstr, std::size_t count2)
 {
 m_string.replace(pos, count, String{cstr, count2}.m_string);
 return *this;
 }
 
 inline String& String::replace(const_iterator first, const_iterator last, const char8_t* cstr, std::size_t count2)
 {
 m_string.replace(first, last, String{cstr, count2}.m_string);
 return *this;
 }
 
 inline String& String::replace(std::size_t pos, std::size_t count, std::size_t count2, char8_t ch)
 {
 m_string.replace(pos, count, String(count2, ch).m_string);
 return *this;
 }
 
 inline String& String::replace(const_iterator first, const_iterator last, std::size_t count2, char8_t ch)
 {
 m_string.replace(first, last, String(count2, ch).m_string);
 return *this;
 }
 
 inline String& String::replace(const_iterator first, const_iterator last, std::initializer_list<char8_t> chars)
 {
 m_string.replace(first, last, String{chars}.m_string);
 return *this;
 }
 
 inline void String::resize(std::size_t count, char8_t ch)
 {
 m_string.resize(count, static_cast<char32_t>(ch));
 }
 
 inline bool String::contains(char8_t c) const noexcept
 {
 return contains(static_cast<char32_t>(c));
 }
 
 inline std::size_t String::find(const char8_t* s, std::size_t pos, std::size_t count) const
 {
 return m_string.find(String{s, count}.m_string, pos);
 }
 
 inline std::size_t String::find(char8_t ch, std::size_t pos) const noexcept
 {
 return m_string.find(static_cast<char32_t>(ch), pos);
 }
 
 inline std::size_t String::find_first_of(const char8_t* s, std::size_t pos, std::size_t count) const
 {
 return m_string.find_first_of(String{s, count}.m_string, pos);
 }
 
 inline std::size_t String::find_first_of(char8_t ch, std::size_t pos) const noexcept
 {
 return m_string.find_first_of(static_cast<char32_t>(ch), pos);
 }
 
 inline std::size_t String::find_first_not_of(const char8_t* s, std::size_t pos, std::size_t count) const
 {
 return m_string.find_first_not_of(String{s, count}.m_string, pos);
 }
 
 inline std::size_t String::find_first_not_of(char8_t ch, std::size_t pos) const noexcept
 {
 return m_string.find_first_not_of(static_cast<char32_t>(ch), pos);
 }
 
 inline std::size_t String::rfind(const char8_t* s, std::size_t pos, std::size_t count) const
 {
 return m_string.rfind(String{s, count}.m_string, pos);
 }
 
 inline std::size_t String::rfind(char8_t ch, std::size_t pos) const noexcept
 {
 return m_string.rfind(static_cast<char32_t>(ch), pos);
 }
 
 inline std::size_t String::find_last_of(const char8_t* s, std::size_t pos, std::size_t count) const
 {
 return m_string.find_last_of(String{s, count}.m_string, pos);
 }
 
 inline std::size_t String::find_last_of(char8_t ch, std::size_t pos) const noexcept
 {
 return m_string.find_last_of(static_cast<char32_t>(ch), pos);
 }
 
 inline std::size_t String::find_last_not_of(const char8_t* s, std::size_t pos, std::size_t count) const
 {
 return m_string.find_last_not_of(String{s, count}.m_string, pos);
 }
 
 inline std::size_t String::find_last_not_of(char8_t ch, std::size_t pos) const noexcept
 {
 return m_string.find_last_not_of(static_cast<char8_t>(ch), pos);
 }
 
 inline bool String::starts_with(char8_t ch) const noexcept
 {
 return viewStartsWith(StringView(m_string), static_cast<char32_t>(ch));
 }
 
 inline bool String::ends_with(char8_t ch) const noexcept
 {
 return viewEndsWith(StringView(m_string), static_cast<char32_t>(ch));
 }
#endif
 
}
 
 
#endif // TGUI_STRING_HPP