std::wcsncat
Определено в заголовке <cwchar> | ||
|---|---|---|
wchar_t* wcsncat( wchar_t* dest, const wchar_t* src, std::size_t count ); |
Присоединяет не более count широких символов из широкой строки, на которую указывает src, к концу строки символов, на которую указывает dest, останавливаясь, если скопирован символ конца строки. Широкий символ src[0] заменяет символ конца строки в конце dest. Символ конца строки всегда добавляется в конце (так что максимальное количество широких символов, которое функция может записать, составляет count + 1).
Поведение не определено, если целевой массив недостаточно велик для содержимого как src, так и dest, и заключительного нулевого широкого символа.
Поведение не определено, если строки перекрываются.
Параметры
| dest | - | указатель на строку широких символов с нулевым завершением, к которой нужно добавить |
| src | - | указатель на строку широких символов с нулевым завершением, из которой нужно скопировать |
| count | - | максимальное количество широких символов для копирования |
Возвращаемое значение
dest
Пример
#include <clocale>
#include <cwchar>
#include <iostream>
int main(void)
{
wchar_t str[50] = L"Земля, прощай.";
std::wcsncat(str, L" ", 1);
std::wcsncat(str, L"В добрый путь.", 8); // only append the first 8 wide chars
std::setlocale(LC_ALL, "en_US.utf8");
std::wcout.imbue(std::locale("en_US.utf8"));
std::wcout << str << '\n';
}Возможный вывод:
Земля, прощай. В добрый
См. также
| добавляет копию одной широкой строки к другой (функция) |
|
| конкатенирует определенное количество символов двух строк (функция) |
|
| копирует одну широкую строку в другую (функция) |
|
Документация C для wcsncat |
|
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/string/wide/wcsncat