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

Описания RDS

Приложения

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

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

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

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

# Приложения

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

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

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

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

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

      void RDSCALL rdsINIReadDoublePA(
        RDS_HOBJECT Ini, // Объект
        RDSCSTR Key,     // Имя параметра (UTF8)
        double DefValue, // Значение по умолчанию
        double *pVal     // Возвращаемое значение
      );
      void RDSCALL rdsINIReadDoublePW(
        RDS_HOBJECT Ini, // Объект
        RDSWCSTR Key,    // Имя параметра (UTF16)
        double DefValue, // Значение по умолчанию
        double *pVal     // Возвращаемое значение
      );
      // Функция-псевдоним
      void RDSCALL rdsINIReadDoubleP(
        RDS_HOBJECT Ini, // Объект
        RDSXCSTR Key,    // Имя параметра (кодировка по умолчанию)
        double DefValue, // Значение по умолчанию
        double *pVal     // Возвращаемое значение
      );

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

RDS_VHoSDpD (для UTF8) или RDS_VHoWsDpD (для UTF16)

Параметры

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

Примечания

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

Функция rdsINIReadDoubleP отличается от rdsINIReadDouble только тем, что возвращает значение через указатель pVal.

См. также

rdsINICreateTextHolder, rdsINIWriteDouble, rdsINIReadDouble, rdsAtoD.