wcscpy, wcscpy_s
С ru.cppreference.net
| Определён в заголовочном файле <wchar.h>
|
||
wchar_t* wcscpy( wchar_t* dest, const wchar_t* src );
|
(1) | (начиная с C95) (до C99) |
wchar_t* wcscpy( wchar_t* restrict dest, const wchar_t* restrict src );
|
(начиная с C99) | |
errno_t wcscpy_s( wchar_t* restrict dest, rsize_t destsz,
const wchar_t* restrict src );
|
(2) | (начиная с C11) |
1) Копирует широкую строку, на которую указывает
src (включая завершающий нулевой широкий символ), в массив широких символов, на который указывает dest. Поведение не определено, если массив dest недостаточно велик. Поведение не определено, если строки перекрываются.2) То же, что и (1), за исключением того, что она может перезаписывать остаток массива назначения неопределёнными значениями, а также что следующие ошибки обнаруживаются во время выполнения и вызывают установленную в данный момент функцию обработчика ограничений:
srcилиdestявляется нулевым указателемdestszравно нулю или большеRSIZE_MAX / sizeof(wchar_t)destszменьше или равноwcsnlen_s(src, destsz), то есть произойдет усечение- произойдет перекрытие между исходной строкой и строкой назначения
- Как и все функции с проверкой границ,
wcscpy_sгарантированно доступна только если__STDC_LIB_EXT1__определена реализацией и если пользователь определяет__STDC_WANT_LIB_EXT1__как целочисленную константу1до включения <wchar.h>.
Параметры
| dest | - | указатель на массив широких символов для копирования |
| src | - | указатель на широкую строку, завершающуюся нулём, из которой копируется |
| destsz | - | максимальное количество символов для записи, обычно размер буфера назначения |
Возвращаемое значение
1) возвращает копию
dest2) возвращает ноль при успехе, ненулевое значение при ошибке. Также при ошибке записывает
L'\0' в dest[0] (если только dest не является нулевым указателем или destsz не равно нулю или больше RMAX_SIZE / sizeof(wchar_t)).Пример
Запустить этот код
#include <locale.h>
#include <stdio.h>
#include <wchar.h>
int main(void)
{
wchar_t* src = L"犬 means dog";
// src[0] = L'狗' ; // this would be undefined behavior
wchar_t dst[wcslen(src) + 1]; // +1 for the null terminator
wcscpy(dst, src);
dst[0] = L'狗'; // OK
setlocale(LC_ALL, "en_US.utf8");
printf("src = %ls\ndst = %ls\n", src, dst);
}
Вывод:
src = 犬 means dog
dst = 狗 means dog
Ссылки
- Стандарт C23 (ISO/IEC 9899:2024):
- 7.31.4.2.1 Функция wcscpy (p: 438)
- K.3.9.3.1.1 Функция wcscpy_s (p: 663)
- Стандарт C17 (ISO/IEC 9899:2018):
- 7.29.4.1.2 Функция wcscpy (p: TBD)
- K.3.9.2.1.1 Функция wcscpy_s (p: TBD)
- Стандарт C11 (ISO/IEC 9899:2011):
- 7.29.4.1.2 Функция wcscpy (p: 430)
- K.3.9.2.1.1 Функция wcscpy_s (p: 639)
- Стандарт C99 (ISO/IEC 9899:1999):
- 7.24.4.1.2 Функция wcscpy (p: 376)
Смотрите также
(C95)(C11) |
копирует определённое количество широких символов из одной строки в другую (функция) |
(C95)(C11) |
копирует определённое количество широких символов между двумя неперекрывающимися массивами (функция) |
(C11) |
копирует одну строку в другую (функция) |
Документация C++ для wcscpy
| |