This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

utf8strnlen()

Find the number of bytes used by a UTF-8 character string

Synopsis:

#include <utf8.h>

int utf8strnlen( char const *text,
                 int max_len,
                 int *num );

Arguments:

text

A UTF-8 string.

max_len

The maximum number of characters to count.

num

A pointer to a location where utf8strnlen() stores the number of characters formed by the number of bytes occupied by max_len characters in the string text. This will be different from max_len if there are fewer than max_len UTF-8 characters in text.

Library:

ph

Description:

The utf8strnlen() function returns the number of bytes occupied by max_len characters in the string text.

Returns:

The number of bytes occupied by max_len characters in the string text.

Classification:

Photon

See also:

utf8len(), utf8strblen(), utf8strlen()

Unicode Multilingual Support in the Photon Programmer's Guide