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

Описания RDS

Приложения

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

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

А.5.10. Загрузка и сохранение данных блока

А.5.10.10. rdsWriteWordDoubleText – запись вещественного числа в текстовом формате

# Приложения

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

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

#### А.5.10. Загрузка и сохранение данных блока

##### А.5.10.10. rdsWriteWordDoubleText – запись вещественного числа в текстовом формате

Функция rdsWriteWordDoubleText добавляет к данным, сохраняемым блоком в текстовом формате, значение указанного в параметрах вещественного числа с предваряющим его, если это необходимо, ключевым словом.

      void RDSCALL rdsWriteWordDoubleTextA(
        RDSCSTR Keyword,  // Ключевое слово (UTF8)
        double Value      // Число
      );
      void RDSCALL rdsWriteWordDoubleTextW(
        RDSWCSTR Keyword, // Ключевое слово (UTF16)
        double Value      // Число
      );
      // Функция-псевдоним
      void RDSCALL rdsWriteWordDoubleText(
        RDSXCSTR Keyword, // Ключевое слово (кодировка по умолчанию)
        double Value      // Число
      );

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

RDS_VSD (для UTF8) или RDS_VWsD (для UTF16)

Параметры

Keyword(RDSCSTR,RDSWCSTR,RDSXCSTR)
  Указатель на строку (char* или wchar_t*, в зависимости от версии функции) с ключевым словом, или NULL, если ключевое слово добавлять не нужно.
Value(double)
  Число, значение которого записывается (при записи отбрасываются незначащие нули).

Примечания

Эта функция может вызываться только из функции модели блока в момент реакции на события записи данных блока в текстовом формате RDS_BFM_SAVETXT, во всех остальных случаях вызов игнорируется. Она добавляет преобразованное в текст вещественное число (с ключевым словом или без него) к общему набору текстовых данных блока. После завершения реакции на событие RDS_BFM_SAVETXT это набор будет записан в файл или буфер обмена (в зависимости от того, для чего сохраняются данные блока). Перед текстом всегда добавляется пробел.

Если в параметре Value передано специальное значение-индикатор ошибки (см. функцию rdsGetHugeDouble), вместо значения числа будет записан вопросительный знак.

Пример

Вызов функции

      rdsWriteWordDoubleTextA("scale",100.10);

добавит к текстовым данным блока пробел и следующий текст:

      scale 100.1

Другой пример использования функции rdsWriteWordDoubleText приведен в §2.8.4 руководства программиста.

См. также

RDS_BFM_SAVETXT, RDS_BFM_LOADTXT, rdsDtoA, rdsAtoD, rdsGetHugeDouble.