Spec-Zone.ru › C++

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';
}

Возможный вывод:

Земля, прощай. В добрый

См. также

wcscat
добавляет копию одной широкой строки к другой
(функция)
strncat
конкатенирует определенное количество символов двух строк
(функция)
wcscpy
копирует одну широкую строку в другую
(функция)
Документация C для wcsncat

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/string/wide/wcsncat

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API