Приложения
Приложение А. Функции, константы и структуры 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, в котором считанное целое значение параметра сравнивается с нулем. Таким образом, нулевое значение параметра будет считаться ложью, не нулевое – истиной.
См. также