103 std::u32string m_string;
105#if TGUI_COMPILED_WITH_CPP_VER >= 17
107 template <
typename StringViewType>
108 using IsStringViewType = std::enable_if_t<
109 std::is_same_v<StringViewType, std::string_view>
110#if defined(__cpp_lib_char8_t) && (__cpp_lib_char8_t >= 201811L)
111 || std::is_same_v<StringViewType, std::u8string_view>
113 || std::is_same_v<StringViewType, std::wstring_view>
114 || std::is_same_v<StringViewType, std::u16string_view>
115 || std::is_same_v<StringViewType, std::u32string_view>,
121#if TGUI_COMPILED_WITH_CPP_VER >= 17
122 static constexpr auto npos = std::u32string_view::npos;
124 static const decltype(std::u32string::npos) npos;
127 using iterator = std::u32string::iterator;
128 using const_iterator = std::u32string::const_iterator;
129 using reverse_iterator = std::u32string::reverse_iterator;
130 using const_reverse_iterator = std::u32string::const_reverse_iterator;
132 using value_type = char32_t;
133 using reference =
char32_t&;
134 using const_reference =
const char32_t&;
176 TGUI_NODISCARD
int toInt(
int defaultValue = 0)
const;
186 TGUI_NODISCARD
unsigned int toUInt(
unsigned int defaultValue = 0)
const;
196 TGUI_NODISCARD
float toFloat(
float defaultValue = 0)
const;
232#ifndef TGUI_REMOVE_DEPRECATED_CODE
242 TGUI_DEPRECATED(
"Use starts_with instead") TGUI_NODISCARD
bool startsWith(const
String& substring) const;
254#ifndef TGUI_REMOVE_DEPRECATED_CODE
264 TGUI_DEPRECATED(
"Use ends_with instead") TGUI_NODISCARD
bool endsWith(const
String& substring) const;
302 TGUI_NODISCARD std::vector<String>
split(
const String& delimiter,
bool trim =
false)
const;
311 TGUI_NODISCARD
static String join(
const std::vector<String>& segments,
const String& separator);
321 template <
typename T>
324 std::ostringstream oss;
325 oss.imbue(std::locale::classic());
339 template <
typename T>
342 std::ostringstream oss;
343 oss.imbue(std::locale::classic());
344 oss << std::fixed << std::setprecision(static_cast<int>(decimals));
354 String(
const std::string& str);
355 String(
const std::wstring& str);
356 String(
const std::u16string& str);
357 String(
const std::u32string& str);
359 String(std::u32string&& str) :
360 m_string{std::move(str)}
364 String(
char ansiChar);
365 String(
wchar_t wideChar);
366 String(
char16_t utfChar);
367 String(
char32_t utfChar);
369 String(
const char* str);
370 String(
const wchar_t* str);
371 String(
const char16_t* str);
372 String(
const char32_t* str) :
378 template <typename T, typename = typename std::enable_if_t<std::is_arithmetic<T>::value, T>>
379 explicit String(T number) :
380 String{fromNumber(number)}
384 String(std::size_t count,
char ch);
385 String(std::size_t count,
wchar_t ch);
386 String(std::size_t count,
char16_t ch);
387 String(std::size_t count,
char32_t ch);
389 String(
const std::string& str, std::size_t pos);
390 String(
const std::wstring& str, std::size_t pos);
391 String(
const std::u16string& str, std::size_t pos);
392 String(
const std::u32string& str, std::size_t pos);
394 String(
const std::string& str, std::size_t pos, std::size_t count);
395 String(
const std::wstring& str, std::size_t pos, std::size_t count);
396 String(
const std::u16string& str, std::size_t pos, std::size_t count);
397 String(
const std::u32string& str, std::size_t pos, std::size_t count);
399 String(
const char* str, std::size_t count);
400 String(
const wchar_t* str, std::size_t count);
401 String(
const char16_t* str, std::size_t count);
402 String(
const char32_t* str, std::size_t count);
404 explicit String(std::initializer_list<char> chars);
405 explicit String(std::initializer_list<wchar_t> chars);
406 explicit String(std::initializer_list<char16_t> chars);
407 explicit String(std::initializer_list<char32_t> chars);
413 explicit String(std::string::const_iterator first, std::string::const_iterator last);
414 explicit String(std::wstring::const_iterator first, std::wstring::const_iterator last);
415 explicit String(std::u16string::const_iterator first, std::u16string::const_iterator last);
416 explicit String(std::u32string::const_iterator first, std::u32string::const_iterator last);
418#if TGUI_COMPILED_WITH_CPP_VER >= 17
419 template <
typename StringViewType,
typename = IsStringViewType<StringViewType>>
420 explicit String(
const StringViewType& stringView) :
421 String(stringView.data(), stringView.size())
425 template <
typename StringViewType,
typename = IsStringViewType<StringViewType>>
426 explicit String(
const StringViewType& stringView, std::size_t pos, std::size_t count) :
427 String(stringView.data() + pos, count)
431 template <
typename CharType>
432 explicit String(StringViewImpl<CharType> stringView) :
433 String(stringView.data(), stringView.size())
437 template <
typename CharType>
438 explicit String(StringViewImpl<CharType> stringView, std::size_t pos, std::size_t count) :
439 String(stringView.data() + pos, count)
444#if TGUI_HAS_WINDOW_BACKEND_SFML
446 explicit String(
const sf::String& str)
447 : m_string{reinterpret_cast<const char32_t*>(str.toUtf32().c_str())}
451 explicit operator sf::String()
const
453 return sf::String::fromUtf32(m_string.begin(), m_string.end());
457 explicit operator std::string()
const;
458 explicit operator std::wstring()
const;
459 explicit operator std::u16string()
const;
460 explicit operator const std::u32string&()
const
465 operator StringView() const noexcept
467#if TGUI_COMPILED_WITH_CPP_VER >= 17
470 return StringView(m_string.data(), m_string.length());
474 TGUI_NODISCARD std::string toStdString()
const;
475 TGUI_NODISCARD std::wstring toWideString()
const;
476 TGUI_NODISCARD std::u16string toUtf16()
const;
477 TGUI_NODISCARD
const std::u32string& toUtf32()
const
482 String& assign(std::size_t count,
char ch);
483 String& assign(std::size_t count,
wchar_t ch);
484 String& assign(std::size_t count,
char16_t ch);
485 String& assign(std::size_t count,
char32_t ch);
487 String& assign(StringView sv);
488 String& assign(
const char32_t* str);
489 String& assign(
const std::u32string& str);
490 String& assign(
const String& str);
492 String& assign(StringView sv, std::size_t pos, std::size_t count = npos);
493 String& assign(
const std::string& str, std::size_t pos, std::size_t count = npos);
494 String& assign(
const std::wstring& str, std::size_t pos, std::size_t count = npos);
495 String& assign(
const std::u16string& str, std::size_t pos, std::size_t count = npos);
496 String& assign(
const std::u32string& str, std::size_t pos, std::size_t count = npos);
497 String& assign(
const String& str, std::size_t pos, std::size_t count = npos);
499 String& assign(std::u32string&& str);
500 String& assign(String&& str);
502 String& assign(
const char* str, std::size_t count);
503 String& assign(
const wchar_t* str, std::size_t count);
504 String& assign(
const char16_t* str, std::size_t count);
505 String& assign(
const char32_t* str, std::size_t count);
507 String& assign(std::initializer_list<char> chars);
508 String& assign(std::initializer_list<wchar_t> chars);
509 String& assign(std::initializer_list<char16_t> chars);
510 String& assign(std::initializer_list<char32_t> chars);
512 String& assign(std::string::const_iterator first, std::string::const_iterator last);
513 String& assign(std::wstring::const_iterator first, std::wstring::const_iterator last);
514 String& assign(std::u16string::const_iterator first, std::u16string::const_iterator last);
515 String& assign(std::u32string::const_iterator first, std::u32string::const_iterator last);
516 String& assign(StringView::const_iterator first, StringView::const_iterator last);
518 TGUI_NODISCARD reference at(std::size_t pos);
519 TGUI_NODISCARD const_reference at(std::size_t pos)
const;
521 TGUI_NODISCARD const_reference operator [](std::size_t index)
const;
522 TGUI_NODISCARD reference operator [](std::size_t index);
524 TGUI_NODISCARD reference front();
525 TGUI_NODISCARD const_reference front()
const;
527 TGUI_NODISCARD reference back();
528 TGUI_NODISCARD const_reference back()
const;
530 TGUI_NODISCARD
const char32_t* data() const noexcept
532 return m_string.data();
535 TGUI_NODISCARD
char32_t* data() noexcept
537#if __cplusplus >= 201703L
538 return m_string.data();
544 TGUI_NODISCARD
const char32_t* c_str() const noexcept
546 return m_string.c_str();
549 TGUI_NODISCARD iterator begin() noexcept;
550 TGUI_NODISCARD const_iterator begin() const noexcept;
551 TGUI_NODISCARD const_iterator cbegin() const noexcept;
553 TGUI_NODISCARD iterator end() noexcept;
554 TGUI_NODISCARD const_iterator end() const noexcept;
555 TGUI_NODISCARD const_iterator cend() const noexcept;
557 TGUI_NODISCARD reverse_iterator rbegin() noexcept;
558 TGUI_NODISCARD const_reverse_iterator rbegin() const noexcept;
559 TGUI_NODISCARD const_reverse_iterator crbegin() const noexcept;
561 TGUI_NODISCARD reverse_iterator rend() noexcept;
562 TGUI_NODISCARD const_reverse_iterator rend() const noexcept;
563 TGUI_NODISCARD const_reverse_iterator crend() const noexcept;
565 TGUI_NODISCARD
bool empty() const noexcept
567 return m_string.empty();
570 TGUI_NODISCARD std::size_t size() const noexcept
572 return m_string.size();
575 TGUI_NODISCARD std::size_t length() const noexcept
577 return m_string.length();
580 TGUI_NODISCARD std::size_t max_size() const noexcept;
582 void reserve(std::
size_t newCap);
583 TGUI_NODISCARD std::
size_t capacity() const noexcept;
584 void shrink_to_fit();
586 void clear() noexcept;
588 String& insert(std::
size_t index, std::
size_t count,
char ch);
589 String& insert(std::
size_t index, std::
size_t count,
wchar_t ch);
590 String& insert(std::
size_t index, std::
size_t count,
char16_t ch);
591 String& insert(std::
size_t index, std::
size_t count,
char32_t ch);
593 String& insert(std::
size_t index, StringView sv);
594 String& insert(std::
size_t index, const
char32_t* str);
595 String& insert(std::
size_t index, const std::u32string& str);
596 String& insert(std::
size_t index, const String& str);
598 String& insert(std::
size_t index, StringView sv, std::
size_t pos, std::
size_t count = npos);
599 String& insert(std::
size_t index, const std::
string& str, std::
size_t pos, std::
size_t count = npos);
600 String& insert(std::
size_t index, const std::wstring& str, std::
size_t pos, std::
size_t count = npos);
601 String& insert(std::
size_t index, const std::u16string& str, std::
size_t pos, std::
size_t count = npos);
602 String& insert(std::
size_t index, const std::u32string& str, std::
size_t pos, std::
size_t count = npos);
603 String& insert(std::
size_t index, const String& str, std::
size_t pos, std::
size_t count = npos);
605 String& insert(std::
size_t index, const
char* str, std::
size_t count);
606 String& insert(std::
size_t index, const
wchar_t* str, std::
size_t count);
607 String& insert(std::
size_t index, const
char16_t* str, std::
size_t count);
608 String& insert(std::
size_t index, const
char32_t* str, std::
size_t count);
610 iterator insert(const_iterator pos,
char ch);
611 iterator insert(const_iterator pos,
wchar_t ch);
612 iterator insert(const_iterator pos,
char16_t ch);
613 iterator insert(const_iterator pos,
char32_t ch);
615 iterator insert(const_iterator pos, std::
size_t count,
char ch);
616 iterator insert(const_iterator pos, std::
size_t count,
wchar_t ch);
617 iterator insert(const_iterator pos, std::
size_t count,
char16_t ch);
618 iterator insert(const_iterator pos, std::
size_t count,
char32_t ch);
620 iterator insert(const_iterator pos, std::initializer_list<
char> chars);
621 iterator insert(const_iterator pos, std::initializer_list<
wchar_t> chars);
622 iterator insert(const_iterator pos, std::initializer_list<
char16_t> chars);
623 iterator insert(const_iterator pos, std::initializer_list<
char32_t> chars);
625 iterator insert(const_iterator pos, std::
string::const_iterator first, std::
string::const_iterator last);
626 iterator insert(const_iterator pos, std::wstring::const_iterator first, std::wstring::const_iterator last);
627 iterator insert(const_iterator pos, std::u16string::const_iterator first, std::u16string::const_iterator last);
628 iterator insert(const_iterator pos, std::u32string::const_iterator first, std::u32string::const_iterator last);
629 iterator insert(const_iterator pos, StringView::const_iterator first, StringView::const_iterator last);
631 String& erase(std::
size_t index = 0, std::
size_t count = npos);
633 iterator erase(const_iterator position);
634 iterator erase(const_iterator first, const_iterator last);
636 void push_back(
char ch);
637 void push_back(
wchar_t ch);
638 void push_back(
char16_t ch);
639 void push_back(
char32_t ch);
643 String& append(std::
size_t count,
char ch);
644 String& append(std::
size_t count,
wchar_t ch);
645 String& append(std::
size_t count,
char16_t ch);
646 String& append(std::
size_t count,
char32_t ch);
648 String& append(StringView sv);
649 String& append(const
char32_t* str);
650 String& append(const std::u32string& str);
651 String& append(const String& str);
653 String& append(StringView sv, std::
size_t pos, std::
size_t count = npos);
654 String& append(const std::
string& str, std::
size_t pos, std::
size_t count = npos);
655 String& append(const std::wstring& str, std::
size_t pos, std::
size_t count = npos);
656 String& append(const std::u16string& str, std::
size_t pos, std::
size_t count = npos);
657 String& append(const std::u32string& str, std::
size_t pos, std::
size_t count = npos);
658 String& append(const String& str, std::
size_t pos, std::
size_t count = npos);
660 String& append(const
char* str, std::
size_t count);
661 String& append(const
wchar_t* str, std::
size_t count);
662 String& append(const
char16_t* str, std::
size_t count);
663 String& append(const
char32_t* str, std::
size_t count);
665 String& append(std::
string::const_iterator first, std::
string::const_iterator last);
666 String& append(std::wstring::const_iterator first, std::wstring::const_iterator last);
667 String& append(std::u16string::const_iterator first, std::u16string::const_iterator last);
668 String& append(std::u32string::const_iterator first, std::u32string::const_iterator last);
669 String& append(StringView::const_iterator first, StringView::const_iterator last);
671 String& append(std::initializer_list<
char> chars);
672 String& append(std::initializer_list<
wchar_t> chars);
673 String& append(std::initializer_list<
char16_t> chars);
674 String& append(std::initializer_list<
char32_t> chars);
676 String& operator+=(const String& str);
678 TGUI_NODISCARD
int compare(StringView sv) const noexcept;
679 TGUI_NODISCARD
int compare(const
char32_t* s) const;
680 TGUI_NODISCARD
int compare(const std::u32string& str) const noexcept;
681 TGUI_NODISCARD
int compare(const String& str) const noexcept;
683 TGUI_NODISCARD
int compare(std::
size_t pos1, std::
size_t count1, StringView sv) const;
684 TGUI_NODISCARD
int compare(std::
size_t pos1, std::
size_t count1, const
char32_t* s) const;
685 TGUI_NODISCARD
int compare(std::
size_t pos1, std::
size_t count1, const std::u32string& str) const;
686 TGUI_NODISCARD
int compare(std::
size_t pos1, std::
size_t count1, const String& str) const;
688 TGUI_NODISCARD
int compare(std::
size_t pos1, std::
size_t count1, StringView sv, std::
size_t pos2, std::
size_t count2 = npos) const;
689 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;
690 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;
691 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;
692 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;
693 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;
695 TGUI_NODISCARD
int compare(std::
size_t pos1, std::
size_t count1, const
char* s, std::
size_t count2) const;
696 TGUI_NODISCARD
int compare(std::
size_t pos1, std::
size_t count1, const
wchar_t* s, std::
size_t count2) const;
697 TGUI_NODISCARD
int compare(std::
size_t pos1, std::
size_t count1, const
char16_t* s, std::
size_t count2) const;
698 TGUI_NODISCARD
int compare(std::
size_t pos1, std::
size_t count1, const
char32_t* s, std::
size_t count2) const;
700 String& replace(std::
size_t pos, std::
size_t count, StringView sv);
701 String& replace(std::
size_t pos, std::
size_t count, const
char32_t* cstr);
702 String& replace(std::
size_t pos, std::
size_t count, const std::u32string& str);
703 String& replace(std::
size_t pos, std::
size_t count, const String& str);
705 String& replace(const_iterator first, const_iterator last, StringView sv);
706 String& replace(const_iterator first, const_iterator last, const
char32_t* cstr);
707 String& replace(const_iterator first, const_iterator last, const std::u32string& str);
708 String& replace(const_iterator first, const_iterator last, const String& str);
710 String& replace(std::
size_t pos, std::
size_t count, StringView sv, std::
size_t pos2, std::
size_t count2 = npos);
711 String& replace(std::
size_t pos, std::
size_t count, const std::
string& str, std::
size_t pos2, std::
size_t count2 = npos);
712 String& replace(std::
size_t pos, std::
size_t count, const std::wstring& str, std::
size_t pos2, std::
size_t count2 = npos);
713 String& replace(std::
size_t pos, std::
size_t count, const std::u16string& str, std::
size_t pos2, std::
size_t count2 = npos);
714 String& replace(std::
size_t pos, std::
size_t count, const std::u32string& str, std::
size_t pos2, std::
size_t count2 = npos);
715 String& replace(std::
size_t pos, std::
size_t count, const String& str, std::
size_t pos2, std::
size_t count2 = npos);
717 String& replace(const_iterator first, const_iterator last, std::
string::const_iterator first2, std::
string::const_iterator last2);
718 String& replace(const_iterator first, const_iterator last, std::wstring::const_iterator first2, std::wstring::const_iterator last2);
719 String& replace(const_iterator first, const_iterator last, std::u16string::const_iterator first2, std::u16string::const_iterator last2);
720 String& replace(const_iterator first, const_iterator last, std::u32string::const_iterator first2, std::u32string::const_iterator last2);
721 String& replace(const_iterator first, const_iterator last, StringView::const_iterator first2, StringView::const_iterator last2);
723 String& replace(std::
size_t pos, std::
size_t count, const
char* cstr, std::
size_t count2);
724 String& replace(std::
size_t pos, std::
size_t count, const
wchar_t* cstr, std::
size_t count2);
725 String& replace(std::
size_t pos, std::
size_t count, const
char16_t* cstr, std::
size_t count2);
726 String& replace(std::
size_t pos, std::
size_t count, const
char32_t* cstr, std::
size_t count2);
728 String& replace(const_iterator first, const_iterator last, const
char* cstr, std::
size_t count2);
729 String& replace(const_iterator first, const_iterator last, const
wchar_t* cstr, std::
size_t count2);
730 String& replace(const_iterator first, const_iterator last, const
char16_t* cstr, std::
size_t count2);
731 String& replace(const_iterator first, const_iterator last, const
char32_t* cstr, std::
size_t count2);
733 String& replace(std::
size_t pos, std::
size_t count, std::
size_t count2,
char ch);
734 String& replace(std::
size_t pos, std::
size_t count, std::
size_t count2,
wchar_t ch);
735 String& replace(std::
size_t pos, std::
size_t count, std::
size_t count2,
char16_t ch);
736 String& replace(std::
size_t pos, std::
size_t count, std::
size_t count2,
char32_t ch);
738 String& replace(const_iterator first, const_iterator last, std::
size_t count2,
char ch);
739 String& replace(const_iterator first, const_iterator last, std::
size_t count2,
wchar_t ch);
740 String& replace(const_iterator first, const_iterator last, std::
size_t count2,
char16_t ch);
741 String& replace(const_iterator first, const_iterator last, std::
size_t count2,
char32_t ch);
743 String& replace(const_iterator first, const_iterator last, std::initializer_list<
char> chars);
744 String& replace(const_iterator first, const_iterator last, std::initializer_list<
wchar_t> chars);
745 String& replace(const_iterator first, const_iterator last, std::initializer_list<
char16_t> chars);
746 String& replace(const_iterator first, const_iterator last, std::initializer_list<
char32_t> chars);
748 TGUI_NODISCARD String substr(std::
size_t pos = 0, std::
size_t count = npos) const;
750 std::
size_t copy(
char32_t* dest, std::
size_t count, std::
size_t pos = 0) const;
752 void resize(std::
size_t count);
753 void resize(std::
size_t count,
char ch);
754 void resize(std::
size_t count,
wchar_t ch);
755 void resize(std::
size_t count,
char16_t ch);
756 void resize(std::
size_t count,
char32_t ch);
758 void swap(String& other);
760 TGUI_NODISCARD
bool contains(
char c) const noexcept;
761 TGUI_NODISCARD
bool contains(
wchar_t c) const noexcept;
762 TGUI_NODISCARD
bool contains(
char16_t c) const noexcept;
763 TGUI_NODISCARD
bool contains(
char32_t c) const noexcept;
765 TGUI_NODISCARD
bool contains(StringView sv) const noexcept;
766 TGUI_NODISCARD
bool contains(const
char32_t* s) const;
767 TGUI_NODISCARD
bool contains(const std::u32string& s) const;
768 TGUI_NODISCARD
bool contains(const String& s) const;
770 TGUI_NODISCARD std::
size_t find(StringView sv, std::
size_t pos = 0) const noexcept;
771 TGUI_NODISCARD std::
size_t find(const
char32_t* s, std::
size_t pos = 0) const;
772 TGUI_NODISCARD std::
size_t find(const std::u32string& str, std::
size_t pos = 0) const noexcept;
773 TGUI_NODISCARD std::
size_t find(const String& str, std::
size_t pos = 0) const noexcept;
775 TGUI_NODISCARD std::
size_t find(const
char* s, std::
size_t pos, std::
size_t count) const;
776 TGUI_NODISCARD std::
size_t find(const
wchar_t* s, std::
size_t pos, std::
size_t count) const;
777 TGUI_NODISCARD std::
size_t find(const
char16_t* s, std::
size_t pos, std::
size_t count) const;
778 TGUI_NODISCARD std::
size_t find(const
char32_t* s, std::
size_t pos, std::
size_t count) const;
780 TGUI_NODISCARD std::
size_t find(
char ch, std::
size_t pos = 0) const noexcept;
781 TGUI_NODISCARD std::
size_t find(
wchar_t ch, std::
size_t pos = 0) const noexcept;
782 TGUI_NODISCARD std::
size_t find(
char16_t ch, std::
size_t pos = 0) const noexcept;
783 TGUI_NODISCARD std::
size_t find(
char32_t ch, std::
size_t pos = 0) const noexcept;
785 TGUI_NODISCARD std::
size_t find_first_of(StringView sv, std::
size_t pos = 0) const noexcept;
786 TGUI_NODISCARD std::
size_t find_first_of(const
char32_t* s, std::
size_t pos = 0) const;
787 TGUI_NODISCARD std::
size_t find_first_of(const std::u32string& str, std::
size_t pos = 0) const noexcept;
788 TGUI_NODISCARD std::
size_t find_first_of(const String& str, std::
size_t pos = 0) const noexcept;
790 TGUI_NODISCARD std::
size_t find_first_of(const
char* s, std::
size_t pos, std::
size_t count) const;
791 TGUI_NODISCARD std::
size_t find_first_of(const
wchar_t* s, std::
size_t pos, std::
size_t count) const;
792 TGUI_NODISCARD std::
size_t find_first_of(const
char16_t* s, std::
size_t pos, std::
size_t count) const;
793 TGUI_NODISCARD std::
size_t find_first_of(const
char32_t* s, std::
size_t pos, std::
size_t count) const;
795 TGUI_NODISCARD std::
size_t find_first_of(
char ch, std::
size_t pos = 0) const noexcept;
796 TGUI_NODISCARD std::
size_t find_first_of(
wchar_t ch, std::
size_t pos = 0) const noexcept;
797 TGUI_NODISCARD std::
size_t find_first_of(
char16_t ch, std::
size_t pos = 0) const noexcept;
798 TGUI_NODISCARD std::
size_t find_first_of(
char32_t ch, std::
size_t pos = 0) const noexcept;
800 TGUI_NODISCARD std::
size_t find_first_not_of(StringView sv, std::
size_t pos = 0) const noexcept;
801 TGUI_NODISCARD std::
size_t find_first_not_of(const
char32_t* s, std::
size_t pos = 0) const;
802 TGUI_NODISCARD std::
size_t find_first_not_of(const std::u32string& str, std::
size_t pos = 0) const noexcept;
803 TGUI_NODISCARD std::
size_t find_first_not_of(const String& str, std::
size_t pos = 0) const noexcept;
805 TGUI_NODISCARD std::
size_t find_first_not_of(const
char* s, std::
size_t pos, std::
size_t count) const;
806 TGUI_NODISCARD std::
size_t find_first_not_of(const
wchar_t* s, std::
size_t pos, std::
size_t count) const;
807 TGUI_NODISCARD std::
size_t find_first_not_of(const
char16_t* s, std::
size_t pos, std::
size_t count) const;
808 TGUI_NODISCARD std::
size_t find_first_not_of(const
char32_t* s, std::
size_t pos, std::
size_t count) const;
810 TGUI_NODISCARD std::
size_t find_first_not_of(
char ch, std::
size_t pos = 0) const noexcept;
811 TGUI_NODISCARD std::
size_t find_first_not_of(
wchar_t ch, std::
size_t pos = 0) const noexcept;
812 TGUI_NODISCARD std::
size_t find_first_not_of(
char16_t ch, std::
size_t pos = 0) const noexcept;
813 TGUI_NODISCARD std::
size_t find_first_not_of(
char32_t ch, std::
size_t pos = 0) const noexcept;
815 TGUI_NODISCARD std::
size_t rfind(StringView sv, std::
size_t pos = npos) const noexcept;
816 TGUI_NODISCARD std::
size_t rfind(const
char32_t* s, std::
size_t pos = npos) const;
817 TGUI_NODISCARD std::
size_t rfind(const std::u32string& str, std::
size_t pos = npos) const noexcept;
818 TGUI_NODISCARD std::
size_t rfind(const String& str, std::
size_t pos = npos) const noexcept;
820 TGUI_NODISCARD std::
size_t rfind(const
char* s, std::
size_t pos, std::
size_t count) const;
821 TGUI_NODISCARD std::
size_t rfind(const
wchar_t* s, std::
size_t pos, std::
size_t count) const;
822 TGUI_NODISCARD std::
size_t rfind(const
char16_t* s, std::
size_t pos, std::
size_t count) const;
823 TGUI_NODISCARD std::
size_t rfind(const
char32_t* s, std::
size_t pos, std::
size_t count) const;
825 TGUI_NODISCARD std::
size_t rfind(
char ch, std::
size_t pos = npos) const noexcept;
826 TGUI_NODISCARD std::
size_t rfind(
wchar_t ch, std::
size_t pos = npos) const noexcept;
827 TGUI_NODISCARD std::
size_t rfind(
char16_t ch, std::
size_t pos = npos) const noexcept;
828 TGUI_NODISCARD std::
size_t rfind(
char32_t ch, std::
size_t pos = npos) const noexcept;
830 TGUI_NODISCARD std::
size_t find_last_of(StringView sv, std::
size_t pos = npos) const noexcept;
831 TGUI_NODISCARD std::
size_t find_last_of(const
char32_t* s, std::
size_t pos = npos) const;
832 TGUI_NODISCARD std::
size_t find_last_of(const std::u32string& str, std::
size_t pos = npos) const noexcept;
833 TGUI_NODISCARD std::
size_t find_last_of(const String& str, std::
size_t pos = npos) const noexcept;
835 TGUI_NODISCARD std::
size_t find_last_of(const
char* s, std::
size_t pos, std::
size_t count) const;
836 TGUI_NODISCARD std::
size_t find_last_of(const
wchar_t* s, std::
size_t pos, std::
size_t count) const;
837 TGUI_NODISCARD std::
size_t find_last_of(const
char16_t* s, std::
size_t pos, std::
size_t count) const;
838 TGUI_NODISCARD std::
size_t find_last_of(const
char32_t* s, std::
size_t pos, std::
size_t count) const;
840 TGUI_NODISCARD std::
size_t find_last_of(
char ch, std::
size_t pos = npos) const noexcept;
841 TGUI_NODISCARD std::
size_t find_last_of(
wchar_t ch, std::
size_t pos = npos) const noexcept;
842 TGUI_NODISCARD std::
size_t find_last_of(
char16_t ch, std::
size_t pos = npos) const noexcept;
843 TGUI_NODISCARD std::
size_t find_last_of(
char32_t ch, std::
size_t pos = npos) const noexcept;
845 TGUI_NODISCARD std::
size_t find_last_not_of(StringView sv, std::
size_t pos = npos) const noexcept;
846 TGUI_NODISCARD std::
size_t find_last_not_of(const
char32_t* s, std::
size_t pos = npos) const;
847 TGUI_NODISCARD std::
size_t find_last_not_of(const std::u32string& str, std::
size_t pos = npos) const noexcept;
848 TGUI_NODISCARD std::
size_t find_last_not_of(const String& str, std::
size_t pos = npos) const noexcept;
850 TGUI_NODISCARD std::
size_t find_last_not_of(const
char* s, std::
size_t pos, std::
size_t count) const;
851 TGUI_NODISCARD std::
size_t find_last_not_of(const
wchar_t* s, std::
size_t pos, std::
size_t count) const;
852 TGUI_NODISCARD std::
size_t find_last_not_of(const
char16_t* s, std::
size_t pos, std::
size_t count) const;
853 TGUI_NODISCARD std::
size_t find_last_not_of(const
char32_t* s, std::
size_t pos, std::
size_t count) const;
855 TGUI_NODISCARD std::
size_t find_last_not_of(
char ch, std::
size_t pos = npos) const noexcept;
856 TGUI_NODISCARD std::
size_t find_last_not_of(
wchar_t ch, std::
size_t pos = npos) const noexcept;
857 TGUI_NODISCARD std::
size_t find_last_not_of(
char16_t ch, std::
size_t pos = npos) const noexcept;
858 TGUI_NODISCARD std::
size_t find_last_not_of(
char32_t ch, std::
size_t pos = npos) const noexcept;
860 TGUI_NODISCARD inline
bool starts_with(StringView sv) const noexcept;
861 TGUI_NODISCARD inline
bool starts_with(const
char32_t* s) const;
862 TGUI_NODISCARD inline
bool starts_with(const std::u32string& s) const;
863 TGUI_NODISCARD inline
bool starts_with(const String& s) const;
865 TGUI_NODISCARD inline
bool starts_with(
char ch) const noexcept;
866 TGUI_NODISCARD inline
bool starts_with(
wchar_t ch) const noexcept;
867 TGUI_NODISCARD inline
bool starts_with(
char16_t ch) const noexcept;
868 TGUI_NODISCARD inline
bool starts_with(
char32_t ch) const noexcept;
870 TGUI_NODISCARD inline
bool ends_with(StringView sv) const noexcept;
871 TGUI_NODISCARD inline
bool ends_with(const
char32_t* s) const;
872 TGUI_NODISCARD inline
bool ends_with(const std::u32string& s) const;
873 TGUI_NODISCARD inline
bool ends_with(const String& s) const;
875 TGUI_NODISCARD inline
bool ends_with(
char ch) const noexcept;
876 TGUI_NODISCARD inline
bool ends_with(
wchar_t ch) const noexcept;
877 TGUI_NODISCARD inline
bool ends_with(
char16_t ch) const noexcept;
878 TGUI_NODISCARD inline
bool ends_with(
char32_t ch) const noexcept;
880 TGUI_NODISCARD std::
size_t count(const
char ch, const std::
size_t pos = 0) const noexcept;
881 TGUI_NODISCARD std::
size_t count(const
wchar_t ch, const std::
size_t pos = 0) const noexcept;
882 TGUI_NODISCARD std::
size_t count(const
char16_t ch, const std::
size_t pos = 0) const noexcept;
883 TGUI_NODISCARD std::
size_t count(const
char32_t ch, const std::
size_t pos = 0) const noexcept;
885 inline friend
bool operator==(const String& left, StringView right);
886 inline friend
bool operator==(const String& left, const
char32_t* right);
887 inline friend
bool operator==(const String& left, const std::u32string& right);
888 inline friend
bool operator==(const String& left, const String& right);
890 inline friend
bool operator!=(const String& left, StringView right);
891 inline friend
bool operator!=(const String& left, const
char32_t* right);
892 inline friend
bool operator!=(const String& left, const std::u32string& right);
893 inline friend
bool operator!=(const String& left, const String& right);
895 inline friend
bool operator<(const String& left, StringView right);
896 inline friend
bool operator<(const String& left, const
char32_t* right);
897 inline friend
bool operator<(const String& left, const std::u32string& right);
898 inline friend
bool operator<(const String& left, const String& right);
900 inline friend
bool operator<=(const String& left, StringView right);
901 inline friend
bool operator<=(const String& left, const
char32_t* right);
902 inline friend
bool operator<=(const String& left, const std::u32string& right);
903 inline friend
bool operator<=(const String& left, const String& right);
905 inline friend
bool operator>(const String& left, StringView right);
906 inline friend
bool operator>(const String& left, const
char32_t* right);
907 inline friend
bool operator>(const String& left, const std::u32string& right);
908 inline friend
bool operator>(const String& left, const String& right);
910 inline friend
bool operator>=(const String& left, StringView right);
911 inline friend
bool operator>=(const String& left, const
char32_t* right);
912 inline friend
bool operator>=(const String& left, const std::u32string& right);
913 inline friend
bool operator>=(const String& left, const String& right);
915 inline friend String operator+(const String& left, const String& right);
916 inline friend String operator+(const String& left, String&& right);
917 inline friend String operator+(String&& left, const String& right);
918 inline friend String operator+(String&& left, String&& right);
920#if defined(__cpp_lib_char8_t) && (__cpp_lib_char8_t >= 201811L)
921 inline String(
const std::u8string& str);
922 inline String(
char8_t utfChar);
923 inline String(
const char8_t* str);
924 inline String(std::size_t count,
char8_t ch);
925 inline String(
const std::u8string& str, std::size_t pos);
926 inline String(
const std::u8string& str, std::size_t pos, std::size_t count);
927 inline String(
const char8_t* str, std::size_t count);
928 inline explicit String(std::initializer_list<char8_t> chars);
929 inline explicit String(std::u8string::const_iterator first, std::u8string::const_iterator last);
931 inline explicit operator std::u8string()
const;
933 TGUI_NODISCARD
inline std::u8string toUtf8()
const;
935 inline String& assign(std::size_t count,
char8_t ch);
936 inline String& assign(
const std::u8string& str, std::size_t pos, std::size_t count = npos);
937 inline String& assign(
const char8_t* str, std::size_t count);
938 inline String& assign(std::initializer_list<char8_t> chars);
939 inline String& assign(std::u8string::const_iterator first, std::u8string::const_iterator last);
941 inline String& insert(std::size_t index, std::size_t count,
char8_t ch);
942 inline String& insert(std::size_t index,
const std::u8string& str, std::size_t pos, std::size_t count = npos);
943 inline String& insert(std::size_t index,
const char8_t* str, std::size_t count);
944 inline iterator insert(const_iterator pos,
char8_t ch);
945 inline iterator insert(const_iterator pos, std::size_t count,
char8_t ch);
946 inline iterator insert(const_iterator pos, std::initializer_list<char8_t> chars);
947 inline iterator insert(const_iterator pos, std::u8string::const_iterator first, std::u8string::const_iterator last);
949 inline String& append(std::size_t count,
char8_t ch);
950 inline String& append(
const std::u8string& str, std::size_t pos, std::size_t count = npos);
951 inline String& append(
const char8_t* str, std::size_t count);
952 inline String& append(std::initializer_list<char8_t> chars);
953 inline String& append(std::u8string::const_iterator first, std::u8string::const_iterator last);
955 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;
956 TGUI_NODISCARD
inline int compare(std::size_t pos1, std::size_t count1,
const char8_t* s, std::size_t count2)
const;
958 inline String& replace(std::size_t pos, std::size_t count,
const std::u8string& str, std::size_t pos2, std::size_t count2 = npos);
959 inline String& replace(const_iterator first, const_iterator last, std::u8string::const_iterator first2, std::u8string::const_iterator last2);
960 inline String& replace(std::size_t pos, std::size_t count,
const char8_t* cstr, std::size_t count2);
961 inline String& replace(const_iterator first, const_iterator last,
const char8_t* cstr, std::size_t count2);
962 inline String& replace(std::size_t pos, std::size_t count, std::size_t count2,
char8_t ch);
963 inline String& replace(const_iterator first, const_iterator last, std::size_t count2,
char8_t ch);
964 inline String& replace(const_iterator first, const_iterator last, std::initializer_list<char8_t> chars);
966 inline void resize(std::size_t count,
char8_t ch);
968 TGUI_NODISCARD
inline bool contains(
char8_t c)
const noexcept;
970 TGUI_NODISCARD
inline std::size_t find(
const char8_t* s, std::size_t pos, std::size_t count)
const;
971 TGUI_NODISCARD
inline std::size_t find(
char8_t ch, std::size_t pos = 0) const noexcept;
973 TGUI_NODISCARD inline std::
size_t find_first_of(const
char8_t* s, std::
size_t pos, std::
size_t count) const;
974 TGUI_NODISCARD inline std::
size_t find_first_of(
char8_t ch, std::
size_t pos = 0) const noexcept;
976 TGUI_NODISCARD inline std::
size_t find_first_not_of(const
char8_t* s, std::
size_t pos, std::
size_t count) const;
977 TGUI_NODISCARD inline std::
size_t find_first_not_of(
char8_t ch, std::
size_t pos = 0) const noexcept;
979 TGUI_NODISCARD inline std::
size_t rfind(const
char8_t* s, std::
size_t pos, std::
size_t count) const;
980 TGUI_NODISCARD inline std::
size_t rfind(
char8_t ch, std::
size_t pos = npos) const noexcept;
982 TGUI_NODISCARD inline std::
size_t find_last_of(const
char8_t* s, std::
size_t pos, std::
size_t count) const;
983 TGUI_NODISCARD inline std::
size_t find_last_of(
char8_t ch, std::
size_t pos = npos) const noexcept;
985 TGUI_NODISCARD inline std::
size_t find_last_not_of(const
char8_t* s, std::
size_t pos, std::
size_t count) const;
986 TGUI_NODISCARD inline std::
size_t find_last_not_of(
char8_t ch, std::
size_t pos = npos) const noexcept;
988 TGUI_NODISCARD inline
bool starts_with(
char8_t ch) const noexcept;
989 TGUI_NODISCARD inline
bool ends_with(
char8_t ch) const noexcept;