1 /* Output stream that accumulates the output in memory. 2 Copyright (C) 2006, 2019 Free Software Foundation, Inc. 3 Written by Bruno Haible <bruno@clisp.org>, 2006. 4 5 This program is free software: you can redistribute it and/or modify 6 it under the terms of the GNU General Public License as published by 7 the Free Software Foundation; either version 3 of the License, or 8 (at your option) any later version. 9 10 This program is distributed in the hope that it will be useful, 11 but WITHOUT ANY WARRANTY; without even the implied warranty of 12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 13 GNU General Public License for more details. 14 15 You should have received a copy of the GNU General Public License 16 along with this program. If not, see <https://www.gnu.org/licenses/>. */ 17 18 #ifndef _MEMORY_OSTREAM_H 19 #define _MEMORY_OSTREAM_H 20 21 #include <stddef.h> 22 23 #include "ostream.h" 24 25 struct memory_ostream : struct ostream 26 { 27 methods: 28 /* Return a pointer to the output accumulated so far and its size: 29 Store them in *BUFP and *BUFLENP. 30 Note: These two return values become invalid when more output is done to 31 the stream or when the stream is freed. */ 32 void contents (memory_ostream_t stream, const void **bufp, size_t *buflenp); 33 }; 34 35 #ifdef __cplusplus 36 extern "C" { 37 #endif 38 39 40 /* Create an output stream that accumulates the output in a memory buffer. */ 41 extern memory_ostream_t memory_ostream_create (void); 42 43 44 #ifdef __cplusplus 45 } 46 #endif 47 48 #endif /* _MEMORY_OSTREAM_H */ 49