BloombergLP::bdlde::Utf8Util::ErrorStatus

Enumerate the error status values that are returned (possibly through an out parameter) from some methods in this utility. Note that some of the functions in this struct have a return value that is non-negative on success, and one of these values when an error occurs, so all of these values must be negative to distinguish them from a "success" value.

Synopsis

Declared in <bdlde_utf8util.h>

enum ErrorStatus;

Members

NameDescription
k_END_OF_INPUT_TRUNCATION End of input was reached partway through a multibyte UTF-8 sequence.
k_UNEXPECTED_CONTINUATION_OCTET End of input was reached partway through a multibyte UTF-8 sequence.
k_NON_CONTINUATION_OCTET A non-continuation byte was expected but not found.
k_OVERLONG_ENCODING The encoded Unicode value could have been encoded in fewer bytes.
k_INVALID_INITIAL_OCTET A sequence began with an octet with its 5 highest-order bits all set, which is always invalid in UTF-8.
k_VALUE_LARGER_THAN_0X10FFFF A sequence began with an octet with its 5 highest-order bits all set, which is always invalid in UTF-8.
k_SURROGATE Illegal occurrence of Unicode code point reserved for surrogate values in UTF-16. Note that all surrogate values are illegal as Unicode code points.