New module 'freadable'.
[gnulib.git] / lib / freadable.h
1 /* Retrieve information about a FILE stream.
2    Copyright (C) 2007 Free Software Foundation, Inc.
3
4    This program is free software; you can redistribute it and/or modify
5    it under the terms of the GNU General Public License as published by
6    the Free Software Foundation; either version 2, or (at your option)
7    any later version.
8
9    This program is distributed in the hope that it will be useful,
10    but WITHOUT ANY WARRANTY; without even the implied warranty of
11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12    GNU General Public License for more details.
13
14    You should have received a copy of the GNU General Public License along
15    with this program; if not, write to the Free Software Foundation,
16    Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.  */
17
18 #include <stdbool.h>
19 #include <stdio.h>
20
21 /* Return true if the stream STREAM supports reading, false if it supports
22    only writing, i.e. if it was opened write-only or append-only.
23    STREAM must not be wide-character oriented.
24    The result doesn't change until the stream is closed or re-opened.  */
25
26 #if HAVE___FREADABLE /* glibc >= 2.2, Solaris >= 7 */
27
28 # include <stdio_ext.h>
29 # define freadable(stream) (__freadable (stream) != 0)
30
31 #else
32
33 # ifdef __cplusplus
34 extern "C" {
35 # endif
36
37 extern bool freadable (FILE *stream);
38
39 # ifdef __cplusplus
40 }
41 # endif
42
43 #endif