Skip to content
Permalink
master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

fmem/README.md

Go to file
 
 
Cannot retrieve contributors at this time
fmem Rationale
23 lines (14 sloc) 1.22 KB
Raw Blame
Open in GitHub Desktop

fmem

Unix Build Status Windows Build Status

A cross-platform library for opening memory-backed libc streams.

This library was written for Criterion to implement stringification functions for user-defined types.

Rationale

C doesn't define any way to open "virtual" streams that write to memory rather than a real file. A lot of libc implementations roll their own nonstandard mechanisms to achieve this, namely open_memstream, or fmemopen. Other implementations provide more generic functions to call users functions for various operations on the file, like funopen or fopencookie. Finally, some implementations support none of these nonstandard functions.

fmem tries in sequence the following implementations:

  • open_memstream.
  • fopencookie, with growing dynamic buffer.
  • funopen, with growing dynamic buffer.
  • WinAPI temporary memory-backed file.

When no other mean is available, fmem falls back to tmpfile().