find_datafile_object(3alleg4) [plan9 man page]

find_datafile_object(3alleg4)					  Allegro manual				     find_datafile_object(3alleg4)

NAME

       find_datafile_object - 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

       load_datafile(3alleg4), load_datafile_object(3alleg4)

Allegro 							   version 4.4.2				     find_datafile_object(3alleg4)

load_datafile(3alleg4)						  Allegro manual					    load_datafile(3alleg4)

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)

Allegro 							   version 4.4.2					    load_datafile(3alleg4)