draft/man3/wcsncpy.3

   1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   2 .\"
   3 .\" This is free documentation; you can redistribute it and/or
   4 .\" modify it under the terms of the GNU General Public License as
   5 .\" published by the Free Software Foundation; either version 2 of
   6 .\" the License, or (at your option) any later version.
   7 .\"
   8 .\" References consulted:
   9 .\"   GNU glibc-2 source code and manual
  10 .\"   Dinkumware C library reference http://www.dinkumware.com/
  11 .\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
  12 .\"   ISO/IEC 9899:1999
  13 .\"
  14 .\"*******************************************************************
  15 .\"
  16 .\" This file was generated with po4a. Translate the source file.
  17 .\"
  18 .\"*******************************************************************
  19 .TH WCSNCPY 3 2011\-09\-28 GNU "Linux Programmer's Manual"
  20 .SH 名前
  21 wcsncpy \- 固定長のワイド文字文字列をコピーする
  22 .SH 書式
  23 .nf
  24 \fB#include <wchar.h>\fP
  25 .sp
  26 \fBwchar_t *wcsncpy(wchar_t *\fP\fIdest\fP\fB, const wchar_t *\fP\fIsrc\fP\fB, size_t \fP\fIn\fP\fB);\fP
  27 .fi
  28 .SH 説明
  29 \fBwcsncpy\fP()  関数は、 \fBstrncpy\fP(3)  関数に対応するワイド文字関数である。 この関数は \fIsrc\fP
  30 が指すワイド文字文字列から、 終端の NULL ワイド文字 (L\(aq\e0\(aq) を 含めて最大 \fIn\fP 個のワイド文字を、\fIdest\fP
  31 が指す配列にコピーする。 ちょうど \fIn\fP 個のワイド文字が \fIdest\fP に書き込まれる。 \fIwcslen(src)\fP の長さが \fIn\fP
  32 より小さければ、\fIdest\fP が指す 配列の残りのワイド文字の部分は NULL ワイド文字で埋められる。 \fIwcslen(src)\fP の長さが
  33 \fIn\fP 以上ならば、\fIdest\fP が指す文字列 が NULL ワイド文字で終端されることはない。
  34 .PP
  35 これらの文字列は重なっていてはならない。
  36 .PP
  37 プログラマは、少なくとも \fIn\fP 個のワイド文字が入る領域を \fIdest\fP に確保しなければならない。
  38 .SH 返り値
  39 \fBwcsncpy\fP()  は \fIdest\fP を返す。
  40 .SH 準拠
  41 C99.
  42 .SH 関連項目
  43 \fBstrncpy\fP(3)