PxConfigWriteChar()

Write a character parameter in a configuration file

Synopsis:

#include <photon/PxProto.h>

int PxConfigWriteChar( const char *section,
                       const char *entry,
                       int format,
                       char value);

int PxConfigWriteCharCx( PxCfgContext_t *cx,
                         const char *section,
                         const char *entry,
                         int format,
                         char value);

Arguments:

cx

PxConfigWriteCharCx() only. The configuration file handle for the file you want to write to. This handle is returned by PxConfigOpenCx().

section

The section to write value to.
If section matches a valid section name, it becomes the current section. If section is NULL, the function writes to the current section. If section doesn't exist, the function creates it and makes it the current section.

entry

The entry to write value to. If the entry already exists in the current section, it's overwritten; otherwise, it's added to the end of the section.

format

Determines how the value is formatted:

PXCONFIG_FMT_CHAR_CHAR

As a single character (letter/digit).

PXCONFIG_FMT_CHAR_HEX

As a 2-digit hex number with leading 0x.

value

The value which the function writes to the file.

Library:

phexlib

Description:

These functions write a character parameter in the specified section and entry of a configuration file.

---

The configuration file must have been opened by PxConfigOpen*() with a mode of PXCONFIG_WRITE. If the specified section doesn't exist, it's created. To create an empty section, call PxConfigForceEmptySection* ().

---

PxConfigWriteChar() writes to the currently open configuration file opened by PxConfigOpen(), while PxConfigWriteCharCx() writes to the configuration file indicated by cx.

Returns:

Pt_TRUE if the entry is written, otherwise Pt_FALSE

Classification:

Photon

See also:

PxConfigOpen*(), PxConfigReadBool*(), PxConfigReadChar*(), PxConfigReadDouble*(), PxConfigReadInt*(), PxConfigReadLLong*(), PxConfigReadLong*(), PxConfigReadShort*(), PxConfigReadString*(), PxConfigWriteBool*(), PxConfigWriteDouble*(), PxConfigWriteInt*(), PxConfigWriteLong*(), PxConfigWriteLLong*(), PxConfigWriteShort*(), PxConfigWriteString*()