File Handling

The utility library provides some functions for working with files. These functions are helpful with file handling:

TutFileTraverse — traverses all open files. Uses this function typedef:

typedef T_PTR (*T_FILE_TRAV_FUNC) (T_FILE file, T_PTR arg);

where file refers to the open file being visited, and arg is the user-specified traversal argument.

TutFOpen — opens a file in a standard way.

TutSetFileCloseFunc — specifies a function used to close a file. The close function is defined as:T_BOOL (*T_FILE_CLOSE_FUNC) (FILE *file);

where file is the file being closed.

TutSetFileOpenFunc — specifies a function used to open a file. The open function is defined as:

FILE *(*T_FILE_OPEN_FUNC) (T_STRfile_name, T_STR file_mode);

where file_name specifies the file to be opened, and file_mode specifies the mode to be used to open the file.

TutSetFileReadFunc — specifies a function used to read from a file. The read function is defined as:

T_INT4 (*T_FILE_READ_FUNC) (T_PTRbuff, T_UINT4 size, FILE *file);

where buff specifies where data is to be placed, size specifies the number of bytes to be read, and file refers to the file being read.