(root)/
coreutils-9.4/
lib/
freadptr.h
       1  /* Retrieve information about a FILE stream.
       2     Copyright (C) 2007-2023 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 2.1 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 HAVE___FREADPTR.  */
      18  #if !_GL_CONFIG_H_INCLUDED
      19   #error "Please include config.h first."
      20  #endif
      21  
      22  #include <stddef.h>
      23  #include <stdio.h>
      24  
      25  /* Assuming the stream STREAM is open for reading:
      26     Return a pointer to the input buffer of STREAM, or NULL.
      27     If the returned pointer is non-NULL, *SIZEP is set to the (positive) size
      28     of the input buffer.
      29     If the returned pointer is NULL, you should use getc (STREAM),
      30     fgetc (STREAM), or fread (..., STREAM) to access the input from STREAM.
      31  
      32     The resulting pointer becomes invalid upon any operation on STREAM.
      33  
      34     STREAM must not be wide-character oriented.  */
      35  
      36  #if HAVE___FREADPTR /* musl libc */
      37  
      38  # include <stdio_ext.h>
      39  # define freadptr(stream,sizep) __freadptr (stream, sizep)
      40  
      41  #else
      42  
      43  # ifdef __cplusplus
      44  extern "C" {
      45  # endif
      46  
      47  extern const char * freadptr (FILE *stream, size_t *sizep);
      48  
      49  # ifdef __cplusplus
      50  }
      51  # endif
      52  
      53  #endif