NAME
load_datafile_object - Loads a specific object from a datafile. Allegro
game programming library.
SYNOPSIS
#include <allegro.h>
DATAFILE *load_datafile_object(const char *filename, const char
*objectname);
DESCRIPTION
Loads a specific object from a datafile. This won't work if you strip
the object names from the file, and it will be very slow if you save
the file with global compression. Example:
/* Load only the music from the datafile. */
music_object = load_datafile_object("datafile.dat",
"MUSIC");
/* Play it and wait a moment for it. */
play_midi(music_object->dat);
...
/* Destroy unneeded music. */
unload_datafile_object(music_object);
RETURN VALUE
Returns a pointer to a single DATAFILE element whose `dat' member
points to the object, or NULL if there was an error or there was no
object with the requested name. Remember to free this DATAFILE later to
avoid memory leaks, but use the correct unloading function!
SEE ALSO
unload_datafile_object(3alleg), load_datafile(3alleg),
set_color_conversion(3alleg), find_datafile_object(3alleg),
register_datafile_object(3alleg)