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. */
}