source: mainline/uspace/lib/posix/stdio.h@ 4cf8ca6

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since 4cf8ca6 was 4cf8ca6, checked in by Petr Koupy <petr.koupy@…>, 14 years ago

Various minor commenting (no change in functionality).

  • Property mode set to 100644
File size: 5.7 KB
Line 
1/*
2 * Copyright (c) 2011 Jiri Zarevucky
3 * Copyright (c) 2011 Petr Koupy
4 * All rights reserved.
5 *
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
8 * are met:
9 *
10 * - Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * - Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 * - The name of the author may not be used to endorse or promote products
16 * derived from this software without specific prior written permission.
17 *
18 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
19 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
20 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
21 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
22 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
23 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28 */
29
30/** @addtogroup libposix
31 * @{
32 */
33/** @file Standard buffered input/output.
34 */
35
36#ifndef POSIX_STDIO_H_
37#define POSIX_STDIO_H_
38
39#include "libc/stdio.h"
40#include "sys/types.h"
41#include "libc/stdarg.h"
42#include "limits.h"
43
44/* Identifying the Terminal */
45#undef L_ctermid
46#define L_ctermid PATH_MAX
47extern char *posix_ctermid(char *s);
48
49/* Error Recovery */
50extern void posix_clearerr(FILE *stream);
51
52/* Input/Output */
53#undef putc
54#define putc fputc
55extern int posix_fputs(const char *restrict s, FILE *restrict stream);
56#undef getc
57#define getc fgetc
58extern int posix_ungetc(int c, FILE *stream);
59extern ssize_t posix_getdelim(char **restrict lineptr, size_t *restrict n,
60 int delimiter, FILE *restrict stream);
61extern ssize_t posix_getline(char **restrict lineptr, size_t *restrict n,
62 FILE *restrict stream);
63
64/* Opening Streams */
65extern FILE *posix_freopen(const char *restrict filename,
66 const char *restrict mode, FILE *restrict stream);
67extern FILE *posix_fmemopen(void *restrict buf, size_t size,
68 const char *restrict mode);
69extern FILE *posix_open_memstream(char **bufp, size_t *sizep);
70
71/* Error Messages */
72extern void posix_perror(const char *s);
73
74/* File Positioning */
75typedef struct _posix_fpos posix_fpos_t;
76extern int posix_fsetpos(FILE *stream, const posix_fpos_t *pos);
77extern int posix_fgetpos(FILE *restrict stream, posix_fpos_t *restrict pos);
78extern int posix_fseek(FILE *stream, long offset, int whence);
79extern int posix_fseeko(FILE *stream, posix_off_t offset, int whence);
80extern long posix_ftell(FILE *stream);
81extern posix_off_t posix_ftello(FILE *stream);
82
83/* Flushing Buffers */
84extern int posix_fflush(FILE *stream);
85
86/* Formatted Output */
87extern int posix_dprintf(int fildes, const char *restrict format, ...)
88 PRINTF_ATTRIBUTE(2, 3);
89extern int posix_vdprintf(int fildes, const char *restrict format, va_list ap);
90extern int posix_sprintf(char *restrict s, const char *restrict format, ...)
91 PRINTF_ATTRIBUTE(2, 3);
92extern int posix_vsprintf(char *restrict s, const char *restrict format, va_list ap);
93
94/* Formatted Input */
95extern int posix_fscanf(
96 FILE *restrict stream, const char *restrict format, ...);
97extern int posix_vfscanf(
98 FILE *restrict stream, const char *restrict format, va_list arg);
99extern int posix_scanf(const char *restrict format, ...);
100extern int posix_vscanf(const char *restrict format, va_list arg);
101extern int posix_sscanf(
102 const char *restrict s, const char *restrict format, ...);
103extern int posix_vsscanf(
104 const char *restrict s, const char *restrict format, va_list arg);
105
106/* File Locking */
107extern void posix_flockfile(FILE *file);
108extern int posix_ftrylockfile(FILE *file);
109extern void posix_funlockfile(FILE *file);
110extern int posix_getc_unlocked(FILE *stream);
111extern int posix_getchar_unlocked(void);
112extern int posix_putc_unlocked(int c, FILE *stream);
113extern int posix_putchar_unlocked(int c);
114
115/* Deleting Files */
116extern int posix_remove(const char *path);
117
118/* Temporary Files */
119#undef L_tmpnam
120#define L_tmpnam PATH_MAX
121extern char *posix_tmpnam(char *s);
122
123#ifndef LIBPOSIX_INTERNAL
124 #define ctermid posix_ctermid
125
126 #define clearerr posix_clearerr
127
128 #define fputs posix_fputs
129 #define ungetc posix_ungetc
130 #define getdelim posix_getdelim
131 #define getline posix_getline
132
133 #define freopen posix_freopen
134 #define fmemopen posix_fmemopen
135 #define open_memstream posix_open_memstream
136
137 #define perror posix_perror
138
139 #define fpos_t posix_fpos_t
140 #define fsetpos posix_fsetpos
141 #define fgetpos posix_fgetpos
142 #define fseek posix_fseek
143 #define fseeko posix_fseeko
144 #define ftell posix_ftell
145 #define ftello posix_ftello
146
147 #define fflush posix_fflush
148
149 #define dprintf posix_dprintf
150 #define vdprintf posix_vdprintf
151 #define sprintf posix_sprintf
152 #define vsprintf posix_vsprintf
153
154 #define fscanf posix_fscanf
155 #define vfscanf posix_vfscanf
156 #define vscanf posix_vscanf
157 #define scanf posix_scanf
158 #define sscanf posix_sscanf
159 #define vsscanf posix_vsscanf
160
161 #define flockfile posix_flockfile
162 #define ftrylockfile posix_ftrylockfile
163 #define funlockfile posix_funlockfile
164
165 #define getc_unlocked posix_getc_unlocked
166 #define getchar_unlocked posix_getchar_unlocked
167 #define putc_unlocked posix_putc_unlocked
168 #define putchar_unlocked posix_putchar_unlocked
169
170 #define remove posix_remove
171
172 #define tmpnam posix_tmpnam
173#endif
174
175#endif /* POSIX_STDIO_H_ */
176
177/** @}
178 */
Note: See TracBrowser for help on using the repository browser.