Приложения

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

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

А.5.26. Вспомогательный объект для разбора текста

А.5.26.10. Команда RDS_HSTR_READDOUBLE – получить из текста вещественное число

Команда RDS_HSTR_READDOUBLE считывает из текста следующее слово и преобразует его в вещественное число.

Вызов команды

  int iSkip= … // 1 – пропускать переводы строк, 0 - нет
  double dValue=rdsGetObjectDouble(Parser,RDS_HSTR_READDOUBLE,iSkip);

или

  int iSkip= … // 1 – пропускать переводы строк, 0 - нет
  double dValue;
  rdsGetObjectDoubleP(Parser,RDS_HSTR_READDOUBLE,iSkip,&dValue);

Параметры и результат

Parser (RDS_HOBJECT)

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

iSkip (int)

Целое число, указывающее на то, как команда будет реагировать на встретившиеся в тексте переводы строк: 1 – пропускать все переводы строк до тех пор, пока не будет считано полноценное слово; 0 – встретив перевод строки, вернуть нулевое значение.

dValue (double)

Вещественное число, в которое преобразовано считанное из текста слово.

Примечания

Эта команда считывает слово из текста при помощи функции rdsSTRGetWord, не сравнивая его с ключевыми словами, а затем преобразует его в вещественное число. Если iSkip==1, команда предварительно пропустит все встретившиеся переводы строк. Преобразование в вещественное число производится по правилам функции rdsAtoD. Если считанное слово не может быть преобразовано в вещественное число, команда вернет значение 0.0.

Пример

Пример использования команды RDS_HSTR_READDOUBLE приведен в §2.8.4 руководства программиста.

См. также

rdsSTRCreateTextReader, rdsGetObjectDouble, rdsGetObjectDoubleP, rdsSTRGetWord, rdsAtoD.