- cwchar[meta header]
- std[meta namespace]
- function[meta id-type]
namespace std {
wchar_t* wcsncpy(wchar_t* s1, const wchar_t* s2, size_t n);
}- size_t[link /reference/cstddef/size_t.md]
文字数を指定して、ワイド文字列をコピーする。
s2が指す文字列から、最大n文字をs1が指す配列へコピーする。s2の長さがn未満である場合、n文字になるまでヌル文字が書き込まれる。
s1を返す。
s2の長さがn以上である場合、コピー先は終端のヌル文字をもたない。この場合、文字列としてそのまま扱った場合、動作は未定義である- コピー元とコピー先の領域が重なっている場合、動作は未定義である
- この関数は、C++26からフリースタンディング処理系でも使用できる
#include <cwchar>
#include <iostream>
int main()
{
wchar_t buffer[8] = {};
// 元の文字列が短い場合、残りはヌル文字で埋められる
std::wcsncpy(buffer, L"abc", 7);
std::wcout << buffer << std::endl;
}- std::wcsncpy[color ff0000]
- std::wcout[link /reference/iostream/wcout.md]
abc
- C++98
wcscpystd::strncpy(): マルチバイト文字列版
- P2338R4 Freestanding Library: Character primitives and the C library
- C++26で、この関数がフリースタンディング処理系で使用可能になった