summaryrefslogtreecommitdiff
path: root/reference/C/MAN/gets.htm
diff options
context:
space:
mode:
authorTobias Klauser <tklauser@distanz.ch>2008-01-27 11:37:44 +0100
committerTobias Klauser <tklauser@xenon.tklauser.home>2008-01-27 11:37:44 +0100
commit7e0f021a9aec35fd8e6725e87e3313b101d26f5e (patch)
treeb1cacc4b24393f517aeb4610e9e1021f954307a8 /reference/C/MAN/gets.htm
Initial import (2.0.2-6)2.0.2-6
Diffstat (limited to 'reference/C/MAN/gets.htm')
-rw-r--r--reference/C/MAN/gets.htm169
1 files changed, 169 insertions, 0 deletions
diff --git a/reference/C/MAN/gets.htm b/reference/C/MAN/gets.htm
new file mode 100644
index 0000000..54a79a5
--- /dev/null
+++ b/reference/C/MAN/gets.htm
@@ -0,0 +1,169 @@
+<TITLE>ungetc</TITLE>
+<body bgcolor="#ffffcc">
+<hr>
+<pre>
+
+
+
+<h3>GETS(3) Linux Programmer's Manual GETS(3)
+</h3>
+
+<h3>NAME
+</h3> fgetc, fgets, getc, getchar, gets, ungetc - input of char-
+ acters and strings
+
+<h3>SYNOPSIS
+</h3> #include &lt;stdio.h&gt;
+
+ int fgetc(FILE *stream);
+ char *fgets(char *s, int size, FILE *stream);
+ int getc(FILE *stream);
+ int getchar(void);
+ char *gets(char *s);
+ int ungetc(int c, FILE *stream);
+
+<h3>DESCRIPTION
+</h3> fgetc() reads the next character from stream and returns
+ it as an unsigned char cast to an int, or EOF on end of
+ file or error.
+
+ getc() is equivalent to fgetc() except that it may be
+ implemented as a macro which evaluates stream more than
+ once.
+
+ getchar() is equivalent to getc(stdin).
+
+ gets() reads a line from stdin into the buffer pointed to
+ by s until either a terminating newline or EOF, which it
+ replaces with '\0'. No check for buffer overrun is per-
+ formed (see BUGS below).
+
+ fgets() reads in at most one less than n characters from
+ stream and stores them into the buffer pointed to by s.
+ Reading stops after an EOF or a newline. If a newline is
+ read, it is stored into the buffer. A '\0' is stored
+ after the last character in the buffer.
+
+ ungetc() pushes c back to stream, cast to unsigned char,
+ where it is available for subsequent read operations.
+ Pushed - back characters will be returned in reverse
+ order; only one pushback is guaranteed.
+
+ Calls to the functions described here can be mixed with
+ each other and with calls to other input functions from
+ the stdio library for the same input stream.
+
+<h3>RETURN VALUES
+</h3> fgetc(), getc() and getchar() return the character read as
+ an unsigned char cast to an int or EOF on end of file or
+ error.
+
+ gets() and fgets() return s on success, and NULL on end of
+ file or error.
+
+ ungetc() returns c on success, or EOF on error.
+
+
+
+<h3>GNU April 4, 1993 1
+</h3>
+
+
+
+
+<h3>GETS(3) Linux Programmer's Manual GETS(3)
+</h3>
+
+<h3>CONFORMS TO
+</h3> ANSI - C, POSIX.1
+
+<h3>BUGS
+</h3> Because it is impossible to tell without knowing the data
+ in advance how many characters gets() will read, and
+ because gets() will continue to store characters past the
+ end of the buffer, it is extremely dangerous to use. It
+ has been used to break computer security. Use fgets()
+ instead.
+
+ It is not advisable to mix calls to input functions from
+ the stdio library with low - level calls to read() for the
+ file descriptor associated with the input stream; the
+ results will be undefined and very probably not what you
+ want.
+
+</pre>
+<hr>
+<h3>SEE ALSO
+</h3><p>
+<a href=read.htm>read</a>,
+<a href=write.htm>write</a>,
+<a href=fopen.htm>fopen</a>,
+<a href=fread.htm>fread</a>,
+<a href=scanf.htm>scanf</a>,
+<a href=puts.htm>puts</a>,
+<a href=fseek.htm>fseek</a>,
+<a href=ferror.htm>ferror</a>,
+<pre>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<h3>GNU April 4, 1993 2
+</h3>
+
+ </pre>
+<P>
+<hr>
+<p>
+<center>
+<table border=2 width=80%>
+<tr align=center>
+<td width=25%>
+<a href=../cref.html>Top</a>
+</td><td width=25%>
+<a href=../master_index.html>Master Index</a>
+</td><td width=25%>
+<a href=../SYNTAX/keywords.html>Keywords</a>
+</td><td width=25%>
+<a href=../FUNCTIONS/funcref.htm>Functions</a>
+</td>
+</tr>
+</table>
+</center>
+<p>
+<hr>
+
+This manual page was brought to you by <i>mjl_man V-2.0</i>