diff options
| author | June McEnroe <june@causal.agency> | 2018-11-15 18:42:36 -0500 |
|---|---|---|
| committer | June McEnroe <june@causal.agency> | 2018-11-15 18:42:36 -0500 |
| commit | 98c8687ccffd1ec164c7f578497b6e60263ed714 (patch) | |
| tree | f179dc6d68161e7f201c1a5a3e628f22609e92ae | |
| parent | Add gzoffset.3 (diff) | |
| download | zlib-man-pages-98c8687ccffd1ec164c7f578497b6e60263ed714.tar.gz zlib-man-pages-98c8687ccffd1ec164c7f578497b6e60263ed714.zip | |
Add gzeof.3
| -rw-r--r-- | Makefile | 1 | ||||
| -rw-r--r-- | gzeof.3 | 49 |
2 files changed, 50 insertions, 0 deletions
diff --git a/Makefile b/Makefile index 14a3455..b6f4fd4 100644 --- a/Makefile +++ b/Makefile @@ -19,6 +19,7 @@ MAN += deflateSetDictionary.3 MAN += deflateSetHeader.3 MAN += deflateTune.3 MAN += gzbuffer.3 +MAN += gzeof.3 MAN += gzflush.3 MAN += gzfread.3 MAN += gzfwrite.3 diff --git a/gzeof.3 b/gzeof.3 new file mode 100644 index 0000000..638fdcb --- /dev/null +++ b/gzeof.3 @@ -0,0 +1,49 @@ +.Dd November 13, 2018 +.Dt GZEOF 3 +.Os +. +.Sh NAME +.Nm gzeof +.Nd check end-of-file indicator +. +.Sh LIBRARY +.Lb libz +. +.Sh SYNOPSIS +.In zlib.h +.Ft int +.Fn gzeof "gzFile file" +. +.Sh DESCRIPTION +Returns true (1) +if the end-of-file indicator +has been set while reading, +false (0) otherwise. +Note that the end-of-file indicator +is set only if the read +tried to go past the end of the input, +but came up short. +Therefore, +just like +.Xr feof 3 , +.Fn gzeof +may return false +even if there is no more data to read, +in the event that the last read request +was for the exact number of bytes +remaining in the input file. +This will happen if the input file size +is an exact multiple of the buffer size. +. +.Pp +If +.Fn gzeof +returns true, +then the read functions +will return no more data, +unless the end-of-file indicator +is reset by +.Xr gzclearerr 3 +and the input file +has grown since the previous +end of file was detected. |