Проект OpenNet: MAN mbtowc (3) Библиотечные вызовы (FreeBSD и Linux)

Интерактивная система просмотра системных руководств (man-ов)

mbtowc (3)

mbtowc (3) ( Solaris man: Библиотечные вызовы )

>> mbtowc (3) ( FreeBSD man: Библиотечные вызовы )

mbtowc (3) ( Русские man: Библиотечные вызовы )

mbtowc (3) ( Linux man: Библиотечные вызовы )

mbtowc (3) ( POSIX man: Библиотечные вызовы )

BSD mandoc

NAME



mbtowc

 - convert a character to a wide-character code

LIBRARY

Lb libc

SYNOPSIS

#include <stdlib.h>
int Fo mbtowc Fa wchar_t * restrict wcharp const char * restrict mbchar Fa size_t nbytes Fc

DESCRIPTION

The mbtowc ();
function converts a multibyte character Fa mbchar into a wide character according to the current conversion state, and stores the result in the object pointed to by Fa wcharp . Up to Fa nbytes bytes are examined.

A call with a null Fa mbchar pointer returns nonzero if the current encoding requires shift states, zero otherwise; if shift states are required, the shift state is reset to the initial state.

RETURN VALUES

If Fa mbchar is NULL the mbtowc ();
function returns nonzero if shift states are supported, zero otherwise.

Otherwise, if Fa mbchar is not a null pointer, mbtowc ();
either returns 0 if Fa mbchar represents the null wide character, or returns the number of bytes processed in Fa mbchar , or returns -1 if no multibyte character could be recognized or converted. In this case, mbtowc (Ns 's);
internal conversion state is undefined.