Seek the beginning of the next section of a configuration file
#include <photon/PxProto.h> const char *PxConfigNextSection( void ); const char *PxConfigNextSectionCx(PxCfgContext_t *cx);
phexlib
These functions seek the start of the next section, and return the name of this section; this section is made the internal current section. These functions may be used to process a configuration file consisting of unknown sections, but where each section has known entries. If there aren't any more sections (that is, the current section is the last section) the function returns NULL, but the current section and file pointer are left untouched.
PxConfigNextSection() works on the currently open configuration file opened by PxConfigOpen(), while PxConfigNextSectionCx() works on the configuration file indicated by cx.
A string containing the next section name if one exists, NULL otherwise
char *section; while ((section = PxConfigNextSection()) != NULL) { PxConfigReadShort(NULL, "Size", 0, &recsize); PxConfigReadShort(NULL, "Max", 0, &maxrecs); }
Photon
Safety: | |
---|---|
Interrupt handler | No |
Signal handler | No |
Thread | No |
PxConfigFirstSection*(), PxConfigNextEntry*(), PxConfigNextString*(), PxConfigOpen*(), PxConfigSection*()