1/* Multibyte and wide printf buffers writing data to a FILE * stream.
2 Copyright (C) 2022-2024 Free Software Foundation, Inc.
3 This file is part of the GNU C Library.
4
5 The GNU C Library is free software; you can redistribute it and/or
6 modify it under the terms of the GNU Lesser General Public
7 License as published by the Free Software Foundation; either
8 version 2.1 of the License, or (at your option) any later version.
9
10 The GNU C Library 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 GNU
13 Lesser General Public License for more details.
14
15 You should have received a copy of the GNU Lesser General Public
16 License along with the GNU C Library; if not, see
17 <https://www.gnu.org/licenses/>. */
18
19#ifndef PRINTF_BUFFER_TO_FILE_H
20#define PRINTF_BUFFER_TO_FILE_H
21
22#include <bits/types/FILE.h>
23#include <printf_buffer.h>
24
25struct __printf_buffer_to_file
26{
27 struct __printf_buffer base;
28 FILE *fp;
29
30 /* Staging buffer. Used if fp does not have any available buffer
31 space. */
32 char stage[PRINTF_BUFFER_SIZE_TO_FILE_STAGE];
33};
34
35/* Initializes *BUF to write data to FP. */
36void __printf_buffer_to_file_init (struct __printf_buffer_to_file *buf,
37 FILE *fp) attribute_hidden;
38
39/* Transfers any pending data in BUF to BUF->FP. The return value
40 follows the printf convention (number bytes written; or -1 for error). */
41int __printf_buffer_to_file_done (struct __printf_buffer_to_file *buf)
42 attribute_hidden;
43
44/* Wide version below. */
45
46struct __wprintf_buffer_to_file
47{
48 struct __wprintf_buffer base;
49 FILE *fp;
50 wchar_t stage[PRINTF_BUFFER_SIZE_TO_FILE_STAGE];
51};
52void __wprintf_buffer_to_file_init (struct __wprintf_buffer_to_file *buf,
53 FILE *fp) attribute_hidden;
54int __wprintf_buffer_to_file_done (struct __wprintf_buffer_to_file *buf)
55 attribute_hidden;
56
57#endif /* PRINTF_BUFFER_TO_FILE_H */
58

source code of glibc/stdio-common/printf_buffer_to_file.h