Provided by: allegro4-doc_4.4.2-4_all bug

NAME

       set_allegro_resource_path - Sets a specific resource search path. Allegro game programming
       library.

SYNOPSIS

       #include <allegro.h>

       int set_allegro_resource_path(int priority, const char *path);

DESCRIPTION

       Sometimes Allegro doesn't look in enough places to find  a  resource.  For  those  special
       cases,  you  can  call this function before loading your resource with additional paths to
       search for. You set up the priorities, higher numbers are searched for first. To modify an
       already  setup path, call this function with the same priority and the new path. To remove
       an already setup path, call this function with the priority of the path and  NULL  as  the
       path parameter. Example:

          set_allegro_resource_path(10, "my_game/configs");
          set_allegro_resource_path(0, "users/configs/");
          set_allegro_resource_path(-45, "temp");

       These custom paths will be valid until you call allegro_exit(). You can call this function
       before install_allegro(), but after set_uformat() if you  want  to  use  a  text  encoding
       format other than the default.

RETURN VALUE

       Returns non-zero on success, zero if the path could not be added or you wanted to remove a
       path and the priority used didn't have any associated path. Modification of existing paths
       always succeeds.

SEE ALSO

       find_allegro_resource(3alleg4)