release/man3/mempcpy.3

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