Приложения

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

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

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

А.5.27.18. Команда RDS_HINI_SETTEXT – занести текст в объект

Команда RDS_HINI_SETTEXT копирует указанный текст во внутреннюю память объекта.

Вызов команды

  RDSSTR strText= … // Текст в формате INI-файла (UTF8)
  rdsSetObjectStrA(Ini,RDS_HINI_SETTEXT,0,strText);

или

  RDSWSTR strText= … // Текст в формате INI-файла (UTF16)
  rdsSetObjectStrW(Ini,RDS_HINI_SETTEXT,0,strText);

или (через функцию-псевдоним)

  RDSXSTR strText= … // Текст в формате INI-файла (кодировка по умолчанию)
  rdsSetObjectStr(Ini,RDS_HINI_SETTEXT,0,strText);

Параметры

Ini (RDS_HOBJECT)

Идентификатор вспомогательного объекта для работы с текстом, ранее созданного функцией rdsINICreateTextHolder.

strText (RDSSTR, RDSWSTR, RDSXSTR)

Указатель на текст в формате INI-файла, который должен быть скопирован в объект.

Примечания

Эта команда копирует текст strText во внутреннюю память объекта Ini. После этого можно обращаться к секциям и параметрам этого текста соответствующими сервисными функциями. Текст, содержавшийся в объекте до выполнения этой команды, теряется.

Пример

Пример использования команды RDS_HINI_SETTEXT приведен в §2.8.5 руководства программиста.

См. также

rdsINICreateTextHolder, rdsSetObjectStr, RDS_HINI_LOADFILE, RDS_HINI_RESET.