mbtowc, _mbtowc_l

Статья
02/20/2013

Преобразование многобайтовый символ в соответствующий расширенному символ.

int mbtowc(
   wchar_t *wchar,
   const char *mbchar,
   size_t count 
);
int _mbtowc_l(
   wchar_t *wchar,
   const char *mbchar,
   size_t count,
   _locale_t locale
);

Параметры

wchar
Адрес расширенных символов (типа wchar_t).
mbchar
Адрес последовательности байтов (многобайтового символов).
Счетчик
Количество байтов, которое необходимо проверить.
языковой стандарт
Языковой стандарт, который необходимо использовать.

Возвращаемое значение

If mbchar нет Значение NULL если объект и; mbchar точки к формам допустимый символ многобайтовый mbtowc возвращает длину в байтах многобайтового символов.If mbchar существует Значение NULL объект, который он указывает на нуль-символ расширенных символов (L \ 0 '), функция возвращает значение 0.Если объект, mbchar формы точек не допустимы в течение первого символа многобайтовый Счетчик символы, он возвращает - 1.

Заметки

mbtowc функции преобразования Счетчик или меньше байтов, указанных в by mbchar, если mbchar нет Значение NULLк расширенному, соответствующий символ.mbtowc сохраняет результат в расширенный символ wchar, If wchar нет Значение NULL.mbtowc не учитывает более MB_CUR_MAX байты.mbtowc использует текущий языковой стандарт для расширения функциональности, зависимых от языковых стандартов. _mbtowc_l идентичны, за исключением того, что он использует языковой стандарт переданный.Дополнительные сведения см. в разделе Языковой стандарт.

Требования

Процедура	Обязательный заголовок
mbtowc	<stdlib.h>
_mbtowc_l	<stdlib.h>

Дополнительные сведения о совместимости см. Совместимость во введении.

Библиотеки

Все версии Библиотеки времени выполнения C.

Пример

// crt_mbtowc.c
/* Illustrates the behavior of the mbtowc function
 */

#include <stdlib.h>
#include <stdio.h>

int main( void )
{
    int      i;
    char    *pmbc    = (char *)malloc( sizeof( char ) );
    wchar_t  wc      = L'a';
    wchar_t *pwcnull = NULL;
    wchar_t *pwc     = (wchar_t *)malloc( sizeof( wchar_t ) );
    printf( "Convert a wide character to multibyte character:\n" );
    wctomb_s( &i, pmbc, sizeof(char), wc );
    printf( "  Characters converted: %u\n", i );
    printf( "  Multibyte character: %x\n\n", *pmbc );

    printf( "Convert multibyte character back to a wide "
            "character:\n" );
    i = mbtowc( pwc, pmbc, MB_CUR_MAX );
    printf( "  Bytes converted: %u\n", i );
    printf( "  Wide character: %x\n\n", *pwc );
    printf( "Attempt to convert when target is NULL\n" );
    printf( "  returns the length of the multibyte character:\n" );
    i = mbtowc( pwcnull, pmbc, MB_CUR_MAX );
    printf( "  Length of multibyte character: %u\n\n", i );

    printf( "Attempt to convert a NULL pointer to a" );
    printf( " wide character:\n" );
    pmbc = NULL;
    i = mbtowc( pwc, pmbc, MB_CUR_MAX );
    printf( "  Bytes converted: %u\n", i );
}

Output

Convert a wide character to multibyte character:
  Characters converted: 1
  Multibyte character: 61

Convert multibyte character back to a wide character:
  Bytes converted: 1
  Wide character: 61

Attempt to convert when target is NULL
  returns the length of the multibyte character:
  Length of multibyte character: 1

Attempt to convert a NULL pointer to a wide character:
  Bytes converted: 0