WCPNCPY

Section: Linux Programmer's Manual (3)
Updated: 2019-03-06
Index JM Home Page
 

名前

wcpncpy - 固定長のワイド文字文字列をコピーし、その末尾を指すポインターを返す  

書式

#include <wchar.h>

wchar_t *wcpncpy(wchar_t *dest, const wchar_t *src, size_t n);

glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):

wcpncpy():

glibc 2.10 以降:
_POSIX_C_SOURCE >= 200809L
glibc 2.10 より前:
_GNU_SOURCE
 

説明

wcpncpy() 関数は、 stpncpy(3) 関数に対応するワイド文字関数である。 この関数は、src が指すワイド文字文字列から dest が指す ワイド文字文字列に、終端のヌルワイド文字 (L'\0') を含めて 最大 n 文字をコピーする。 ちょうど n 個のワイド文字が dest にコピーされる。 つまり、wcslen(src) の長さが n より小さければ、 dest が指す配列中の残りのワイド文字は L'\0' 文字で埋められる。 wcslen(src) の長さが n 以上ならば、dest が指す 文字列は L'\0' で終端されない。

これらの文字列は重なっていてはならない。

プログラマは、少なくとも n 個のワイド文字が入る領域を dest に確保しなければならない。  

返り値

wcpncpy() は、最後に書き込まれたワイド文字へのポインター、 すなわち dest+n-1 を返す。  

属性

この節で使用されている用語の説明については、 attributes(7) を参照。
インターフェース 属性 値
wcpncpy() Thread safety MT-Safe
 

準拠

POSIX.1-2008.  

関連項目

stpncpy(3), wcsncpy(3)  

この文書について

この man ページは Linux man-pages プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は https://www.kernel.org/doc/man-pages/ に書かれている。

関連キーワード

ワイド   コピー   wchar   wcpncpy   ポインター   終端   固定   末尾   size   検査   マクロ   要件   macros   ヌルワイド   最大   以上   プログラマ   領域   確保   最後   用語   allbox   インターフェース   属性   Thread

Linux マニュアル 一覧

関連するコマンド・関数

wcsncpy.3   wcpcpy.3   wcsncat.3   wcscat.3   wcscpy.3   wcsnlen.3
 

Index

名前
書式
説明
返り値
属性
準拠
関連項目
この文書について

This document was created by man2html, using the manual pages.
Time: 04:39:28 GMT, October 11, 2026