IPC@CHIP® RTOS-PPC – API Documentation

Header image

Main page


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

Insert an entry into the CHIP.INI file.

Parameters:
[in] section Pointer to section string (max. 40 chars)
[in] item_name Pointer to item name (max. 40 chars)
[in] item_text Pointer to item text (max. 128 chars) Pass a NULL pointer here to erase the complete item line
Returns:
0: Success
-1: Invalid string length, low heap memory or file error.
Note:
Leading and trailing white space characters will be cut. The function stops reading the entry when it finds an invalid character (<0x20).

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

Example:
 BIOS_Set_Ini_String ("MY_SECTION", "MY_ITEM", "VALUE_TEXT") ;
produces the CHIP.INI entry:
 [MY_SECTION]
 MY_ITEM=VALUE_TEXT
Since:
SC2x3 V1.00 - CLIB V1.00
See also:
BIOS_Get_Ini_String(), BIOS_Set_Ini_String_Ext(), BIOS_Get_Ini_String_Ext()





Top of page | Main page

Copyright © 2017 Beck IPC GmbH
Generated on Thu Jan 26 16:21:36 2017 by Doxygen 1.6.1