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

ixConvertQuery2

NAME

 ixConvertQuery2

 SYNOPSIS

void ixConvertQuery2(UCharT *HexQuery, UCharT *TextQuery)

ARGUMENTS

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

*TextQuery -- A query which is composed of standard ASCII characters.

 RETURNS

Nothing.

DESCRIPTION

ixConvertQuery2 will eventually supersede ixConvertQuery. (This is so that it will have the right to left form of arguments so common in C/C++ programs.)  ixConvertQuery2 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".  ixConvertQuery2() helps by converting a query of the form used by "dick & jane" to the form which Onix recognizes.  ixConvertQuery2() however, will not convert the following characters to hexadecimal form SPACE, <, >, &, |, !, ", -, :nn, (, ), *, ?.

SEE ALSO

ixProcessQuery, ixConvertQuery