(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