Unicode namespace
#include <Corrade/Utility/Unicode.h>
Unicode utilities.
Contents
- Reference
This library is built if WITH_UTILITY is enabled when building Corrade. To use this library with CMake, you need to request the Utility component of the Corrade package and link to the Corrade::Utility target.
find_package(Corrade REQUIRED Utility) # ... target_link_libraries(your-app Corrade::Utility)
See also Downloading and building Corrade and Using Corrade with CMake for more information.
Functions
-
auto nextChar(Containers::
ArrayView<const char> text, std:: size_t cursor) -> std:: pair<char32_t, std:: size_t> - Next UTF-8 character.
-
auto prevChar(Containers::
ArrayView<const char> text, std:: size_t cursor) -> std:: pair<char32_t, std:: size_t> - Previous UTF-8 character.
-
auto utf8(char32_t character,
Containers::
StaticArrayView<4, char> result) -> std:: size_t - Convert UTF-32 character to UTF-8.
-
auto utf32(const std::
string& text) -> std:: u32string - Convert UTF-8 to UTF-32.
-
auto nextChar(const std::
string& text, const std:: size_t cursor) -> std:: pair<char32_t, std:: size_t> -
template<std::auto nextChar(const char(&text)[size], const std::
size_t size> size_t cursor) -> std:: pair<char32_t, std:: size_t> -
auto prevChar(const std::
string& text, const std:: size_t cursor) -> std:: pair<char32_t, std:: size_t> -
template<std::auto prevChar(const char(&text)[size], const std::
size_t size> size_t cursor) -> std:: pair<char32_t, std:: size_t> -
auto widen(const std::
string& text) -> std:: wstring - Widen UTF-8 string for use with Windows Unicode APIs.
-
auto widen(Containers::
ArrayView<const char> text) -> std:: wstring -
auto widen(const char* text) -> std::
wstring -
auto narrow(const std::
wstring& text) -> std:: string - Narrow string to UTF-8 for use with Windows Unicode APIs.
-
auto narrow(Containers::
ArrayView<const wchar_t> text) -> std:: string -
auto narrow(const wchar_t* text) -> std::
string
Function documentation
std::
Next UTF-8 character.
Returns Unicode codepoint of character on the cursor and position of the following character. If an error occurs, returns position of next byte and 0xffffffffu as codepoint.
std::
Previous UTF-8 character.
Returns Unicode codepoint of character before the cursor and its position. If an error occurs, returns position of previous byte and 0xffffffffu as codepoint.
std::
Convert UTF-32 character to UTF-8.
| Parameters | |
|---|---|
| character in | UTF-32 character to convert |
| result out | Where to put the UTF-8 result |
Returns length of the encoding (1, 2, 3 or 4). If character is outside of UTF-32 range, returns 0.
std::
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
template<std::
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
std::
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
template<std::
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
std::
Widen UTF-8 string for use with Windows Unicode APIs.
Converts UTF-8 string to wide-string (UTF-16) representation. Primary purpose is easy interaction with Windows Unicode APIs, thus the function doesn't return std::
std::
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
std::
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Expects that text is null-terminated.
std::
Narrow string to UTF-8 for use with Windows Unicode APIs.
Converts wide-string (UTF-16) to UTF-8 representation. Primary purpose is easy interaction with Windows Unicode APIs, thus the function doesn't accept std::
std::
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
std::
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Expects that text is null-terminated.