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

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(3alleg4),    get_config_string(3alleg4),    list_config_sections(3alleg4),
       free_config_entries(3alleg4)