Приложения

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