BloombergLP::bdlde::Utf8Util::numCharactersIfValid

Return the Unicode code-point count if string is valid UTF-8.

Synopsis

Declared in <bdlde_utf8util.h>

static
Utf8Util::IntPtr
numCharactersIfValid(
    char const** invalidString,
    char const* string,
    size_type length);

Description

Otherwise, return a negative value and load into invalidString the address of the byte after the last valid Unicode code point traversed. string need not be null-terminated and may contain embedded null bytes, and string may be null if 0 == length (see {Empty Input Strings}). Note that string may contain less than length Unicode code points.

Return Value

code-point count on success, or a negative value on invalid UTF-8

Parameters

NameDescription
invalidStringif non-null, set to the first invalid byte on error
stringUTF-8 byte sequence to examine
lengthlength of string in bytes