std:: wcsncpy

最大で count 文字のワイド文字列（終端のナルワイド文字を含む）を src が指す先から dest が指すワイド文字配列にコピーします。

count が文字列全体 src のコピー完了前に到達した場合、結果のワイド文字配列はnull終端されません。

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

関連項目