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

Описания RDS

Приложения

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

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

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

А.5.10.12. rdsWriteWordValueText – запись целого числа в текстовом формате

# Приложения

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

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

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

##### А.5.10.12. rdsWriteWordValueText – запись целого числа в текстовом формате

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

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

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

RDS_VSI (для UTF8) или RDS_VWsI (для UTF16)

Параметры

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

Примечания

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

Пример

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

      rdsWriteWordValueTextA("count",34);

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

      count 34

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

См. также

RDS_BFM_SAVETXT, RDS_BFM_LOADTXT, rdsItoA, rdsAtoI.