load_datafile_object(3)         Allegro manual         load_datafile_object(3)



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(3), load_datafile(3), set_color_conversion(3),
       find_datafile_object(3), register_datafile_object(3)



Allegro                          version 4.2.3         load_datafile_object(3)
