find_allegro_resource(3alleg4)					  Allegro manual				    find_allegro_resource(3alleg4)

NAME

       find_allegro_resource - Searches for a support file in many places. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       int  find_allegro_resource(char	*dest,	const  char  *resource,  const char *ext, const char *datafile, const char *objectname, const char
       *envvar, const char *subdir, int size);

DESCRIPTION

       Searches for a support file, eg. `allegro.cfg' or `language.dat'. Passed a resource string describing what you are looking for, along  with
       extra  optional information such as the default extension, what datafile to look inside, what the datafile object name is likely to be, any
       special environment variable to check, and any subdirectory that you would like to check as well as the	default  location,  this  function
       looks in a hell of a lot of different places :-). Pass NULL for the parameters you are not using.

       Check  the  documentation chapter specific to your platform for information on additional paths this function might search for. Also, don't
       forget about set_allegro_resource_path() to extend the searches. Example:

	  char path[256];
	  int ret;
	  ret = find_allegro_resource(path, "scores.cfg", NULL, NULL,
				      NULL, NULL, NULL, sizeof(path));
	  if (ret == 0) {
	     /* Found system wide scores file. */
	  } else {
	     /* No previous scores, create our own file. */
	  }

RETURN VALUE

       Returns zero on success, and stores a full path to the file (at most size bytes) into the dest buffer.

SEE ALSO

       set_allegro_resource_path(3alleg4)

Allegro 							   version 4.4.2				    find_allegro_resource(3alleg4)