Приложения

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

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

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

А.5.27.10. Команда RDS_HINI_CREATESECTION – создать секцию

Команда RDS_HINI_CREATESECTION создает в тексте секцию с указанным именем и делает ее текущей.

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

  RDSSTR strName= … // Имя секции (UTF8)
  rdsSetObjectStrA(Ini,RDS_HINI_CREATESECTION,0,strName);

или

  RDSWSTR strName= … // Имя секции (UTF16)
  rdsSetObjectStrW(Ini,RDS_HINI_CREATESECTION,0,strName);

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

  RDSXSTR strName= … // Имя секции (кодировка по умолчанию)
  rdsSetObjectStr(Ini,RDS_HINI_CREATESECTION,0,strName);

Параметры и результат

Ini (RDS_HOBJECT): Идентификатор вспомогательного объекта для работы с текстом, ранее созданного функцией rdsINICreateTextHolder.
strName (RDSSTR, RDSWSTR, RDSXSTR): Указатель на строку, в которой записано имя создаваемой секции.

Примечания

Эта команда создает в тексте, хранящемся в объекте Ini, новую секцию с именем strName и делает ее текущей – все последующие вызовы чтения и записи параметров будут работать с этой секцией. Если секция с именем strName уже есть в тексте объекта, она просто становится текущей.

Пример

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

См. также

rdsINICreateTextHolder, rdsSetObjectStr, rdsINIOpenSection, RDS_HINI_DELETESECTION.