find_datafile_object - Man Page
Searches a datafile for an object with a name. Allegro game programming library.
Synopsis
#include <allegro.h>
DATAFILE *find_datafile_object(const DATAFILE *dat, const char *objectname);
Description
Searches an already loaded datafile for an object with the specified name. In the name you can use `/' and `#' separators for nested datafile paths. Example:
char level_name[10]; DATAFILE *dat, *level; ... uszprintf(level_name, sizeof(buffer), "LEVEL_%02d", level_number); level = find_datafile_object(dat, level_name); if (!level) abort_on_error("That level doesn't exist!");
Return Value
Returns a pointer to a single DATAFILE element whose `dat' member points to the object, or NULL if the object could not be found.
See Also
Referenced By
load_datafile(3), load_datafile_callback(3), load_datafile_object(3).
version 4.4.3 Allegro manual