www.beck-ipc.com

@CHIP-RTOS C Library - BIOS API


BIOS_Set_Ini_String

Insert an entry into CHIP.INI.

int BIOS_Set_Ini_String ( const char far *section,
                          const char far *item_name,
                          const char far *item_text );

Parameters

section

Pointer to section string (max. 40 chars)

item_name

Pointer to item name (max. 40 chars)

item_text

Pointer to item text (max. 128 chars)
Pass a NULL pointer here to erase the complete item line

Return Value

0:  success
-1:  Invalid string length, low heap memory or file error.

Comments

Leading and trailing white space characters will be cut. The function stops reading the entry when it finds an invalid character (<0x20).

This API is thread safe and reentrant.   This function will fail (no operation) if insufficient system heap memory is available to momentarily hold the contents of the CHIP.INI file.

No write to the CHIP.INI occurs if the specified entry already exists with the specified value.

Example usage:

            
BIOS_Set_Ini_String ("MY_SECTION", "MY_ITEM", "VALUE_TEXT") ;

... produces the following CHIP.INI entry

[MY_SECTION]
MY_ITEM=VALUE_TEXT

See Also

RTOS API

This library function invokes a RTOS software interrupt.   Refer to this RTOS API function's documentation for more details.

Supported since or modified in @CHIP-RTOS version

    SC12SC13SC11SC1x3SC2x
    V1.20V1.20V1.20V1.05V1.00

This API List
List of C Libraries
@CHIP-RTOS Main Index


End of document