find_allegro_resource(3) Allegro manual find_allegro_resource(3)NAMEfind_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 informa‐
tion on additional paths this function might search for. Also, don't
forget about set_allegro_resource_path() to extend the searches. Exam‐
ple:
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 ALSOset_allegro_resource_path(3)Allegro version 4.4.2 find_allegro_resource(3)