X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;f=lib%2Ffreadptr.h;h=2aa800b56d28ebf9491b3bf711390bab7c349b46;hb=6a9b156fdf9c71c0bbc8bb0b3aa0262df5674dda;hp=3620a143721dadffdb5bf1d8bbe209a91ef9c7b4;hpb=e8014c6b48c5e156b61c09cf7e5681b64c644344;p=gnulib.git diff --git a/lib/freadptr.h b/lib/freadptr.h index 3620a1437..2aa800b56 100644 --- a/lib/freadptr.h +++ b/lib/freadptr.h @@ -22,19 +22,17 @@ extern "C" { #endif /* Assuming the stream STREAM is open for reading: - Return a pointer to the input buffer of STREAM. - If freadahead (STREAM) > 0, the result is either a pointer to - freadahead (STREAM) bytes, or NULL. The latter case can happen after - use of 'ungetc (..., STREAM)'. - If freadahead (STREAM) == 0, the result is not usable; it may be NULL. - In this case, you should use getc (STREAM), fgetc (STREAM), or - fread (..., STREAM) to access the input from STREAM. + Return a pointer to the input buffer of STREAM, or NULL. + If the returned pointer is non-NULL, *SIZEP is set to the (positive) size + of the input buffer. + If the returned pointer is NULL, you should use getc (STREAM), + fgetc (STREAM), or fread (..., STREAM) to access the input from STREAM. The resulting pointer becomes invalid upon any operation on STREAM. STREAM must not be wide-character oriented. */ -extern const char * freadptr (FILE *stream); +extern const char * freadptr (FILE *stream, size_t *sizep); #ifdef __cplusplus }