lib/freadahead.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 3 of the License, or
   7    (at your option) 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
  15    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  16
  17 #include <stddef.h>
  18 #include <stdio.h>
  19
  20 #ifdef __cplusplus
  21 extern "C" {
  22 #endif
  23
  24 /* Assuming the stream STREAM is open for reading:
  25    Return the number of bytes waiting in the input buffer of STREAM.
  26
  27    If this number is 0 and the stream is not currently writing,
  28    fflush (STREAM) is known to be a no-op.
  29
  30    STREAM must not be wide-character oriented.  */
  31
  32 extern size_t freadahead (FILE *stream);
  33
  34 #ifdef __cplusplus
  35 }
  36 #endif