hook_config_section - Man Page

Hooks a configuration file section with custom handlers. 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  functions 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 '#' section: even override_config_file() cannot override  a hooked section. Example:

   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)

Referenced By

config_is_hooked(3).

version 4.4.3 Allegro manual