Приложения

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

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

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

А.5.26.11. Команда RDS_HSTR_READINT – получить из текста целое число

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

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

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

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

Parser (RDS_HOBJECT): Идентификатор вспомогательного объекта для разбора текста, ранее созданного функцией rdsSTRCreateTextReader.
iSkip (int): Целое число, указывающее на то, как команда будет реагировать на встретившиеся в тексте переводы строк: 1 – пропускать все переводы строк до тех пор, пока не будет считано полноценное слово; 0 – встретив перевод строки, вернуть нулевое значение.
iValue (int): Целое число, в которое преобразовано считанное из текста слово.

Примечания

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

Пример

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

См. также

rdsSTRCreateTextReader, rdsGetObjectInt, rdsSTRGetWord, rdsAtoI.