company logo

IniFile :: createOption - Add option value

The function allows explicitly creating a new option in the currently selected configuration.

Return value:  Success ( bool  )

The value is true when the function was executed successfully. Otherwise the value is set to false.

Implementation details

bool IniFile  :: createOption ( odaba::String &sName, odaba::String &sValue, odaba::String &sType )

The function appends an option with the name passed in sName and the value passed in sValue to the ini-file. The option will be added at the end of the file and thus, belongs to the last section written to the ini-file.

Option values written before adding a section name are considered as global options, that do not belong to any section.

Notes:

For XML configuration files, the option name may be passed as hierarchical name like "Options.Designer.Initialize".

  • sName - Name
  • sValue - String value
  • sType - - Title unknown