A C++ "range" for validating iteration over all of the code points of a code unit range.
More...
|
| | UTFStringCodePoints ()=default |
| | Constructs an empty C++ "range" object.
|
| |
| template<typename R = Range, typename = std::enable_if_t<!std::is_reference_v<R>>> |
| | UTFStringCodePoints (Range unitRange) |
| | Constructs a C++ "range" object over the code points in the string.
|
| |
| template<typename R = Range, typename = std::enable_if_t<std::is_reference_v<R>>, typename = void> |
| | UTFStringCodePoints (Range unitRange) |
| | Constructs a C++ "range" object over the code points in the string, keeping a reference to the code unit range.
|
| |
| | UTFStringCodePoints (const UTFStringCodePoints &other)=default |
| | Copy constructor.
|
| |
| UTFStringCodePoints & | operator= (const UTFStringCodePoints &other)=default |
| | Copy assignment operator.
|
| |
| auto | begin () |
| |
| template<typename R = Range, typename = std::enable_if_t<prv::range<const R>>> |
| auto | begin () const |
| |
| auto | end () |
| |
| template<typename R = Range, typename = std::enable_if_t<prv::range<const R>>> |
| auto | end () const |
| |
| auto | rbegin () const |
| |
| auto | rend () const |
| |
template<typename CP32,
UTFIllFormedBehavior behavior, typename Range>
class U_HEADER_ONLY_NAMESPACE::UTFStringCodePoints< CP32, behavior, Range >
A C++ "range" for validating iteration over all of the code points of a code unit range.
Call utfStringCodePoints() to have the compiler deduce the Range type.
UTFStringCodePoints is conditionally borrowed; that is, if Range is a borrowed range so is UTFStringCodePoints<CP32, behavior, Range>. Note that when given a range r that is an lvalue and is not a view, utfStringCodePoints(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 utfStringCodePoints(r) can be used as long as iterators on r are valid, without having to keep utfStringCodePoints(r) around. For instance:
std::u8string s = "𒇧𒇧";
auto it = utfStringCodePoints<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; should be signed if UTF_BEHAVIOR_NEGATIVE |
| behavior | How to handle ill-formed Unicode strings |
| 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
- utfStringCodePoints
Definition at line 1785 of file utfiterator.h.
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 1810 of file utfiterator.h.
