xmemstream.h 1.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849
  1. /* Error-checking wrappers for memstream functions.
  2. Copyright (C) 2016-2019 Free Software Foundation, Inc.
  3. This file is part of the GNU C Library.
  4. The GNU C Library is free software; you can redistribute it and/or
  5. modify it under the terms of the GNU Lesser General Public
  6. License as published by the Free Software Foundation; either
  7. version 2.1 of the License, or (at your option) any later version.
  8. The GNU C Library is distributed in the hope that it will be useful,
  9. but WITHOUT ANY WARRANTY; without even the implied warranty of
  10. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  11. Lesser General Public License for more details.
  12. You should have received a copy of the GNU Lesser General Public
  13. License along with the GNU C Library; if not, see
  14. <http://www.gnu.org/licenses/>. */
  15. #ifndef SUPPORT_XMEMSTREAM_H
  16. #define SUPPORT_XMEMSTREAM_H
  17. #include <stdio.h>
  18. #include <sys/cdefs.h>
  19. __BEGIN_DECLS
  20. /* Wrappers for other libc functions. */
  21. struct xmemstream
  22. {
  23. FILE *out;
  24. char *buffer;
  25. size_t length;
  26. };
  27. /* Create a new in-memory stream. Initializes *STREAM. After this
  28. function returns, STREAM->out is a file descriptor open for
  29. writing. errno is preserved, so that the %m format specifier can
  30. be used for writing to STREAM->out. */
  31. void xopen_memstream (struct xmemstream *stream);
  32. /* Closes STREAM->OUT. After this function returns, STREAM->buffer
  33. and STREAM->length denote a memory range which contains the bytes
  34. written to the output stream. The caller should free
  35. STREAM->buffer. */
  36. void xfclose_memstream (struct xmemstream *stream);
  37. __END_DECLS
  38. #endif /* SUPPORT_XMEMSTREAM_H */