https://github.com/snaipe/fmem

A cross-platform library for opening memory-backed libc streams.
https://github.com/snaipe/fmem

Last synced: 2 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/snaipe/fmem
• Owner: Snaipe
• License: mit
• Created: 2017-05-21T20:41:27.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2023-11-11T08:00:28.000Z (about 1 year ago)
• Last Synced: 2024-10-31T11:45:18.470Z (2 months ago)
• Language: C
• Homepage:
• Size: 15.6 KB
• Stars: 63
• Watchers: 5
• Forks: 23
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# fmem

[![Unix Build Status](https://img.shields.io/travis/Snaipe/fmem/master.svg?label=linux)](https://travis-ci.org/Snaipe/fmem) 

[![Windows Build Status](https://img.shields.io/appveyor/ci/Snaipe/fmem/master.svg?label=windows)](https://ci.appveyor.com/project/Snaipe/fmem/branch/master)

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

This library was written for [Criterion][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()`.

[criterion]: https://github.com/Snaipe/Criterion