[Previous] [Contents] [Index] [Next]

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.
bytes
A pointer to a location where utf8strnlen() stores the number of bytes in the specified portion of the string.

Library:

ph

Description:

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

The num parameter is set to the number of characters formed by the number of bytes returned. This will be different from max_len if there are fewer than max_len UTF-8 characters in text.

Returns:

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

Classification:

Photon

Safety:
Interrupt handler No
Signal handler Yes
Thread Yes

See also:

utf8len(), utf8strblen(), utf8strnlen()

Unicode Multilingual Support in the Photon Programmer's Guide


[Previous] [Contents] [Index] [Next]