GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  LIST_CONFIG_ENTRIES (3)

NAME

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

CONTENTS

Synopsis
Description
See Also

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(§ions);
   /* 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(§ions);
   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)
Search for    or go to Top of page |  Section 3 |  Main Index


Allegro LIST_CONFIG_ENTRIES (3) version 4.4.2

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.