4 ** The author disclaims copyright to this source code. In place of
5 ** a legal notice, here is a blessing:
7 ** May you do good and not evil.
8 ** May you find forgiveness for yourself and forgive others.
9 ** May you share freely, never taking more than you give.
11 *************************************************************************
12 ** This file implements a tokenizer for fts3 based on the ICU library.
15 #if !defined(SQLITE_CORE) || defined(SQLITE_ENABLE_FTS3)
16 #ifdef SQLITE_ENABLE_ICU
20 #include "fts3_tokenizer.h"
22 #include <unicode/ubrk.h>
23 #include <unicode/ucol.h>
24 #include <unicode/ustring.h>
25 #include <unicode/utf16.h>
27 typedef struct IcuTokenizer IcuTokenizer
;
28 typedef struct IcuCursor IcuCursor
;
31 sqlite3_tokenizer base
;
36 sqlite3_tokenizer_cursor base
;
38 UBreakIterator
*pIter
; /* ICU break-iterator object */
39 int nChar
; /* Number of UChar elements in pInput */
40 UChar
*aChar
; /* Copy of input using utf-16 encoding */
41 int *aOffset
; /* Offsets of each character in utf-8 input */
50 ** Create a new tokenizer instance.
53 int argc
, /* Number of entries in argv[] */
54 const char * const *argv
, /* Tokenizer creation arguments */
55 sqlite3_tokenizer
**ppTokenizer
/* OUT: Created tokenizer */
61 n
= strlen(argv
[0])+1;
63 p
= (IcuTokenizer
*)sqlite3_malloc(sizeof(IcuTokenizer
)+n
);
67 memset(p
, 0, sizeof(IcuTokenizer
));
70 p
->zLocale
= (char *)&p
[1];
71 memcpy(p
->zLocale
, argv
[0], n
);
74 *ppTokenizer
= (sqlite3_tokenizer
*)p
;
80 ** Destroy a tokenizer
82 static int icuDestroy(sqlite3_tokenizer
*pTokenizer
){
83 IcuTokenizer
*p
= (IcuTokenizer
*)pTokenizer
;
89 ** Prepare to begin tokenizing a particular string. The input
90 ** string to be tokenized is pInput[0..nBytes-1]. A cursor
91 ** used to incrementally tokenize this string is returned in
95 sqlite3_tokenizer
*pTokenizer
, /* The tokenizer */
96 const char *zInput
, /* Input string */
97 int nInput
, /* Length of zInput in bytes */
98 sqlite3_tokenizer_cursor
**ppCursor
/* OUT: Tokenization cursor */
100 IcuTokenizer
*p
= (IcuTokenizer
*)pTokenizer
;
103 const int32_t opt
= U_FOLD_CASE_DEFAULT
;
104 UErrorCode status
= U_ZERO_ERROR
;
116 }else if( nInput
<0 ){
117 nInput
= strlen(zInput
);
120 pCsr
= (IcuCursor
*)sqlite3_malloc(
121 sizeof(IcuCursor
) + /* IcuCursor */
122 ((nChar
+3)&~3) * sizeof(UChar
) + /* IcuCursor.aChar[] */
123 (nChar
+1) * sizeof(int) /* IcuCursor.aOffset[] */
128 memset(pCsr
, 0, sizeof(IcuCursor
));
129 pCsr
->aChar
= (UChar
*)&pCsr
[1];
130 pCsr
->aOffset
= (int *)&pCsr
->aChar
[(nChar
+3)&~3];
132 pCsr
->aOffset
[iOut
] = iInput
;
133 U8_NEXT(zInput
, iInput
, nInput
, c
);
136 c
= u_foldCase(c
, opt
);
137 U16_APPEND(pCsr
->aChar
, iOut
, nChar
, c
, isError
);
142 pCsr
->aOffset
[iOut
] = iInput
;
145 U8_NEXT(zInput
, iInput
, nInput
, c
);
151 pCsr
->pIter
= ubrk_open(UBRK_WORD
, p
->zLocale
, pCsr
->aChar
, iOut
, &status
);
152 if( !U_SUCCESS(status
) ){
158 ubrk_first(pCsr
->pIter
);
159 *ppCursor
= (sqlite3_tokenizer_cursor
*)pCsr
;
164 ** Close a tokenization cursor previously opened by a call to icuOpen().
166 static int icuClose(sqlite3_tokenizer_cursor
*pCursor
){
167 IcuCursor
*pCsr
= (IcuCursor
*)pCursor
;
168 ubrk_close(pCsr
->pIter
);
169 sqlite3_free(pCsr
->zBuffer
);
175 ** Extract the next token from a tokenization cursor.
178 sqlite3_tokenizer_cursor
*pCursor
, /* Cursor returned by simpleOpen */
179 const char **ppToken
, /* OUT: *ppToken is the token text */
180 int *pnBytes
, /* OUT: Number of bytes in token */
181 int *piStartOffset
, /* OUT: Starting offset of token */
182 int *piEndOffset
, /* OUT: Ending offset of token */
183 int *piPosition
/* OUT: Position integer of token */
185 IcuCursor
*pCsr
= (IcuCursor
*)pCursor
;
191 while( iStart
==iEnd
){
194 iStart
= ubrk_current(pCsr
->pIter
);
195 iEnd
= ubrk_next(pCsr
->pIter
);
196 if( iEnd
==UBRK_DONE
){
200 while( iStart
<iEnd
){
202 U16_NEXT(pCsr
->aChar
, iWhite
, pCsr
->nChar
, c
);
209 assert(iStart
<=iEnd
);
213 UErrorCode status
= U_ZERO_ERROR
;
215 char *zNew
= sqlite3_realloc(pCsr
->zBuffer
, nByte
);
219 pCsr
->zBuffer
= zNew
;
220 pCsr
->nBuffer
= nByte
;
224 pCsr
->zBuffer
, pCsr
->nBuffer
, &nByte
, /* Output vars */
225 &pCsr
->aChar
[iStart
], iEnd
-iStart
, /* Input vars */
226 &status
/* Output success/failure */
228 } while( nByte
>pCsr
->nBuffer
);
230 *ppToken
= pCsr
->zBuffer
;
232 *piStartOffset
= pCsr
->aOffset
[iStart
];
233 *piEndOffset
= pCsr
->aOffset
[iEnd
];
234 *piPosition
= pCsr
->iToken
++;
240 ** The set of routines that implement the simple tokenizer
242 static const sqlite3_tokenizer_module icuTokenizerModule
= {
244 icuCreate
, /* xCreate */
245 icuDestroy
, /* xCreate */
247 icuClose
, /* xClose */
252 ** Set *ppModule to point at the implementation of the ICU tokenizer.
254 void sqlite3Fts3IcuTokenizerModule(
255 sqlite3_tokenizer_module
const**ppModule
257 *ppModule
= &icuTokenizerModule
;
260 #endif /* defined(SQLITE_ENABLE_ICU) */
261 #endif /* !defined(SQLITE_CORE) || defined(SQLITE_ENABLE_FTS3) */