Приложения

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

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

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

А.5.27.3. rdsINIReadDouble – получить вещественное значение параметра

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

  double RDSCALL rdsINIReadDoubleA(
    RDS_HOBJECT Ini, // Объект
    RDSCSTR Key,     // Имя параметра (UTF8)
    double DefValue  // Значение по умолчанию
  );
  double RDSCALL rdsINIReadDoubleW(
    RDS_HOBJECT Ini, // Объект
    RDSWCSTR Key,    // Имя параметра (UTF16)
    double DefValue  // Значение по умолчанию
  );
  // Функция-псевдоним
  double RDSCALL rdsINIReadDouble(
    RDS_HOBJECT Ini, // Объект
    RDSXCSTR Key,    // Имя параметра (кодировка по умолчанию)
    double DefValue  // Значение по умолчанию
  );

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

RDS_DHoSD (для UTF8) или RDS_DHoWsD (для UTF16)

Параметры

Ini (RDS_HOBJECT): Идентификатор вспомогательного объекта для работы с текстом, ранее созданного функцией rdsINICreateTextHolder.
Key (RDSCSTR, RDSWCSTR, RDSXCSTR): Указатель на строку с именем параметра.
DefValue (double): Значение параметра по умолчанию (функция вернет это значение, если в текущей секции текста нет параметра с именем Key).

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

Вещественное значение параметра Key из текущей секции объекта Ini.

Примечания

Эта функция возвращает вещественное значение параметра с именем Key из текущей секции объекта Ini, если такой параметр есть в этой секции. Текущей считается секция, установленная функцией rdsINIOpenSection или командой RDS_HINI_CREATESECTION. Если в секции нет параметра с указанным именем или если текущая секция не установлена, функция вернет значение DefValue. Преобразование строки значения в вещественное число производится по правилам функции rdsAtoD.

Если из-за особенностей используемого компилятора возврат типа double невозможен, вместо rdsINIReadDouble можно использовать функцию rdsINIReadDoubleP, возвращающую вещественное число через указатель.

Пример

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

См. также

rdsINICreateTextHolder, rdsINIWriteDouble, rdsINIReadInt, rdsINIReadString, rdsINIOpenSection, RDS_HINI_CREATESECTION, rdsINIReadDoubleP, rdsAtoD.