diff options
Diffstat (limited to 'man3/getw.3')
-rw-r--r-- | man3/getw.3 | 55 |
1 files changed, 55 insertions, 0 deletions
diff --git a/man3/getw.3 b/man3/getw.3 new file mode 100644 index 000000000..cda186812 --- /dev/null +++ b/man3/getw.3 @@ -0,0 +1,55 @@ +.\" (c) 1995 by Jim Van Zandt <jrv@vanzandt.mv.com> +.\" +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" License. +.TH GETW 3 1995-09-16 "GNU" "Linux Programmer's Manual" +.SH NAME +getw, putw \- input and output of words (ints) +.SH SYNOPSIS +.nf +.B #include <stdio.h> +.sp +.BI "int getw(FILE *" stream ); +.nl +.BI "int putw(int " w ", FILE *" stream ); +.nl +.SH DESCRIPTION +\fBgetw\fP reads a word (that is, an \fBint\fP) from \fIstream\fP. It's +provided for compatibility with SVID. We recommend you use +\fBfread\fP(3) instead. +.P +\fBputw\fP writes the word \fIw\fP (that is, an \fBint\fP) to \fIstream\fP. It +is provided for compatibility with SVID, but we recommend you use +\fBfwrite\fP(3) instead. +.SH "RETURN VALUE" +Normally, \fBgetw\fP returns the word read, and \fBputw\fP returns 0. +On error, they return \fBEOF\fP. +.SH BUGS +The value returned on error is also a legitimate data value. +\fBferror\fP(3) can be used to distinguish between the two cases. +.SH "CONFORMING TO" +SVID +.SH "SEE ALSO" +.BR ferror (3), +.BR fread (3), +.BR fwrite (3), +.BR getc (3), +.BR putc (3) |