Provided by: allegro4-doc_4.4.2-13_all bug

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)