BloombergLP::bdlde::Utf8Util::numBytesIfValid

Return the byte length of the first numCodePoints encodings.

Synopsis

Declared in <bdlde_utf8util.h>

static
Utf8Util::IntPtr
numBytesIfValid(
    std::string_view const& string,
    IntPtr numCodePoints);

Description

Return the length (in bytes) of the specified numCodePoints UTF-8 encodings in the specified string, or a value less than 0 if string contains less than numCodePoints encodings. The behavior is undefined unless string refers to valid UTF-8. Note that string may contain more than numCodePoints encodings in which case the trailing ones are ignored.

DEPRECATED: Use numBytesRaw instead.

Return Value

byte length of those encodings, or a negative value if fewer

Parameters

NameDescription
stringvalid UTF-8 string view to measure
numCodePointsnumber of leading code points to measure