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

Описания RDS

Приложения

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

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

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

А.5.27.24. Макрос rdsINIReadBool – получить логическое значение параметра

# Приложения

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

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

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

##### А.5.27.24. Макрос rdsINIReadBool – получить логическое значение параметра

Макрос rdsINIReadBool считывает указанный параметр из текущей секции объекта и возвращает его в виде логического (BOOL) значения.

      rdsINIReadBoolA(
        ini,      // Вспомогательный объект
        key,      // Имя параметра (UTF8)
        defval    // Значение по умолчанию
      )
      rdsINIReadBoolW(
        ini,      // Вспомогательный объект
        key,      // Имя параметра (UTF16)
        defval    // Значение по умолчанию
      )
      // Через функцию-псевдоним
      rdsINIReadBool(
        ini,      // Вспомогательный объект
        key,      // Имя параметра (кодировка по умолчанию)
        defval    // Значение по умолчанию
      )

Определение

      #define rdsINIReadBoolA(ini,key,defval) \
        (rdsINIReadIntA((ini),(key),(defval)?1:0)!=0)
      #define rdsINIReadBoolW(ini,key,defval) \
        (rdsINIReadIntW((ini),(key),(defval)?1:0)!=0)
      // Через функцию-псевдоним
      #define rdsINIReadBool(ini,key,defval) \
        (rdsINIReadInt((ini),(key),(defval)?1:0)!=0)

Параметры

ini(RDS_HOBJECT)
  Идентификатор вспомогательного объекта для работы с текстом, ранее созданного функцией rdsINICreateTextHolder.
key(RDSCSTR,RDSWCSTR,RDSXCSTR)
  Указатель на строку с именем параметра.
defval(BOOL)
  Логическое значение параметра по умолчанию (функция вернет это значение, если в текущей секции текста нет параметра с именем key).

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

Логическое значение параметра key из текущей секции объекта ini.

Примечания

Этот макрос заключает в себя вызов функции rdsINIReadInt, в котором считанное целое значение параметра сравнивается с нулем. Таким образом, нулевое значение параметра будет считаться ложью, не нулевое – истиной.

См. также

rdsINIReadInt, rdsINIWriteBool.