Manpages

名 前

stpncpy − 固 定 長 の 文 字 列 を コ ピ ー し て 、 そ の 最 後 へ の ポ イ ン タ ー を 返 す

書 式

#include <string.h>

char *stpncpy(char *dest, const char *src, size_t n);

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

stpncpy():

glibc 2.10 以 降 :

_XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L

glibc 2.10 よ り 前 :

_GNU_SOURCE

説 明

stpncpy() 関 数 は src が 指 し て い る 文 字 列 か ら 終 端 の ヌ ル バ イ ト ('\0') を 含 め て 最 大 n バ イ ト を dest に コ ピ ー す る 。 長 さ strlen(src) が n よ り 小 さ い 場 合 に は dest の 残 り の 部 分 に は ヌ ル バ イ ト ('\0') 文 字 が 埋 め ら れ る 。 長 さ strlen(src) が n 以 上 な ら ば 、 dest が 指 す 文 字 列 は ヌ ル で 終 端 さ れ て い な い 。 二 つ の 文 字 列 は 重 な っ て は な ら な い 。 プ ロ グ ラ マ ー は dest に 少 な く と も n バ イ ト の 空 き が あ る こ と を 保 証 し な け れ ば な ら な い 。

返 り 値

stpncpy() は dest の 終 端 の ヌ ル バ イ ト を 指 す ポ イ ン タ ー を 返 す か 、 dest が ヌ ル バ イ ト で 終 端 さ れ て い な い 場 合 に は dest+n を 返 す 。

属 性

マ ル チ ス レ ッ デ ィ ン グ (pthreads(7) 参 照 )

stpncpy() 関 数 は ス レ ッ ド セ ー フ で あ る 。

準 拠

こ の 関 数 は POSIX.1−2008 に 追 加 さ れ た 。 そ れ 以 前 は GNU に よ る 拡 張 で あ っ た 。 こ の 関 数 は 1993 年 に GNU C ラ イ ブ ラ リ の バ ー ジ ョ ン 1.07 で 初 め て 登 場 し た 。

関 連 項 目

strncpy(3), wcpncpy(3)

こ の 文 書 に つ い て

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