GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  FIND_ALLEGRO_RESOURCE (3)

NAME

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

CONTENTS

Synopsis
Description
See Also

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(3)
Search for    or go to Top of page |  Section 3 |  Main Index


Allegro FIND_ALLEGRO_RESOURCE (3) version 4.4.2

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.