NAME

       load_datafile - Loads a datafile into memory. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       DATAFILE *load_datafile(const char *filename);

DESCRIPTION

       Loads  a  datafile  into  memory  in  one  go.  If  the  datafile has been encrypted, you must first call
       packfile_password() to set the appropriate key. If the datafile contains truecolor graphics, you must set
       the video mode or call set_color_conversion() before loading it. Example:

          /* Load the resources for our game. */
          DATAFILE *dat = load_datafile("game.dat");
          if (!dat)
             abort_on_error("Couldn't load sound resources!");
          /* Use resources. */
          ...
          /* Destroy them when we don't need them any more. */
          unload_datafile(dat);

RETURN VALUE

       Returns a pointer to the DATAFILE, or NULL on error. Remember to free this DATAFILE later to avoid memory
       leaks.

SEE ALSO

       load_datafile_callback(3alleg4),         unload_datafile(3alleg4),         load_datafile_object(3alleg4),
       set_color_conversion(3alleg4),            fixup_datafile(3alleg4),            packfile_password(3alleg4),
       find_datafile_object(3alleg4),  register_datafile_object(3alleg4),  excustom(3alleg4),   exdata(3alleg4),
       exexedat(3alleg4), exgui(3alleg4), exsprite(3alleg4), exunicod(3alleg4)