prg_tfile_parse()
Abstract
Opens, reads, and parses a regularly-structured ASCII configuration file that appears in the user's mod_dirs.
Syntax
prg_tfile_parse (filename, file_type)
| Argument | Type | Description |
|---|---|---|
filename |
const char * |
Base file name of configuration file to be read in. |
file_type |
PrgT_Tfile_Type |
Typed file type (an enumeration) of the file to be read in. |
Return Type
PrgT_File_Parse *
Pointer to a parse data structure used by the remaining functions in the file parse package.
Header
prg_file_funcs.h
Details
Opens, reads, and parses the configuration file specified by the filename argument and returns a parse data structure that can be queried. The data structure must eventually be destroyed with a call to prg_file_parse_destroy(). This function is nearly identical to prg_file_parse(), except that the filename argument specifies just a base file name (no directory is needed) and the additional type argument specifies the file type of the typed-file to be read in. The file will be searched for in the current set of models directories (mod_dirs).