release/man3/mempcpy.3

   1 .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\"
   3 .\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
   4 .\" Distributed under GPL
   5 .\" %%%LICENSE_END
   6 .\"
   7 .\" Heavily based on glibc infopages, copyright Free Software Foundation
   8 .\"
   9 .\" aeb, 2003, polished a little
  10 .\"*******************************************************************
  11 .\"
  12 .\" This file was generated with po4a. Translate the source file.
  13 .\"
  14 .\"*******************************************************************
  15 .TH MEMPCPY 3 2008\-08\-11 GNU "Linux Programmer's Manual"
  16 .SH 名前
  17 mempcpy, wmempcpy \- メモリ領域をコピーする
  18 .SH 書式
  19 .nf
  20 \fB#define _GNU_SOURCE\fP         /* feature_test_macros(7) 参照 */
  21 .br
  22 \fB#include <string.h>\fP
  23 .sp
  24 \fBvoid *mempcpy(void *\fP\fIdest\fP\fB, const void *\fP\fIsrc\fP\fB, size_t \fP\fIn\fP\fB);\fP
  25 .sp
  26 \fB#define _GNU_SOURCE\fP         /* feature_test_macros(7) 参照 */
  27 .br
  28 \fB#include <wchar.h>\fP
  29 .sp
  30 \fBwchar_t *wmempcpy(wchar_t *\fP\fIdest\fP\fB, const wchar_t *\fP\fIsrc\fP\fB, size_t \fP\fIn\fP\fB);\fP
  31 .fi
  32 .SH 説明
  33 \fBmempcpy\fP()  関数は \fBmemcpy\fP(3)  関数とほぼ同一である。 この関数は、 \fIsrc\fP で始まるオブジェクトから \fIn\fP
  34 バイトを、 \fIdest\fP で指されるオブジェクトにコピーする。 ただし \fIdest\fP の値を返すのではなく、
  35 最後に書き込まれたバイトの後に続くバイトへのポインタを返す。
  36 .PP
  37 この関数はいくつかのオブジェクトが 連続的なメモリの場所にコピーされるような状況で役に立つ。
  38 .PP
  39 \fBwmempcpy\fP()  関数はこの関数と同じであるが、 \fIwchar_t\fP 型の引き数をとり、 \fIn\fP ワイド文字列をコピーする。
  40 .SH 返り値
  41 \fIdest\fP + \fIn\fP.
  42 .SH バージョン
  43 \fBmempcpy\fP()  は glibc バージョン 2.1 で初めて登場した。
  44 .SH 準拠
  45 この関数は GNU による拡張である。
  46 .SH 例
  47 .nf
  48 void *
  49 combine (void *o1, size_t s1, void *o2, size_t s2)
  50 {
  51     void *result = malloc(s1 + s2);
  52     if (result != NULL)
  53         mempcpy(mempcpy(result, o1, s1), o2, s2);
  54     return result;
  55 .fi
  56 .SH 関連項目
  57 \fBmemccpy\fP(3), \fBmemcpy\fP(3), \fBmemmove\fP(3), \fBwmemcpy\fP(3)
  58 .SH この文書について
  59 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部
  60 である。プロジェクトの説明とバグ報告に関する情報は
  61 http://www.kernel.org/doc/man\-pages/ に書かれている。