Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/px/pxconfigforceemptysection.html on line 1
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/px/pxconfigforceemptysection.html on line 1
Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/px/pxconfigforceemptysection.html on line 8
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/px/pxconfigforceemptysection.html on line 8
Create an empty section in a configuration file
#include <photon/PxProto.h>
int PxConfigForceEmptySection( const char *section );
int PxConfigForceEmptySectionCx( PxCfgContext_t *cx,
const char *section );
- cx
- PxConfigForceEmptySectionCx() only. The configuration file
handle for the file you want to write to. This handle is returned by PxConfigOpenCx().
- section
- The section to create.
If section already exists, it becomes the current section, and its
entries are left intact. If section doesn't exist, the function
creates it and makes it the current section.
phexlib
These functions create an empty section section if one doesn't
exist.
|
The configuration file must have been opened by PxConfigOpen*() with a mode of PXCONFIG_WRITE. |
Normally sections are created as necessary
by the PxConfigWrite*() functions to hold entries, but
sometimes the
mere presence of a configuration section conveys application information. The
new section is made the internal current section.
PxConfigForceEmptySection() writes to the currently open
configuration file opened by PxConfigOpen(), while PxConfigForceEmptySectionCx() writes to the
configuration file indicated by cx.
- Pt_TRUE
- The section is created or exists.
- Pt_FALSE
- Otherwise.
Photon
Safety: | |
Interrupt handler |
No |
Signal handler |
No |
Thread |
No |
PxConfigDeleteSection*(),
PxConfigOpen*()
Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/lib_ref/px/pxconfigforceemptysection.html on line 143
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/lib_ref/px/pxconfigforceemptysection.html on line 143