PxConfigReadBool(), PxConfigReadBoolCx()

Read a Boolean value from a configuration file

Synopsis:

#include <photon/PxProto.h>

int PxConfigReadBool( const char *section,
                      const char *entry,
                      int dflt,
                      int *value);

int PxConfigReadBoolCx( PxCfgContext_t *cx,
                        const char *section,
                        const char *entry,
                        int dflt,
                        int *value);

Arguments:

cx: PxConfigReadBoolCx() only. The configuration file handle for the file you want to read from. This handle is returned by PxConfigOpenCx().
section: The section to read a value from.
If section is NULL, the function reads the value from entry in the current section. If section is a valid section name, it becomes the current section.
entry: The entry to read the value from.
dflt: The default to store in value if the specified section or entry don't exist, or if the entry value is not ON or OFF, YES or NO, TRUE or FALSE (case-insensitive).
value: A pointer to an int where the function stores the value it reads.

Library:

phexlib

Description:

These functions read a Boolean parameter from a configuration file.

PxConfigReadBool() reads from the currently open configuration file opened by PxConfigOpen(), while PxConfigReadBoolCx() reads from the configuration file indicated by cx.

Returns:

Pt_TRUE if the required section/entry exists and the given value is valid, otherwise Pt_FALSE.

Classification:

Photon

Safety:
Interrupt handler	No
Signal handler	No
Thread	No