wcsrtombs, wcsrtombs_s

size_t wcsrtombs( char *dst, const wchar_t **src, size_t len, mbstate_t* ps );

size_t wcsrtombs( char *restrict dst, const wchar_t **restrict src, size_t len,
                  mbstate_t *restrict ps );

errno_t wcsrtombs_s( size_t *restrict retval, char *restrict dst, rsize_t dstsz,
                     const wchar_t **restrict src, rsize_t len,
                     mbstate_t *restrict ps );

• Преобразован и сохранён нулевой символ L'\0'. В этом случае записанные байты представляют собой последовательность выхода из режима сдвига (если она необходима), за которой следует '\0'; *src устанавливается в значение нулевого указателя, а *ps представляет исходное состояние сдвига.
• Обнаружен wchar_t, который не соответствует допустимому символу в текущей локали C. *src устанавливается так, чтобы указывать на первый непреобразованный широкий символ.
• Запись следующего многобайтового символа превысила бы len. *src устанавливается так, чтобы указывать на первый непреобразованный широкий символ. Это условие не проверяется, если dst является нулевым указателем.

• функция возвращает результат через выходной параметр retval
• если преобразование прекращается без записи нулевого символа, функция записывает '\0' в следующий байт в dst, который может быть dst[len] или dst[dstsz] — в зависимости от того, что встретится раньше (то есть всего может быть записано до len+1/dstsz+1 байт). В этом случае перед завершающим нулём может не быть записана последовательность выхода из режима сдвига.
• функция перезаписывает массив назначения начиная с завершающего нуля и до dstsz
• Если src и dst перекрываются, поведение не определено.
• во время выполнения обнаруживаются следующие ошибки, и вызывается установленная в данный момент функция обработчика ограничений:

• retval, ps, src или *src является нулевым указателем
• dstsz или len больше RSIZE_MAX (если только dst не является нулевым)
• dstsz не равен нулю (если только dst не является нулевым)
• len больше dstsz, а к моменту достижения dstsz преобразование не встретило нулевой символ или ошибку кодирования в массиве src (если только dst не является нулевым)

Как и все функции с проверкой границ, wcsrtombs_s гарантированно доступна только в том случае, если реализация определяет __STDC_LIB_EXT1__, а пользователь задаёт для __STDC_WANT_LIB_EXT1__ целочисленную константу 1 до включения <wchar.h>.

Параметры

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

Пример

#include <stdio.h>
#include <locale.h>
#include <string.h>
#include <wchar.h>

void print_wide(const wchar_t* wstr)
{
    mbstate_t state;
    memset(&state, 0, sizeof state);
    size_t len = 1 + wcsrtombs(NULL, &wstr, 0, &state);
    char mbstr[len];
    wcsrtombs(mbstr, &wstr, len, &state);
    printf("Multibyte string: %s\n", mbstr);
    printf("Length, including '\\0': %zu\n", len);
}

int main(void)
{
    setlocale(LC_ALL, "en_US.utf8");
    print_wide(L"z\u00df\u6c34\U0001f34c"); // or L"zß水🍌"
}

Multibyte string: zß水🍌
Length, including '\0': 11

Ссылки

• Стандарт C17 (ISO/IEC 9899:2018):
• 7.29.6.4.2 Функция wcsrtombs (стр. 324–325)
• K.3.9.3.2.2 Функция wcsrtombs_s (стр. 471–472)
• Стандарт C11 (ISO/IEC 9899:2011):
• 7.29.6.4.2 Функция wcsrtombs (стр. 446)
• K.3.9.3.2.2 Функция wcsrtombs_s (стр. 649–651)
• Стандарт C99 (ISO/IEC 9899:1999):
• 7.24.6.4.2 Функция wcsrtombs (стр. 392)

См. также