mbstowcs()

Преобразовать строку из многобайтовых символов в строку из широких символов

Прототип:

#include <stdlib.h>
                                       
size_t mbstowcs( wchar_t *pwcs,
                 const char *s,
                 size_t n );

Аргументы:

pwcs

A pointer to a buffer where the function can store the wide-character string.

s

The string of multibyte characters that you want to convert.

n

The maximum number of wide characters to store in the buffer that pwcs points to.

Библиотека:

libc

Описание:

The mbstowcs() function converts a sequence of multibyte characters pointed to by s into their corresponding wide-character codes pointed to by pwcs, to a maximum of n wide characters. It doesn't convert any multibyte characters beyond a NULL character.

This function is affected by LC_TYPE.

The mbsrtowcs() function is a restartable version of mbstowcs().

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

The number of array elements modified, not including the terminating zero code, if present, or (size_t)-1 if an invalid multibyte character was encountered.

---

If the number of elements is equal to n, the array isn't terminated by a null character.

---

Коды ошибок:

EILSEQ

Invalid character sequence.

Примеры:

#include <stdio.h>
#include <stdlib.h>
                                       
int main( void )
{
    char    *wc = "string";
    wchar_t wbuffer[50];
    int     i, len;
                                       
    len = mbstowcs( wbuffer, wc, 50 );
    if ( len != -1 )
    {
        wbuffer[len] = '\0';
        printf( "%s(%d)\n", wc, len );
            
        for ( i = 0; i < len; i++ )
        {
            printf( "/%4.4x", wbuffer[i] );
        }
            
        printf( "\n" );
    }
        
    return (EXIT_SUCCESS);
}

Код генерирует следующий вывод:

$ ./a.out string(6) /0073/0074/0072/0069/006e/0067

Классификация:

ANSI, POSIX 1003.1

Точка остановки потока

Нет

Обработчик прерываний

Нет

Обработчик сигналов

Да

В потоке

Да

Тематические ссылки:

errno mblen(), mbrlen(), mbrtowc(), mbsinit(), mbsrtowcs(), mbtowc()

Предыдущий раздел: Описание API системной библиотеки