annotate docs/ccguide/feof.refentry @ 3250:13737f3608e6

Updated Level 1 VTIO and CoVDG for updates to do CoCoVGA. Updated Level 1 CoCo1 area makefile's to produce binaries and disk images needed for the CoCoVGA video output.
author David Ladd <drencor-xeen@users.sourceforge.net>
date Wed, 28 Mar 2018 21:20:31 -0500
parents c0da1728ed5b
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
466
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
1 <refentry id="feof">
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
2 <refnamediv>
570
253b6096ee01 All function prototypes are added.
roug
parents: 542
diff changeset
3 <refname>Feof</refname>
253b6096ee01 All function prototypes are added.
roug
parents: 542
diff changeset
4 <refname>Ferror</refname>
253b6096ee01 All function prototypes are added.
roug
parents: 542
diff changeset
5 <refname>Clearerr</refname>
253b6096ee01 All function prototypes are added.
roug
parents: 542
diff changeset
6 <refname>Fileno</refname>
253b6096ee01 All function prototypes are added.
roug
parents: 542
diff changeset
7 <refpurpose>return status information of files</refpurpose>
466
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
8 </refnamediv>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
9
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
10 <refsynopsisdiv>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
11 <funcsynopsis>
468
60b821f18853 A little here and there.
roug
parents: 466
diff changeset
12 <funcsynopsisinfo>
60b821f18853 A little here and there.
roug
parents: 466
diff changeset
13 #include &lt;stdio.h&gt;
60b821f18853 A little here and there.
roug
parents: 466
diff changeset
14 </funcsynopsisinfo>
466
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
15 <funcprototype>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
16 <funcdef><function>feof</function></funcdef>
570
253b6096ee01 All function prototypes are added.
roug
parents: 542
diff changeset
17 <paramdef>FILE *<parameter>fp</parameter></paramdef>
253b6096ee01 All function prototypes are added.
roug
parents: 542
diff changeset
18 </funcprototype>
253b6096ee01 All function prototypes are added.
roug
parents: 542
diff changeset
19
253b6096ee01 All function prototypes are added.
roug
parents: 542
diff changeset
20 <funcprototype>
253b6096ee01 All function prototypes are added.
roug
parents: 542
diff changeset
21 <funcdef><function>ferror</function></funcdef>
253b6096ee01 All function prototypes are added.
roug
parents: 542
diff changeset
22 <paramdef>FILE *<parameter>fp</parameter></paramdef>
253b6096ee01 All function prototypes are added.
roug
parents: 542
diff changeset
23 </funcprototype>
253b6096ee01 All function prototypes are added.
roug
parents: 542
diff changeset
24
253b6096ee01 All function prototypes are added.
roug
parents: 542
diff changeset
25 <funcprototype>
253b6096ee01 All function prototypes are added.
roug
parents: 542
diff changeset
26 <funcdef><function>clearerr</function></funcdef>
253b6096ee01 All function prototypes are added.
roug
parents: 542
diff changeset
27 <paramdef>FILE *<parameter>fp</parameter></paramdef>
253b6096ee01 All function prototypes are added.
roug
parents: 542
diff changeset
28 </funcprototype>
253b6096ee01 All function prototypes are added.
roug
parents: 542
diff changeset
29
253b6096ee01 All function prototypes are added.
roug
parents: 542
diff changeset
30 <funcprototype>
253b6096ee01 All function prototypes are added.
roug
parents: 542
diff changeset
31 <funcdef><function>fileno</function></funcdef>
253b6096ee01 All function prototypes are added.
roug
parents: 542
diff changeset
32 <paramdef>FILE *<parameter>fp</parameter></paramdef>
466
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
33 </funcprototype>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
34 </funcsynopsis>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
35
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
36 </refsynopsisdiv>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
37
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
38 <refsect1><title>Description</title>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
39 <para>
594
c0da1728ed5b All refentries finished.
roug
parents: 570
diff changeset
40 Feof returns non-zero if the file associated with "fp" has
c0da1728ed5b All refentries finished.
roug
parents: 570
diff changeset
41 reached its end. Zero is returned on error.
c0da1728ed5b All refentries finished.
roug
parents: 570
diff changeset
42 </para>
c0da1728ed5b All refentries finished.
roug
parents: 570
diff changeset
43 <para>
c0da1728ed5b All refentries finished.
roug
parents: 570
diff changeset
44 Ferror returns non-zero if an error condition occurs on access
c0da1728ed5b All refentries finished.
roug
parents: 570
diff changeset
45 to the file "fp"; zero is returned otherwise. The error
c0da1728ed5b All refentries finished.
roug
parents: 570
diff changeset
46 condition persists, preventing further access to the file by
c0da1728ed5b All refentries finished.
roug
parents: 570
diff changeset
47 other Standard Library functions, until the file is closed,
c0da1728ed5b All refentries finished.
roug
parents: 570
diff changeset
48 or it is cleared by clearerr.
c0da1728ed5b All refentries finished.
roug
parents: 570
diff changeset
49 </para>
c0da1728ed5b All refentries finished.
roug
parents: 570
diff changeset
50 <para>
c0da1728ed5b All refentries finished.
roug
parents: 570
diff changeset
51 Clearerr resets the error condition on the file "fp". This
c0da1728ed5b All refentries finished.
roug
parents: 570
diff changeset
52 does NOT "fix" the file or prevent the error from occurring
c0da1728ed5b All refentries finished.
roug
parents: 570
diff changeset
53 again; it merely allows Standard Library functions at least to
c0da1728ed5b All refentries finished.
roug
parents: 570
diff changeset
54 try.
c0da1728ed5b All refentries finished.
roug
parents: 570
diff changeset
55 </para>
c0da1728ed5b All refentries finished.
roug
parents: 570
diff changeset
56 </refsect1>
c0da1728ed5b All refentries finished.
roug
parents: 570
diff changeset
57
c0da1728ed5b All refentries finished.
roug
parents: 570
diff changeset
58 <refsect1><title>Caveats</title>
c0da1728ed5b All refentries finished.
roug
parents: 570
diff changeset
59 <para>
c0da1728ed5b All refentries finished.
roug
parents: 570
diff changeset
60 These functions are actually macros that are defined in
c0da1728ed5b All refentries finished.
roug
parents: 570
diff changeset
61 "&lt;stdio.h&gt;" so their names cannot be redeclared.
466
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
62 </para>
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
63 </refsect1>
542
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
64
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
65 <refsect1><title>See Also</title>
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
66 <para>
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
67 System call
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
68 <link linkend="open">open()</link>,
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
69 <link linkend="fopen">fopen()</link>.
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
70 </para>
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
71 </refsect1>
73319ee6a57e All "See Also" implemented
roug
parents: 468
diff changeset
72
466
bea58398bb15 Skeletons for the C Compiler User's Guide, 1983
roug
parents:
diff changeset
73 </refentry>