Приложения

Приложение А. Функции, константы и структуры RDS

А.5. Сервисные функции и макросы RDS

А.5.27. Вспомогательный объект для работы с текстом в формате INI-файла

А.5.27.9. rdsINIWriteString – установить текстовое значение параметра

Функция rdsINIWriteString присваивает строку указанному параметру текущей секции объекта.

  void RDSCALL rdsINIWriteStringA(
    RDS_HOBJECT Ini, // Объект
    RDSCSTR Key,     // Имя параметра (UTF8)
    RDSCSTR Value    // Значение (UTF8)
  );
  void RDSCALL rdsINIWriteStringW(
    RDS_HOBJECT Ini, // Объект
    RDSWCSTR Key,    // Имя параметра (UTF16)
    RDSWCSTR Value   // Значение (UTF16)
  );
  // Функция-псевдоним
  void RDSCALL rdsINIWriteString(
    RDS_HOBJECT Ini, // Объект
    RDSXCSTR Key,    // Имя параметра (кодировка по умолчанию)
    RDSXCSTR Value   // Значение (кодировка по умолчанию)
  );

Тип указателя на эту функцию

RDS_VHoSS (для UTF8) или RDS_VHoWsWs (для UTF16)

Параметры

Ini (RDS_HOBJECT): Идентификатор вспомогательного объекта для работы с текстом, ранее созданного функцией rdsINICreateTextHolder.
Key (RDSCSTR, RDSWCSTR, RDSXCSTR): Указатель на строку с именем параметра.
Value (RDSCSTR, RDSWCSTR, RDSXCSTR): Указатель на строку со значением параметра.

Примечания

Эта функция устанавливает текстовое значение параметра с именем Key в текущей секции объекта Ini (если такого параметра нет в текущей секции, он будет создан). Текущей считается секция, установленная функцией rdsINIOpenSection или командой RDS_HINI_CREATESECTION.

Пример

Пример использования функции rdsINIWriteString приведен в §2.10.1 руководства программиста.

См. также

rdsINICreateTextHolder, rdsINIReadString, rdsINIWriteDouble, rdsINIWriteInt, rdsINIOpenSection, RDS_HINI_CREATESECTION.