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

Описания RDS

Приложения

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

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

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

А.5.27.2. rdsINIOpenSection – установить текущую секцию

# Приложения

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

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

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

##### А.5.27.2. rdsINIOpenSection – установить текущую секцию

Функция rdsINIOpenSection устанавливает имя существующей секции вспомогательного объекта, с которой будут работать все последующие вызовы команд чтения и записи параметров.

      BOOL RDSCALL rdsINIOpenSectionA(
        RDS_HOBJECT Ini,     // Объект
        RDSCSTR SectionName  // Имя секции (UTF8)
      );
      BOOL RDSCALL rdsINIOpenSectionW(
        RDS_HOBJECT Ini,     // Объект
        RDSWCSTR SectionName // Имя секции (UTF16)
      );
      // Функция-псевдоним
      BOOL RDSCALL rdsINIOpenSection(
        RDS_HOBJECT Ini,     // Объект
        RDSXCSTR SectionName // Имя секции (кодировка по умолчанию)
      );

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

RDS_BHoS (для UTF8) или RDS_BHoWs (для UTF16)

Параметры

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

Возвращаемое значение

TRUE – секция SectionName найдена в тексте, FALSE – секция отсутствует.

Примечания

Эта функция ищет в тексте, хранящемся в объекте Ini, секцию с именем SectionName, и, если она присутствует в тексте, устанавливает ее в качестве текущей. Все дальнейшие команды чтения и записи параметров будут работать с этой секцией текста. Если секция с именем SectionName в тексте отсутствует, функция вернет FALSE и все дальнейшие команды чтения и записи будут игнорироваться.

Если логика работы программы требует, чтобы, в случае отсутствия секции, она была создана, следует использовать команду RDS_HINI_CREATESECTION.

Пример

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

См. также

rdsINICreateTextHolder, RDS_HINI_CREATESECTION, RDS_HINI_DELETESECTION.