lib/freadable.h

   1 /* Retrieve information about a FILE stream.
   2    Copyright (C) 2007, 2009-2024 Free Software Foundation, Inc.
   3
   4    This file is free software: you can redistribute it and/or modify
   5    it under the terms of the GNU Lesser General Public License as
   6    published by the Free Software Foundation, either version 3 of the
   7    License, or (at your option) any later version.
   8
   9    This file 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 Lesser General Public License for more details.
  13
  14    You should have received a copy of the GNU Lesser General Public License
  15    along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
  16
  17 /* This file uses _GL_ATTRIBUTE_PURE, HAVE___FREADABLE, HAVE_STDIO_EXT_H.  */
  18 #if !_GL_CONFIG_H_INCLUDED
  19  #error "Please include config.h first."
  20 #endif
  21
  22 #include <stdio.h>
  23
  24 /* Return true if the stream STREAM supports reading, false if it supports
  25    only writing, i.e. if it was opened write-only or append-only.
  26    STREAM must not be wide-character oriented.
  27    The result doesn't change until the stream is closed or re-opened.  */
  28
  29 #if HAVE___FREADABLE
  30 /* glibc >= 2.2, Solaris >= 7, UnixWare >= 7.1.4.MP4, Cygwin >= 1.7.34, Android API >= 23, musl libc */
  31
  32 # if HAVE_STDIO_EXT_H
  33 #  include <stdio_ext.h>
  34 # endif
  35 # define freadable(stream) (__freadable (stream) != 0)
  36
  37 #else
  38
  39 # ifdef __cplusplus
  40 extern "C" {
  41 # endif
  42
  43 extern bool freadable (FILE *stream) _GL_ATTRIBUTE_PURE;
  44
  45 # ifdef __cplusplus
  46 }
  47 # endif
  48
  49 #endif