A C++ "range" for non-validating iteration over all of the code points of a code unit range.
More...
template<typename CP32, typename Range>
class U_HEADER_ONLY_NAMESPACE::UnsafeUTFStringCodePoints< CP32, Range >
A C++ "range" for non-validating iteration over all of the code points of a code unit range.
The string must be well-formed.
Call unsafeUTFStringCodePoints() to have the compiler deduce the Range type.
UnsafeUTFStringCodePoints is conditionally borrowed; that is, if Range is a borrowed range so is UnsafeUTFStringCodePoints<CP32, behavior, Range>. Note that when given a range r that is an lvalue and is not a view, unsafeUTFStringCodePoints(r) uses a ref_view of r as the Range type, which is a borrowed range. In practice, this means that given a container variable r, the iterators of unsafeUTFStringCodePoints(r) can be used as long as iterators on r are valid, without having to keep unsafeUTFStringCodePoints(r) around. For instance:
std::u8string s = "𒇧𒇧";
auto it = unsafeUTFStringCodePoints<char32_t>(s).
begin();
++it;
char32_t second_code_point = it->codePoint();
- Template Parameters
-
| CP32 | Code point type: UChar32 (=int32_t) or char32_t or uint32_t |
| Range | A C++ "range" of Unicode UTF-8/16/32 code units |
- Draft:
- This API may be changed in the future versions and was introduced in ICU 78
- See also
- unsafeUTFStringCodePoints
Definition at line 2526 of file utfiterator.h.
template<typename CP32 , typename Range >
template<typename R = Range, typename = std::enable_if_t<std::is_reference_v<R>>, typename = void>
Constructs a C++ "range" object over the code points in the string, keeping a reference to the code unit range.
This overload is used by utfStringCodePoints in C++17; in C++20, a ref_view is used instead (via views::all).
- Parameters
-
- Draft:
- This API may be changed in the future versions and was introduced in ICU 78
Definition at line 2551 of file utfiterator.h.
