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

FreeBSD Manual Pages

  
 
  

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

NAME
     hook_config_section  -  Hooks a configuration file section with custom han-
     dlers. Allegro game programming library.

SYNOPSIS
     #include <allegro.h>

     void hook_config_section(const char *section, int	(*intgetter)(const  char
     *name,  int  def), const char *(*stringgetter)(const char *name, const char
     *def), void (*stringsetter)(const char *name, const char *value));

DESCRIPTION
     Takes control of the specified config file section, so that your hook func-
     tions will be used to manipulate it instead of the normal disk file access.
     If both the getter and setter functions are NULL, a currently present  hook
     will  be unhooked. Hooked functions have the highest priority. If a section
     is hooked, the hook will always be called, so you can also hook a '#'  sec-
     tion:  even  override_config_file() cannot override a hooked section. Exam-
     ple:

	int decode_encrypted_int(const char *name, int def)
	{
	   ...
	}

	const char *decode_encrypted_string(const char *name, const char *def)
	{
	   ...
	}

	void encode_plaintext_string(const char *name, const char *value)
	{
	   ...
	}

	int main(int argc, char *argv[])
	{
	   ...
	   /* Make it harder for users to tinker with the high scores. */
	   hook_config_section("high_scores", decode_encrypted_int,
	      decode_encrypted_string, encode_plaintext_string);
	   ...
	} END_OF_MAIN()

SEE ALSO
     config_is_hooked(3)

Allegro 			  version 4.4.3 	  hook_config_section(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=hook_config_section&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help