std::wcsncpy

wchar_t* wcsncpy( wchar_t* dest, const wchar_t* src, std::size_t count );

Копирует не более count символов широкой строки, на которую указывает src (включая завершающий нулевой широкий символ), в массив широких символов, на который указывает dest.

Если count достигается до копирования всей строки src, результирующий массив широких символов не завершается нулевым символом.

Если после копирования завершающего нулевого широкого символа из src значение count ещё не достигнуто, в dest записываются дополнительные нулевые широкие символы, пока общее число записанных символов не достигнет count.

Если строки перекрываются, поведение не определено.

Параметры

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

dest

Примечания

В типичном случае count — это размер массива назначения.

Пример

#include <cwchar>
#include <iostream>

int main()
{
    const wchar_t src[] = L"hi";
    wchar_t dest[6] = {L'a', L'b', L'c', L'd', L'e', L'f'};

    std::wcsncpy(dest, src, 5); // this will copy 'hi' and repeat \0 three times

    std::wcout << "The contents of dest are: ";
    for (const wchar_t c : dest)
    {
        if (c)
            std::wcout << c << ' ';
        else
            std::wcout << "\\0" << ' ';
    }
    std::wcout << '\n';
}

The contents of dest are: h i \0 \0 \0 f

См. также