NAME

list_config_entries - Lists the names of all entries in a config section Allegro game programming library.

SYNOPSIS

#include <allegro.h>

int list_config_entries(const char *section, const char ***names);

DESCRIPTION

This function can be used to get a list of all entries in the given config section. The names parameter is a pointer to an array of strings. If it points to a NULL pointer, the list will be allocated, else it will be re-allocated. You should free the list again with free_config_entries if you don't need it anymore, or you can pass it again to list_config_entries and the memory will be re-used. See the following example for how you can use it, it will print out the complete contents of the current configuration:

   int i, n;


   char const **sections = NULL;


   char const **entries = NULL;


   


   /* List all entries not in any section. */


   n = list_config_entries(NULL, &entries);


   for (i = 0; i 


      printf(" %s=\"%s\"\n", entries[i], get_config_string(


             NULL, entries[i], "-"));


   


   /* List all sections (and entries in them). */


   n = list_config_sections(&sections);


   /* loop through all section names */


   for (i = 0; i 


   {


      int j, m;


      printf("%s\n", sections[i]);


      m = list_config_entries(sections[i], &entries);


      /* loop through all entries in the section */


      for (j = 0; j 


      {


          printf(" %s=\"%s\"\n", entries[j], get_config_string(


             sections[i], entries[j], "-"));


      }


   }


   /* It is enough to free the arrays once at the end. */


   free_config_entries(&sections);


   free_config_entries(&entries);

RETURN VALUE

Returns the number of valid strings in the names array.

SEE ALSO

set_config_file(3), get_config_string(3), list_config_sections(3), free_config_entries(3)