The Main Manual Page Dynamic API Documentation CD-ROM API Documentation About Onix Types About Onix Errors Onix's Web Site at Lextek International Lextek International Onix Full Text Indexing and Retrieval Toolkit

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

If possible, use ixConvertQuery2 instead as it will eventually supersede ixConvertQuery.  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, (, ), *, ?.

SEE ALSO

 ixProcessQuery, ixConvertQuery2