X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;f=lib%2Ffreadptr.h;h=2aa800b56d28ebf9491b3bf711390bab7c349b46;hb=72b730e68b340a28fc29ed71168124d68be1f567;hp=7697970703cc6f34ce4d16bb019be23cebf081c2;hpb=56690adc74a0b9d99a9a313947cf7515ce8a40db;p=gnulib.git diff --git a/lib/freadptr.h b/lib/freadptr.h index 769797070..2aa800b56 100644 --- a/lib/freadptr.h +++ b/lib/freadptr.h @@ -22,18 +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 a pointer to freadahead (STREAM) - bytes. - 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 }