find_allegro_resource
Searches for a support file in many places.
Description
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
);
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. */
}
Returns zero on success, and stores a full path to the file (at most size
bytes) into the dest buffer.
Related Discussions
The following threads each have code containing this keyword:
Note: You can click on the numbers to jump directly to the posts that reference this page.
Related Projects
The following projects include source code containing this keyword: