Return the number of Unicode code points in the specified string having the specified length (in bytes) if string contains valid UTF-8, with no effect on the specified invalidString. 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.
Declared in <bdlde_utf8util.h>
static
Utf8Util::IntPtr
numCharactersIfValid(
char const** invalidString,
char const* string,
size_type length);
DEPRECATED: Use numCodePointsIfValid instead.