25#ifndef TGUI_STRING_VIEW_HPP
26#define TGUI_STRING_VIEW_HPP
28#if !TGUI_EXPERIMENTAL_USE_STD_MODULE
33 #if TGUI_COMPILED_WITH_CPP_VER >= 17
34 #include <string_view>
40#if TGUI_COMPILED_WITH_CPP_VER >= 17
43 inline namespace literals
45 inline namespace string_view_literals
49 using namespace std::literals::string_view_literals;
55TGUI_MODULE_EXPORT
namespace tgui
57#if TGUI_COMPILED_WITH_CPP_VER >= 17
58 using StringView = std::u32string_view;
59 using CharStringView = std::string_view;
61 template <
typename Type>
67 template<
typename Type>
68 using TypeIdentity_t =
typename TypeIdentity<Type>::type;
70 template <
typename CharType>
74 using const_iterator =
const CharType*;
76 constexpr StringViewImpl() =
default;
77 constexpr StringViewImpl(
const StringViewImpl& other) =
default;
79 constexpr StringViewImpl(
const CharType* str, std::size_t strLength) :
85 constexpr StringViewImpl(
const CharType* str) :
87 m_length(std::char_traits<CharType>::length(str))
91 constexpr StringViewImpl(
const std::basic_string<CharType>& str) :
93 m_length(str.length())
97 TGUI_NODISCARD
constexpr const_iterator begin() const noexcept
101 TGUI_NODISCARD
constexpr const_iterator cbegin() const noexcept
106 TGUI_NODISCARD
constexpr const_iterator end() const noexcept
108 return m_string +
static_cast<std::ptrdiff_t
>(m_length);
110 TGUI_NODISCARD
constexpr const_iterator cend() const noexcept
112 return m_string +
static_cast<std::ptrdiff_t
>(m_length);
115 TGUI_NODISCARD
constexpr const CharType& operator[](std::size_t index)
const
117 return m_string[index];
120 TGUI_NODISCARD
constexpr const CharType& front()
const
125 TGUI_NODISCARD
constexpr const CharType& back()
const
127 return m_string[m_length-1];
130 TGUI_NODISCARD
constexpr const CharType* data() const noexcept
135 TGUI_NODISCARD
constexpr std::size_t size() const noexcept
139 TGUI_NODISCARD
constexpr std::size_t length() const noexcept
144 TGUI_NODISCARD
constexpr bool empty() const noexcept
146 return (m_length == 0);
149 TGUI_NODISCARD
constexpr StringViewImpl substr(std::size_t pos = 0, std::size_t count = std::u32string::npos)
const
151 if (count != std::u32string::npos)
152 return StringViewImpl(&m_string[pos], count);
154 return StringViewImpl(&m_string[pos], m_length - pos);
157 TGUI_NODISCARD
constexpr int compare(StringViewImpl strView)
const noexcept
159 const std::size_t rlen = std::min(length(), strView.length());
160 const int ret = std::char_traits<CharType>::compare(data(), strView.data(), rlen);
164 if (length() < strView.length())
166 else if (length() > strView.length())
172 TGUI_NODISCARD
constexpr std::size_t find(StringViewImpl strView, std::size_t pos = 0) const noexcept
174 if (empty() || (strView.length() > m_length))
175 return std::u32string::npos;
180 for (std::size_t i = pos; i <= m_length - strView.length(); ++i)
182 if (m_string[i] != strView[0])
186 for (std::size_t j = 1; j < strView.length(); ++j)
188 if (m_string[i+j] != strView[j])
199 return std::u32string::npos;
202 TGUI_NODISCARD
constexpr std::size_t find(CharType ch, std::size_t pos = 0) const noexcept
204 return find(StringViewImpl(&ch, 1), pos);
206 TGUI_NODISCARD
constexpr std::size_t find(
const CharType* str, std::size_t pos, std::size_t count)
const
208 return find(StringViewImpl(str, count), pos);
210 TGUI_NODISCARD
constexpr std::size_t find(
const CharType* str, std::size_t pos = 0)
const
212 return find(StringViewImpl(str), pos);
216 const CharType* m_string =
nullptr;
217 std::size_t m_length = 0;
220 template <
typename CharType>
221 TGUI_NODISCARD
constexpr bool operator==(StringViewImpl<CharType> lhs, TypeIdentity_t<StringViewImpl<CharType>> rhs)
noexcept
223 return lhs.compare(rhs) == 0;
226 template <
typename CharType>
227 TGUI_NODISCARD
constexpr bool operator!=(StringViewImpl<CharType> lhs, TypeIdentity_t<StringViewImpl<CharType>> rhs)
noexcept
229 return lhs.compare(rhs) != 0;
232 template <
typename CharType>
233 TGUI_NODISCARD
constexpr bool operator<(StringViewImpl<CharType> lhs, TypeIdentity_t<StringViewImpl<CharType>> rhs)
noexcept
235 return lhs.compare(rhs) < 0;
238 template <
typename CharType>
239 TGUI_NODISCARD
constexpr bool operator<=(StringViewImpl<CharType> lhs, TypeIdentity_t<StringViewImpl<CharType>> rhs)
noexcept
241 return lhs.compare(rhs) <= 0;
244 template <
typename CharType>
245 TGUI_NODISCARD
constexpr bool operator>(StringViewImpl<CharType> lhs, TypeIdentity_t<StringViewImpl<CharType>> rhs)
noexcept
247 return lhs.compare(rhs) > 0;
250 template <
typename CharType>
251 TGUI_NODISCARD
constexpr bool operator>=(StringViewImpl<CharType> lhs, TypeIdentity_t<StringViewImpl<CharType>> rhs)
noexcept
253 return lhs.compare(rhs) >= 0;
256 using StringView = StringViewImpl<char32_t>;
257 using CharStringView = StringViewImpl<char>;
261#if defined(__clang__)
262# pragma clang diagnostic push
263# pragma clang diagnostic ignored "-Wuser-defined-literals"
264#elif defined(__GNUC__)
265# pragma GCC diagnostic push
266# pragma GCC diagnostic ignored "-Wliteral-suffix"
267#elif defined (_MSC_VER)
268# pragma warning(push)
269# pragma warning(disable: 4455)
271 inline namespace literals
273 inline namespace string_view_literals
275 inline constexpr StringViewImpl<char>
operator""sv(
const char* str,
size_t len)
noexcept
277 return StringViewImpl<char>{str, len};
280 inline constexpr StringViewImpl<wchar_t>
operator""sv(
const wchar_t* str,
size_t len)
noexcept
282 return StringViewImpl<wchar_t>{str, len};
285 inline constexpr StringViewImpl<char16_t>
operator""sv(
const char16_t* str,
size_t len)
noexcept
287 return StringViewImpl<char16_t>{str, len};
290 inline constexpr StringViewImpl<char32_t>
operator""sv(
const char32_t* str,
size_t len)
noexcept
292 return StringViewImpl<char32_t>{str, len};
296#if defined(__clang__)
297# pragma clang diagnostic pop
298#elif defined(__GNUC__)
299# pragma GCC diagnostic pop
300#elif defined (_MSC_VER)
316 return std::equal(view1.begin(), view1.end(), view2.begin(), view2.end(),
317 [](
char char1,
char char2)
322 return std::tolower(static_cast<unsigned char>(char1)) == std::tolower(static_cast<unsigned char>(char2));
337 return std::equal(view1.begin(), view1.end(), view2.begin(), view2.end(),
338 [](
char32_t char1,
char32_t char2)
342 else if ((char1 < 128) && (char2 < 128))
343 return std::tolower(static_cast<unsigned char>(char1)) == std::tolower(static_cast<unsigned char>(char2));
350#if TGUI_COMPILED_WITH_CPP_VER >= 17 && defined(__cpp_lib_starts_ends_with) && (__cpp_lib_starts_ends_with >= 201711L)
359 TGUI_NODISCARD
inline bool viewStartsWith(CharStringView viewToLookInto, CharStringView viewToLookFor)
361 return viewToLookInto.starts_with(viewToLookFor);
372 TGUI_NODISCARD
inline bool viewStartsWith(CharStringView viewToLookInto,
char charToLookFor)
374 return viewToLookInto.starts_with(charToLookFor);
385 TGUI_NODISCARD
inline bool viewEndsWith(CharStringView viewToLookInto, CharStringView viewToLookFor)
387 return viewToLookInto.ends_with(viewToLookFor);
398 TGUI_NODISCARD
inline bool viewEndsWith(CharStringView viewToLookInto,
char charToLookFor)
400 return viewToLookInto.ends_with(charToLookFor);
411 TGUI_NODISCARD
inline bool viewStartsWith(StringView viewToLookInto, StringView viewToLookFor)
413 return viewToLookInto.starts_with(viewToLookFor);
424 TGUI_NODISCARD
inline bool viewStartsWith(StringView viewToLookInto,
char32_t charToLookFor)
426 return viewToLookInto.starts_with(charToLookFor);
437 TGUI_NODISCARD
inline bool viewEndsWith(StringView viewToLookInto, StringView viewToLookFor)
439 return viewToLookInto.ends_with(viewToLookFor);
450 TGUI_NODISCARD
inline bool viewEndsWith(StringView viewToLookInto,
char32_t charToLookFor)
452 return viewToLookInto.ends_with(charToLookFor);
463 TGUI_NODISCARD
inline bool viewStartsWith(CharStringView viewToLookInto, CharStringView viewToLookFor)
465 if (viewToLookFor.length() > viewToLookInto.length())
468 return viewToLookInto.substr(0, viewToLookFor.length()) == viewToLookFor;
479 TGUI_NODISCARD
inline bool viewStartsWith(CharStringView viewToLookInto,
char charToLookFor)
481 return !viewToLookInto.empty() && (viewToLookInto.front() == charToLookFor);
492 TGUI_NODISCARD
inline bool viewEndsWith(CharStringView viewToLookInto, CharStringView viewToLookFor)
494 if (viewToLookFor.length() > viewToLookInto.length())
497 return CharStringView(viewToLookInto.data() + (viewToLookInto.length() - viewToLookFor.length()), viewToLookFor.length()).compare(viewToLookFor) == 0;
508 TGUI_NODISCARD
inline bool viewEndsWith(CharStringView viewToLookInto,
char charToLookFor)
510 return !viewToLookInto.empty() && (viewToLookInto.back() == charToLookFor);
521 TGUI_NODISCARD
inline bool viewStartsWith(StringView viewToLookInto, StringView viewToLookFor)
523 if (viewToLookFor.length() > viewToLookInto.length())
526 return viewToLookInto.substr(0, viewToLookFor.length()) == viewToLookFor;
537 TGUI_NODISCARD
inline bool viewStartsWith(StringView viewToLookInto,
char32_t charToLookFor)
539 return !viewToLookInto.empty() && (viewToLookInto.front() == charToLookFor);
550 TGUI_NODISCARD
inline bool viewEndsWith(StringView viewToLookInto, StringView viewToLookFor)
552 if (viewToLookFor.length() > viewToLookInto.length())
555 return StringView(viewToLookInto.data() + (viewToLookInto.length() - viewToLookFor.length()), viewToLookFor.length()).compare(viewToLookFor) == 0;
566 TGUI_NODISCARD
inline bool viewEndsWith(StringView viewToLookInto,
char32_t charToLookFor)
568 return !viewToLookInto.empty() && (viewToLookInto.back() == charToLookFor);
Namespace that contains all TGUI functions and classes.
Definition AbsoluteOrRelativeValue.hpp:38
bool viewStartsWith(CharStringView viewToLookInto, CharStringView viewToLookFor)
Checks whether the view starts with the given substring.
Definition StringView.hpp:463
bool viewEqualIgnoreCase(CharStringView view1, CharStringView view2)
Returns whether two view are equal if letters would have been lowercase.
Definition StringView.hpp:314
bool viewEndsWith(CharStringView viewToLookInto, CharStringView viewToLookFor)
Checks whether the view ends with the given substring.
Definition StringView.hpp:492