annotate docs/ccguide/feof.refentry @ 2772:0a3f4d8ea6d5

Found ENDC in wrong location in dwread.asm and dwwrite.asm. Corrected. Moved the native 6309 code in dwread.asm and dwwrite.asm into the H6309 labeled area and changed IFEQ H6309 to IFNE H6309. Also moved the 57600bps 6809 code to the default location. This change had been done in the old dwread.asm and dwwrite.asm files to make it easier to follow. Though these two files were overwritten from the HDBDOS project dwread.asm and dwwrite.asm files. So this conversion needed to be done again so it made the source easier to follow.
author drencor-xeen
date Wed, 23 Jan 2013 12:36:55 -0600
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>