Texas Instruments TI-89 - Fgetc

564
Appendix A: System Routines — Files
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
FGetC
Declaration:
WORD
FGetC
(FILES *
fsPtr
)
Category(ies):
Files
Description:
Read a BYTE from an open file (may be in either READ or WRITE mode)
and return the BYTE or FS_EOF if the end of file was reached.
Inputs:
fsPtr
— Pointer to FILES structure previously opened with
FOpen
.
Outputs:
Next BYTE in file or FS_EOF if reached end of file.
Assumptions:
The FILES structure pointed to by
fsPtr
must have been opened with
FOpen
.
Side Effects:
None
Availability:
On AMS 2.00 and higher.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: FOpen, FRead, FSetPos
Example:
FILE f1;
if (FS_OK == FOpen("APPDATA", &f1, FM_READ, "APP1" )) {
while (!FEof(&f1)) {
c = FGetC(&f1);
WinChar( w, c );
}
}