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)