Faccess - Texas Instruments TI-89 Developer's Manual

Appendix A: System Routines — Files

FAccess

Declaration: WORD FAccess (char * fileName , WORD mode , char * typeName )
Category(ies): Files
Description: Check to see if a file can be opened for a given mode without modifying the
file. The file, if it exists, must have the same type as typeName .
fileName
Inputs:
mode
typeName
Outputs: FS_OK
FS_ERROR
FS_NOT_FOUND — fileName does not exist.
FS_BAD_NAME
Assumptions: The file, if it exists, must have the same type as typeName.
Side Effects: None
Availability: On AMS 2.00 and higher.
TI-89 / TI-92 Plus
Differences: None
See Also: FOpen, FCreate
Example:
if (FS_ERROR == FAccess("ZTEMP", FM_WRITE_ACCESS, "TYPE")) {
Disp("ERROR: Can not write to data file");
return;
}
TI-89 / TI-92 Plus Developer Guide
— String name of file to check.
— FM_READ_ACCESS or FM_WRITE_ACCESS.
— 1 . . . 4 character string of file type.
— The file can be opened in the given mode.
— The file cannot be opened for the specified mode
(may be locked or is not a third-party data-type).
— fileName is invalid.
Not for Distribution
557
Beta Version January 26, 2001