Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
find_allegro_resource(3)	Allegro	manual	      find_allegro_resource(3)

NAME
       find_allegro_resource - Searches	for a support file in many places. Al-
       legro 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 pa-
       rameters	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 ALSO
       set_allegro_resource_path(3)

Allegro				 version 4.4.2	      find_allegro_resource(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=find_allegro_resource&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help