Текущий раздел:

Описания RDS

Приложения

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

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

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

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

# Приложения

## Приложение А. Функции, константы и структуры 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.