Приложения

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

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

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

А.5.27.20. Макрос rdsINICreateSection – создать секцию

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

  rdsINICreateSectionA(
    ini,           // Вспомогательный объект
    sectionname    // Имя секции (UTF8)
  )
  rdsINICreateSectionW(
    ini,           // Вспомогательный объект
    sectionname    // Имя секции (UTF16)
  )
  // Через функцию-псевдоним
  rdsINICreateSection(
    ini,           // Вспомогательный объект
    sectionname    // Имя секции (кодировка по умолчанию)
  )

Определение

  #define rdsINICreateSectionA(ini,sectionname) \
    rdsSetObjectStrA((ini),RDS_HINI_CREATESECTION, \
      0,(sectionname))
  #define rdsINICreateSectionW(ini,sectionname) \
    rdsSetObjectStrW((ini),RDS_HINI_CREATESECTION, \
      0,(sectionname))
  // Через функцию-псевдоним
  #define rdsINICreateSection(ini,sectionname) \
    rdsSetObjectStr((ini),RDS_HINI_CREATESECTION, \
      0,(sectionname))

Параметры

ini (RDS_HOBJECT)

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

sectionname (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на строку названия секции.

Примечания

Макрос rdsINICreateSection заключает в себя вызов команды RDS_HINI_CREATESECTION.