Onix Text Retrieval Toolkit
API Reference

API
Function List
Topical List

Main Index

Introduction
Calling Sequences
Query Processing
Relevancy Ranking
Data Types
Error Handling
   
Support
   
Lextek Products
Onix Text Retrieval Engine
Lextek Document Profiler & Categorizer
Brevity Document Summarizer
RouteX Routing Engine
Language Identifier

ixConvertQuery

Name

ixConvertQuery

Synopsis

void ixConvertQuery(UCharT *TextQuery, UCharT *HexQuery)

Arguments

TextQuery: A query which is composed of standard ASCII characters.

HexQuery: An empty buffer 2.5 times the size of the *TextQuery.

Returns

Nothing.

Description

ixConvertQuery converts a query composed of standard ASCII characters to the form expected by the retrieval engine.  Onix allows data to be indexed and searched with no limit as to what characters may be included in a word (including NULL characters and spaces).  This means however that a query of the form "dick & jane" becomes rather meaningless because the query parser could not then be able to tell where the end of one token begins or ends.  To overcome this problem, Onix expects query tokens to be represented in hexadecimal.  So, the query "dick & jane" would actually need to be given to Onix as "0x6469636B & 0x6A616E65".  ixConvertQuery helps by converting a query of the form used by "dick & jane" to the form which Onix recognizes.  ixConvertQuery() however, will not convert the following characters to hexadecimal form SPACE, <, >, &, |, !, ", -, :nn, (, ), *, ?.

ixConvertQuery2 and ixConvertQuery are basically the same function and are both provided for historical reasons. They differ primarily in terms of the order of the arguments. 

See Also

Queries
ixProcessQuery, ixConvertQuery2