ИМЯ¶

mbstowcs - преобразует многобайтовую строку в строку широких символов

СИНТАКСИС¶

#include <stdlib.h>

size_t mbstowcs(wchar_t *dest, const char *src, size_t n);

ОПИСАНИЕ¶

Если значение dest не равно NULL, то функция mbstowcs() преобразует многобайтовую строку src в широкосимвольную строку начиная с dest. В dest будет записано не более n широких символов. Последовательность символов в строке src должна начинаться с начального состояния. Преобразование может прекратиться по трём причинам:

1.

Во входных данных находится неправильная многобайтовая последовательность. В этом случае возвращается (size_t) -1.

2.

В dest было сохранено n не равных L'\0' широких символов. В этом случае будет возвращено количество широких символов, записанных в dest, но состояние сдвига в этой точке теряется.

3.

Многобайтовая строка была полностью преобразована, включая завершающий символ null ('\0'). В этом случае возвращается количество записанных в dest широких символов, не считая завершающий широкий символ null.

Программист должен проверить, что в dest есть место по крайней мере для n широких символов.

Если значение dest равно NULL, то n игнорируется и преобразование выполняется как описано выше, исключая то, что преобразованные широкие символы не записываются в память и нет ограничения по длине.

Для того, чтобы избежать ограничения пункта 2, программист должен удостовериться, что значение n больше или равно mbstowcs(NULL,src,0)+1.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶

Функция mbstowcs() возвращает количество широких символов, которые составили преобразованную часть широкосимвольной строки, не включая конечный широкий символ null Если обнаружена некорректная многобайтовая последовательность, то возвращается (size_t) -1.

АТРИБУТЫ¶

Описание терминов данного раздела смотрите в attributes(7).

СООТВЕТСТВИЕ СТАНДАРТАМ¶

POSIX.1-2001, POSIX.1-2008, C99.

ЗАМЕЧАНИЯ¶

Поведение mbstowcs() зависит от категории LC_CTYPE текущей локали.

Функция mbsrtowcs(3) предоставляет лучший интерфейс с теми же возможностями.

ПРИМЕРЫ¶

В программе, представленной ниже, показано использование mbstowcs(), а также некоторые функции классификации широких символов. Пример запуска:

$ ./t_mbstowcs de_DE.UTF-8 Grüße!
Длина исходной строки (без конечного символа):


    8 байт


    6 многобайтовых символов
Строка широких символов: Grüße! (6 символов)


    G буква заглавная


    r буква строчная


    ü буква строчная


    ß буква строчная


    e буква строчная


    ! !буква

#include <wctype.h>
#include <locale.h>
#include <wchar.h>
#include <stdio.h>
#include <string.h>
#include <stdlib.h>
int
main(int argc, char *argv[])
{


    size_t mbslen;      /* Number of multibyte characters in source */


    wchar_t *wcs;       /* Pointer to converted wide character string */


    if (argc < 3) {


        fprintf(stderr, "Использование: %s <локаль> <строка>\n", argv[0]);


        exit(EXIT_FAILURE);


    }


    /* применяем указанную локаль */


    if (setlocale(LC_ALL, argv[1]) == NULL) {


        perror("setlocale");


        exit(EXIT_FAILURE);


    }


    /* вычисляем длину, которая требуется для хранения argv[2],


       преобразованной в строку широких символов */


    mbslen = mbstowcs(NULL, argv[2], 0);


    if (mbslen == (size_t) -1) {


        perror("mbstowcs");


        exit(EXIT_FAILURE);


    }


    /* опишем исходную строку пользователю */


    printf("Длина исходной строки (без конечного символа):\n");


    printf("    %zu байт\n", strlen(argv[2]));


    printf("    %zu многобайтовых символов\n\n", mbslen);


    /* выделим место под строку широких символов желаемого размера.


       Добавим 1 для конечного широкого символа null (L'\0'). */


    wcs = calloc(mbslen + 1, sizeof(*wcs));


    if (wcs == NULL) {


        perror("calloc");


        exit(EXIT_FAILURE);


    }


    /* преобразуем многобайтовую строку из argv[2] в


       строку широких символов */


    if (mbstowcs(wcs, argv[2], mbslen + 1) == (size_t) -1) {


        perror("mbstowcs");


        exit(EXIT_FAILURE);


    }


    printf("Строка широких символов: %ls (%zu символов)\n",


            wcs, mbslen);


    /* теперь посмотрим на классы символов в


       строке широких символов */


    for (wchar_t *wp = wcs; *wp != 0; wp++) {


        printf("    %lc ", (wint_t) *wp);


        if (!iswalpha(*wp))


            printf("!");


        printf("буква ");


        if (iswalpha(*wp)) {


            if (iswupper(*wp))


                printf("заглавная ");


            if (iswlower(*wp))


                printf("строчная ");


        }


        putchar('\n');


    }


    exit(EXIT_SUCCESS);
}

СМ. ТАКЖЕ¶

mblen(3), mbsrtowcs(3), mbtowc(3), wcstombs(3), wctomb(3)

ЗАМЕЧАНИЯ¶

Эта страница является частью проекта Linux man-pages версии 5.10. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.

ПЕРЕВОД¶

Русский перевод этой страницы руководства был сделан aereiae <aereiae@gmail.com>, Alexey <a.chepugov@gmail.com>, Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitriy S. Seregin <dseregin@59.ru>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, ITriskTI <ITriskTI@gmail.com>, Max Is <ismax799@gmail.com>, Yuri Kozlov <yuray@komyakino.ru>, Иван Павлов <pavia00@gmail.com> и Малянов Евгений Викторович <maljanow@outlook.com>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.