extern cflh_t cfl_read

(const char* INPUT_FILE_NAME )

Allocates a new cfl handle and initializes it with a file.

Documentation

Allocates a new cfl handle and initializes it with a file. Creates a new cfl handle data structure. Open the file INPUT_FILE_NAME to read it and initializes the new handle with the file's content. The file must be of internal CFL format (please read documentation for more details).
Parameters:
INPUT_FILE_NAME - The name of the configuration file to read
Returns:
the new handle in case of success.
NULL in case of failure. WARNING: . this function is *NOT* reentrant, so you should lock a mutex before calling it and unlock the mutex after the call. . this function is *OBSOLETE* because it does not provide a way to know the error cause (it could be a memory allocation error, an impossibility to open the file, or an incorrect file format).
Preconditions:
nothing
See Also:
cfl_alloc()
cfl_free()
cfl_init_from_file()
cfl_write()
cfl_write_xml()

Alphabetic index


f