wcsxfrm()

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

Прототип:

#include <wchar.h>
int wcscfrm( wchar_t *ws1,
const wchar_t *ws2,
size_t n );

Аргументы:

ws1
Строка, которую необходимо преобразовать.
ws2
Строка, которую необходимо поместить в dst.
n
Максимальное число символов для преобразования.

Библиотека:

libc

Описание:

Функция wcsxfrm() преобразует строку, указанную в ws2, в область памяти, указанную в ws1, с максимальным количеством n широких символов, включая завершающий NUL. Две строки не должны быть пересекающимися.

Вызов wcscmp() возвращает идентичные результаты для двух строк преобразованных с помощью wcsxfrm(), что и wcscoll() вернула бы для оригинальных строк.


Note: Функция не возвращает информацию об ошибках во время своего выполнения; для отслеживания ошибок установите переменной errno значение 0, вызовите wcsxfrm(), а затем проверьте значение errno снова.

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

Длина преобразованной строки из широких символов. Если значение больше n, содержание ws1 сформировано неокончательно.

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

ANSI, POSIX 1003.1

Безопасность использования
Точка остановки потока
Нет
Обработчик прерываний
Нет
Обработчик сигналов
Да
В потоке
Да

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

setlocale(), strxfrm()




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