Appendix A: System Routines — Files
571
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
FRead
Declaration:
WORD
FRead
(void *
buffer
, FSWORD
bytesToRead
, FILES *
fsPtr
)
Category(ies):
Files
Description:
Read
bytesToRead
BYTEs from an open file (may be in either READ or
WRITE mode) into
buffer
.
Inputs:
buffer
— Pointer to a buffer of at least
bytesToRead
bytes in
length.
bytesToRead
— Number of bytes to read.
fsPtr
— Pointer to FILES structure previously opened with
FOpen
.
Outputs:
FS_OK — File read was successful.
FS_EOF — Read past end of file.
Assumptions:
None
Side Effects:
None
Availability:
On AMS 2.00 and higher.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: FOpen, FGetC, FSetPos
Example:
WORD status;
char buf[6];
FILE f1;
if (FS_OK == FOpen("APPDATA", &f1, FM_WRITE, "APP1" )) {
status = FWrite( "1234", 4, &f1 );
FClose( &f1 );
if (FS_OK == status) {
FOpen( "APPDATA", &f1, FM_READ, "APP1");
status = FRead( buf, 3, &f1 ); /* status == FS_OK */
status = FRead( buf, 2, &f1 ); /* status == FS_EOF */
FClose( &f1 );
}
}