Приложения

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

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

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

Описываются функции и команды вспомогательного объекта RDS, предназначенного для выделения из произвольного текста отдельных слов и сравнения их с ключевыми.

А.5.26.1. rdsSTRCreateTextReader – создать объект для разбора текста

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

  RDS_HOBJECT RDSCALL rdsSTRCreateTextReader(
    BOOL IgnoreCase      // Без учета регистра
  );

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

RDS_HoB

Параметры

IgnoreCase (BOOL)

TRUE – сравнивать слова текста с ключевыми без учета регистра символов, FALSE – с учетом.

Возвращаемое значение

Уникальный идентификатор созданного объекта.

Примечания

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

Если в параметре IgnoreCase передано значение TRUE, при сравнении слов текста с ключевыми объект не будет учитывать регистр символов – например, и слово «WORD», и слово «Word» будут считаться совпадающими с ключевым словом «word». Этот параметр можно изменить уже после создания объекта командой RDS_HSTR_IGNORECASE.

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

Пример

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

См. также

Вспомогательные объекты, rdsDeleteObject, RDS_HSTR_SETTEXT, rdsSTRAddKeyword, rdsSTRAddKeywordsArray, RDS_HSTR_IGNORECASE.