.\" Copyright 2005 walter harms (walter.harms@informatik.uni-oldenburg.de),
.\" and Copyright 2005 Michael Kerrisk <mtk.manpages@gmail.com>
.\" Distributed under the GPL.
.\"
.\" Japanese Version Copyright (c) 2005, 2006 Akihiro MOTOKI
.\"                     all rights reserved.
.\" Translated 2005-12-26, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
.\" Updated 2006-01-20, Akihiro MOTOKI
.\" Updated 2006-07-20, Akihiro MOTOKI
.\"
.TH FMEMOPEN 3 2005-12-08 "GNU" "Linux Programmer's Manual"
.SH ̾
fmemopen, open_memstream \-  򥹥ȥ꡼Ȥƥץ󤹤
.SH 
.B #define _GNU_SOURCE
.br
.B #include <stdio.h>
.sp
.BI "FILE *fmemopen(void *"buf ", size_t "size ","
.BI "const char *" mode ");"
.sp
.BI "FILE *open_memstream(char **" ptr ", size_t *" sizeloc );
.SH 
.BR fmemopen ()
ؿϡȥ꡼򥪡ץ󤷡Υȥ꡼
.I mode
ǻꤵ줿Ĥꤹ롣
Υȥ꡼ϡ
.I buf
ǻꤵ줿ʸ󡢤ĤޤХåեȤɤ߽񤭤Ǥ롣
ΥХåեϾʤȤ
.I size
ХȤĹǤʤФʤʤ
.PP

.I mode

.BR fopen (3)
ξƱǤ롣
.I mode
ɵ⡼ (append mode) ꤵ줿硢ե֤νͤ
Хåեκǽ NULL Х ('\\0') ΰ֤ꤵ롣
ʳξϡե֤νͤϥХåեƬˤʤ롣
.PP
񤭹Ѥ˥ץ󤵤줿ȥ꡼եå
.RB ( fflush (3))
䥯
.RB ( fclose (3))
ˡ
(Хåե˶) NULL ХȤХåե˽񤭹ޤ롣
Τ褦ˤ뤿ˤϡƤӽФ
Хåե 1Х;͵
.RI ( size
ˤ 1ХȤޤ᤿ͤꤹ) ɬפ롣

Хåե
.I size
ХȤꤿ񤭹⤦Ȥˤϡ顼Ȥʤ롣
(ǥեȤǤϡΤ褦ʥ顼
.I stdio
Хåեեå夵줿ˤʤ
.I setbuf(fp,\ NULL)
ȤäƥХåե󥰤̵ˤˡϡ
ԤäȤ˥顼򸡽ФΤΩġ
̤ˡȤƤϡ
.IR "setbuffer(fp, buf, size)"
ȤäơƤӽФ¦Ū
stdio ȥ꡼ХåեȤ
.I buf
ꤷХåեλ˥ХåեΥ
stdio ˶ˡ롣)
.\" See http://sourceware.org/bugzilla/show_bug.cgi?id=1995
.\" and
.\" http://sources.redhat.com/ml/libc-alpha/2006-04/msg00064.html
.PP
ɤ߽ФѤ˥ץ󤵤줿ȥ꡼Ǥϡ
Хåե NULL Х ('\\0') äƤ
ɤ߽Фե (end-of-file) ֤ȤϤʤ
Хåեɤ߽Фǥե֤Τϡ
եݥ󥿤ХåեƬ
.I size
ХȤۤ˿ʤ⤦ȤǤ롣
.PP
.I buf
 NULL ꤵ줿硢
.BR fmemopen ()
ưŪ
.I size
ХȤĹΥХåեݤ롣
ˡϡХåե˥ǡν񤭹ߤԤäƤ顢
Ƥɤ߽Ф褦ʥץꥱͭѤǤ롣
ΥХåեϥȥ꡼बȤ˼ưŪ˲롣
ƤӽФϤδؿƤХåեؤΥݥͤ
Τˡ¸ߤʤ (
.BR open_memstream ()
⻲)

.BR open_memstream ()
ϡХåեؤν񤭹Ѥ˥ȥ꡼򥪡ץ󤹤롣
Хåե
.RB ( malloc (3)
Ȥä) ưŪ˳Ƥ졢ɬפ˱ƼưŪ˿Ĺ롣
ȥ꡼򥯥ǡɤ߽ФϤΥХåե
.BR free (3)
٤Ǥ롣

Υȥ꡼ब

.RB ( fclose (3))
줿եå
.RB ( fflush (3))
줿ˡ
.I ptr

.I sizeloc
ͤϤ줾ХåեؤΥݥ󥿤ȤΥ˹롣
ͤϡƤӽФΥȥ꡼˿ʽ񤭹ߤ
Ԥʤ˸¤ͭǤ롣
ȥ꡼˽񤭹ߤԤäݤˤϡѿ򻲾Ȥ
ȥ꡼٥եå夷ʤФʤʤ

Хåե NULL ХȤݻ롣
 NULL ХȤ
.I sizeloc
˳Ǽ륵ˤϡִޤޤʤס
.\"
.\" FIXME . glibc info ˤϰʲΤ褦ʵҤ뤬ʤ褦:
.\" http://sourceware.org/bugzilla/show_bug.cgi?id=1996
.\" ȥ꡼Υե֤
.\" .BR fseek (3)
.\" or
.\" .BR fseeko (3)
.\" ѹǤ롣
.\" Ǥ˥ǡ񤭹ޤ줿ΰ˥ե֤
.\" ưȡδ֤ΰ 0 롣
.SH ֤
ƽλˤϡ
.BR fmemopen ()

.BR open_memstream ()

.I FILE
ݥ󥿤֤
Ԥϡ NULL ֤ѿ
.I errno
˥顼򼨤ͤ򥻥åȤ롣
.SH 
δؿ GNU ĥǤ롣
.\" Jan 06:  POSIX/PASC/IEEE ˤɸಽԤ褦Ǥ롣
.SH 
Υץ
.BR fmemopen ()
ȤäƽϥХåե򥪡ץ󤷡
.BR open_memstream ()
ȤäưŪ˥ѲϥХåե򥪡ץ󤷤Ƥ롣
(ץ쥳ޥɥ饤ä) ʸ
󤷤ɤ߹ߡϥХåե˽񤭽Ф
Υץμ¹ϰʲΤ褦ˤʤ롣
.nf

$ ./a.out "1 23 43"
size=11; ptr=1 529 1849

#define _GNU_SOURCE
#include <assert.h>
#include <string.h>
#include <stdio.h>
#include <stdlib.h>

#define handle_error(msg) \\
    do { perror(msg); exit(EXIT_FAILURE); } while (0)

int
main(int argc, char *argv[])
{
    FILE *out, *in;
    int v, s;
    size_t size;
    char *ptr;

    assert(argc == 2);

    in = fmemopen(argv[1], strlen(argv[1]), "r");
    if (in == NULL)
        handle_error("fmemopen");

    out = open_memstream(&ptr, &size);
    if (out == NULL)
        handle_error("fmemopen");

    for (;;) {
        s = fscanf(in, "%d", &v);
        if (s <= 0)
            break;

        s = fprintf(out, "%d ", v * v);
        if (s == \-1)
            handle_error("fprintf");
    }
    fclose(in);
    fclose(out);
    printf("size=%ld; ptr=%s\\n", (long) size, ptr);
    free(ptr);
    exit(EXIT_SUCCESS);
}
.fi
.SH Ϣ
.BR fopen (3),
.BR feature_test_macros (7)