rroonga 0.9.2-mswin32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (202) hide show
  1. data/AUTHORS +5 -0
  2. data/NEWS.ja.rdoc +114 -0
  3. data/NEWS.rdoc +116 -0
  4. data/README.ja.rdoc +65 -0
  5. data/README.rdoc +66 -0
  6. data/Rakefile +217 -0
  7. data/benchmark/common.rb +49 -0
  8. data/benchmark/read-write-many-small-items.rb +144 -0
  9. data/benchmark/write-many-small-items.rb +135 -0
  10. data/example/bookmark.rb +161 -0
  11. data/example/index-html.rb +89 -0
  12. data/example/search/config.ru +211 -0
  13. data/example/search/public/css/groonga.css +122 -0
  14. data/ext/.gitignore +2 -0
  15. data/ext/libruby-groonga.a +0 -0
  16. data/ext/rb-grn-accessor.c +52 -0
  17. data/ext/rb-grn-array-cursor.c +36 -0
  18. data/ext/rb-grn-array.c +210 -0
  19. data/ext/rb-grn-column.c +573 -0
  20. data/ext/rb-grn-context.c +655 -0
  21. data/ext/rb-grn-database.c +472 -0
  22. data/ext/rb-grn-encoding-support.c +64 -0
  23. data/ext/rb-grn-encoding.c +257 -0
  24. data/ext/rb-grn-exception.c +1110 -0
  25. data/ext/rb-grn-expression-builder.c +75 -0
  26. data/ext/rb-grn-expression.c +735 -0
  27. data/ext/rb-grn-fix-size-column.c +166 -0
  28. data/ext/rb-grn-hash-cursor.c +38 -0
  29. data/ext/rb-grn-hash.c +294 -0
  30. data/ext/rb-grn-index-column.c +488 -0
  31. data/ext/rb-grn-logger.c +504 -0
  32. data/ext/rb-grn-object.c +1369 -0
  33. data/ext/rb-grn-operation.c +198 -0
  34. data/ext/rb-grn-patricia-trie-cursor.c +39 -0
  35. data/ext/rb-grn-patricia-trie.c +488 -0
  36. data/ext/rb-grn-procedure.c +52 -0
  37. data/ext/rb-grn-query.c +260 -0
  38. data/ext/rb-grn-record.c +40 -0
  39. data/ext/rb-grn-snippet.c +334 -0
  40. data/ext/rb-grn-table-cursor-key-support.c +69 -0
  41. data/ext/rb-grn-table-cursor.c +247 -0
  42. data/ext/rb-grn-table-key-support.c +731 -0
  43. data/ext/rb-grn-table.c +2141 -0
  44. data/ext/rb-grn-type.c +181 -0
  45. data/ext/rb-grn-utils.c +769 -0
  46. data/ext/rb-grn-variable-size-column.c +36 -0
  47. data/ext/rb-grn-variable.c +108 -0
  48. data/ext/rb-grn-view-accessor.c +53 -0
  49. data/ext/rb-grn-view-cursor.c +35 -0
  50. data/ext/rb-grn-view-record.c +41 -0
  51. data/ext/rb-grn-view.c +421 -0
  52. data/ext/rb-grn.h +700 -0
  53. data/ext/rb-groonga.c +117 -0
  54. data/extconf.rb +266 -0
  55. data/html/bar.svg +153 -0
  56. data/html/developer.html +117 -0
  57. data/html/developer.svg +469 -0
  58. data/html/download.svg +253 -0
  59. data/html/favicon.ico +0 -0
  60. data/html/favicon.xcf +0 -0
  61. data/html/footer.html.erb +28 -0
  62. data/html/head.html.erb +4 -0
  63. data/html/header.html.erb +17 -0
  64. data/html/index.html +147 -0
  65. data/html/install.svg +636 -0
  66. data/html/logo.xcf +0 -0
  67. data/html/ranguba.css +250 -0
  68. data/html/tutorial.svg +559 -0
  69. data/lib/groonga.rb +90 -0
  70. data/lib/groonga/context.rb +184 -0
  71. data/lib/groonga/expression-builder.rb +285 -0
  72. data/lib/groonga/patricia-trie.rb +53 -0
  73. data/lib/groonga/record.rb +311 -0
  74. data/lib/groonga/schema.rb +1191 -0
  75. data/lib/groonga/view-record.rb +56 -0
  76. data/license/GPL +340 -0
  77. data/license/LGPL +504 -0
  78. data/license/RUBY +59 -0
  79. data/misc/grnop2ruby.rb +49 -0
  80. data/pkg-config.rb +333 -0
  81. data/test-unit/Rakefile +40 -0
  82. data/test-unit/TODO +5 -0
  83. data/test-unit/bin/testrb +5 -0
  84. data/test-unit/html/classic.html +15 -0
  85. data/test-unit/html/index.html +25 -0
  86. data/test-unit/html/index.html.ja +27 -0
  87. data/test-unit/lib/test/unit.rb +323 -0
  88. data/test-unit/lib/test/unit/assertionfailederror.rb +25 -0
  89. data/test-unit/lib/test/unit/assertions.rb +1230 -0
  90. data/test-unit/lib/test/unit/attribute.rb +125 -0
  91. data/test-unit/lib/test/unit/autorunner.rb +360 -0
  92. data/test-unit/lib/test/unit/collector.rb +36 -0
  93. data/test-unit/lib/test/unit/collector/descendant.rb +23 -0
  94. data/test-unit/lib/test/unit/collector/dir.rb +108 -0
  95. data/test-unit/lib/test/unit/collector/load.rb +136 -0
  96. data/test-unit/lib/test/unit/collector/objectspace.rb +34 -0
  97. data/test-unit/lib/test/unit/color-scheme.rb +102 -0
  98. data/test-unit/lib/test/unit/color.rb +96 -0
  99. data/test-unit/lib/test/unit/diff.rb +724 -0
  100. data/test-unit/lib/test/unit/error.rb +130 -0
  101. data/test-unit/lib/test/unit/exceptionhandler.rb +39 -0
  102. data/test-unit/lib/test/unit/failure.rb +136 -0
  103. data/test-unit/lib/test/unit/fixture.rb +176 -0
  104. data/test-unit/lib/test/unit/notification.rb +129 -0
  105. data/test-unit/lib/test/unit/omission.rb +191 -0
  106. data/test-unit/lib/test/unit/pending.rb +150 -0
  107. data/test-unit/lib/test/unit/priority.rb +180 -0
  108. data/test-unit/lib/test/unit/runner/console.rb +52 -0
  109. data/test-unit/lib/test/unit/runner/emacs.rb +8 -0
  110. data/test-unit/lib/test/unit/runner/tap.rb +8 -0
  111. data/test-unit/lib/test/unit/testcase.rb +476 -0
  112. data/test-unit/lib/test/unit/testresult.rb +89 -0
  113. data/test-unit/lib/test/unit/testsuite.rb +110 -0
  114. data/test-unit/lib/test/unit/ui/console/outputlevel.rb +14 -0
  115. data/test-unit/lib/test/unit/ui/console/testrunner.rb +466 -0
  116. data/test-unit/lib/test/unit/ui/emacs/testrunner.rb +63 -0
  117. data/test-unit/lib/test/unit/ui/tap/testrunner.rb +92 -0
  118. data/test-unit/lib/test/unit/ui/testrunner.rb +28 -0
  119. data/test-unit/lib/test/unit/ui/testrunnermediator.rb +77 -0
  120. data/test-unit/lib/test/unit/ui/testrunnerutilities.rb +41 -0
  121. data/test-unit/lib/test/unit/util/backtracefilter.rb +41 -0
  122. data/test-unit/lib/test/unit/util/method-owner-finder.rb +28 -0
  123. data/test-unit/lib/test/unit/util/observable.rb +90 -0
  124. data/test-unit/lib/test/unit/util/procwrapper.rb +48 -0
  125. data/test-unit/lib/test/unit/version.rb +7 -0
  126. data/test-unit/sample/adder.rb +13 -0
  127. data/test-unit/sample/subtracter.rb +12 -0
  128. data/test-unit/sample/test_adder.rb +20 -0
  129. data/test-unit/sample/test_subtracter.rb +20 -0
  130. data/test-unit/sample/test_user.rb +23 -0
  131. data/test-unit/test/collector/test-descendant.rb +133 -0
  132. data/test-unit/test/collector/test-load.rb +348 -0
  133. data/test-unit/test/collector/test_dir.rb +406 -0
  134. data/test-unit/test/collector/test_objectspace.rb +100 -0
  135. data/test-unit/test/run-test.rb +15 -0
  136. data/test-unit/test/test-attribute.rb +86 -0
  137. data/test-unit/test/test-color-scheme.rb +67 -0
  138. data/test-unit/test/test-color.rb +47 -0
  139. data/test-unit/test/test-diff.rb +518 -0
  140. data/test-unit/test/test-emacs-runner.rb +60 -0
  141. data/test-unit/test/test-fixture.rb +287 -0
  142. data/test-unit/test/test-notification.rb +33 -0
  143. data/test-unit/test/test-omission.rb +81 -0
  144. data/test-unit/test/test-pending.rb +70 -0
  145. data/test-unit/test/test-priority.rb +119 -0
  146. data/test-unit/test/test-testcase.rb +544 -0
  147. data/test-unit/test/test_assertions.rb +1151 -0
  148. data/test-unit/test/test_error.rb +26 -0
  149. data/test-unit/test/test_failure.rb +33 -0
  150. data/test-unit/test/test_testresult.rb +113 -0
  151. data/test-unit/test/test_testsuite.rb +129 -0
  152. data/test-unit/test/testunit-test-util.rb +14 -0
  153. data/test-unit/test/ui/test_testrunmediator.rb +20 -0
  154. data/test-unit/test/util/test-method-owner-finder.rb +38 -0
  155. data/test-unit/test/util/test_backtracefilter.rb +41 -0
  156. data/test-unit/test/util/test_observable.rb +102 -0
  157. data/test-unit/test/util/test_procwrapper.rb +36 -0
  158. data/test/.gitignore +1 -0
  159. data/test/groonga-test-utils.rb +133 -0
  160. data/test/run-test.rb +58 -0
  161. data/test/test-array.rb +97 -0
  162. data/test/test-column.rb +316 -0
  163. data/test/test-context-select.rb +93 -0
  164. data/test/test-context.rb +73 -0
  165. data/test/test-database.rb +113 -0
  166. data/test/test-encoding.rb +33 -0
  167. data/test/test-exception.rb +93 -0
  168. data/test/test-expression-builder.rb +156 -0
  169. data/test/test-expression.rb +134 -0
  170. data/test/test-fix-size-column.rb +65 -0
  171. data/test/test-gqtp.rb +72 -0
  172. data/test/test-hash.rb +312 -0
  173. data/test/test-index-column.rb +81 -0
  174. data/test/test-logger.rb +37 -0
  175. data/test/test-patricia-trie.rb +189 -0
  176. data/test/test-procedure.rb +37 -0
  177. data/test/test-query.rb +22 -0
  178. data/test/test-record.rb +279 -0
  179. data/test/test-remote.rb +54 -0
  180. data/test/test-schema-view.rb +90 -0
  181. data/test/test-schema.rb +459 -0
  182. data/test/test-snippet.rb +130 -0
  183. data/test/test-table-cursor.rb +153 -0
  184. data/test/test-table-offset-and-limit.rb +102 -0
  185. data/test/test-table-select-normalize.rb +53 -0
  186. data/test/test-table-select.rb +150 -0
  187. data/test/test-table.rb +690 -0
  188. data/test/test-type.rb +71 -0
  189. data/test/test-variable-size-column.rb +98 -0
  190. data/test/test-variable.rb +28 -0
  191. data/test/test-vector-column.rb +76 -0
  192. data/test/test-version.rb +31 -0
  193. data/test/test-view.rb +72 -0
  194. data/text/TUTORIAL.ja.rdoc +392 -0
  195. data/text/expression.rdoc +284 -0
  196. data/vendor/local/bin/grntest.exe +0 -0
  197. data/vendor/local/bin/groonga.exe +0 -0
  198. data/vendor/local/bin/libgroonga.dll +0 -0
  199. data/vendor/local/bin/libmecab.dll +0 -0
  200. data/vendor/local/include/groonga.h +2285 -0
  201. data/vendor/local/lib/libgroonga.lib +0 -0
  202. metadata +280 -0
@@ -0,0 +1,284 @@
1
+
2
+ = grn式 (grn_expr)
3
+
4
+
5
+ == 名前
6
+
7
+ grn式 - 検索条件やデータベースへの操作を表現する文字列の形式。(読み方:"ぐるんしき")
8
+
9
+
10
+ == 書式
11
+
12
+ grn式はquery形式とscript形式のいずれかによって表現することができます。
13
+
14
+ query形式
15
+
16
+ [条件式]
17
+ 以下の条件式が使用できます。
18
+
19
+ [文字列]
20
+ 全文検索条件(デフォルト検索対象カラムの値が指定された文字列を含んでいる)
21
+
22
+ ["文字列"]
23
+ フレーズ検索条件(デフォルト検索対象カラムの値が指定されたフレーズを含んでいる)
24
+
25
+ [カラム名:値]
26
+ 一致条件(カラム値 == 値)
27
+
28
+ [カラム名:!値]
29
+ 不一致条件(カラム値 != 値)
30
+
31
+ [カラム名:<値]
32
+ 比較条件(カラム値 < 値)
33
+
34
+ [カラム名:>値]
35
+ 比較条件(カラム値 > 値)
36
+
37
+ [カラム名:<=値]
38
+ 比較条件(カラム値 <= 値)
39
+
40
+ [カラム名:>=値]
41
+ 比較条件(カラム値 >= 値)
42
+
43
+ [カラム名:@文字列]
44
+ 全文検索条件(カラム値が指定された文字列を含んでいる)
45
+
46
+ [補助演算子 [1]]
47
+ 全文検索条件の挙動を制御する以下の演算子が指定できます。
48
+
49
+ [~文字列]
50
+ 文字列を含んでいた場合は、そのレコードのスコアを下げます。
51
+
52
+ [<文字列]
53
+ 文字列を含んでいた場合に加算されるスコアの値を小さくします。
54
+
55
+ [>文字列]
56
+ 文字列を含んでいた場合に加算されるスコアの値を大きくします。
57
+
58
+ [文字列*]
59
+ 文字列に前方一致する条件を示します。
60
+
61
+ [*S[数値]"文字列"]
62
+ 文字列と関連する文書を検索します。文字列から抽出する特徴語の数を数値に指定します。
63
+
64
+ [*N[数値]"文字列"]
65
+ 文字列に含まれる複数の語が、近傍に含まれる文書を検索します。近傍の範囲の上限とな
66
+ る語数を数値に指定します。N-gramの場合は、文字数を指定します。
67
+
68
+ [結合演算子]
69
+ 複数の条件式を結合するために以下の演算子が使用できる。演算子を伴わずに複数の条件式 が空白('
70
+ ')区切りで指定された場合は、デフォルトの結合演算子が指定されたものとみな される。
71
+
72
+ [a OR b]
73
+ 論理和(aとbといずれかの条件がマッチする)
74
+
75
+ [a + b]
76
+ 論理積(aとbの両方がマッチする)
77
+
78
+ [a - b]
79
+ aにマッチし、bにはマッチしない
80
+
81
+ [( )]
82
+ 複数の条件をまとめる
83
+
84
+ [プラグマ [2]]
85
+ query形式文字列の先頭に、処理方法を指定するプラグマを埋め込むことができます。
86
+
87
+ プラグマは必ずクエリ文字列の冒頭に存在しなければなりません。(先頭に空白を入れては いけません)
88
+
89
+ 一つのクエリに複数のプラグマを指定することができます。
90
+
91
+ 複数のプラグマを指定する場合は、間に空白を入れてはいけません。
92
+
93
+ [*E数値1[,数値2]]
94
+ 検索結果の数が数値1よりも小さい場合、完全一致→非わかち書き→部分一致の順に自動
95
+ 的に検索処理方法を切り替えます。完全一致でヒットした文書と比べて非わかち書き一致、
96
+ 部分一致でヒットした文書には数値2分だけ小さいスコアを付与します。数値2を省略した
97
+ 場合は既定値(=2)と解釈されます。数値1に負の数を指定した場合は以下のように処理し ます。
98
+
99
+ -1
100
+
101
+ 完全一致検索のみを行う
102
+
103
+ -2
104
+
105
+ 非わかち書き検索のみを行う
106
+
107
+ -3
108
+
109
+ 完全一致検索と非わかち書き検索のみを行う
110
+
111
+ -4
112
+
113
+ 部分一致検索のみを行う
114
+
115
+ -5
116
+
117
+ 完全一致検索と部分一致検索のみを行う
118
+
119
+ -6
120
+
121
+ 非わかち書き検索と部分一致検索のみを行う
122
+
123
+ -7
124
+
125
+ 完全一致検索,非わかち書き検索,部分一致検索の全てを行う
126
+
127
+ 例:
128
+
129
+ *E10,3
130
+
131
+ 検索結果数が10件以下だった場合に検索処理方法を順次切り替え、スコアを3ずつ小さ くします。
132
+
133
+ [*D演算子]
134
+ 結合演算子の既定値(演算子を省略した場合にどの演算を行うか)を指定します。指定できる演 算子は、OR, +, - のいずれかです。
135
+
136
+ 例1:
137
+
138
+ *D+ abc def
139
+
140
+ abcとdefを両方含む文書を検索します。
141
+
142
+ 例2:
143
+
144
+ *DOR abc def
145
+
146
+ abcとdefのいずれかを含む文書を検索します。
147
+
148
+ [*W[数値[:重み][,数値[:重み]]...]
149
+ 数値で指定されたセクション番号のみを対象に検索します。セクションごとに検索スコア
150
+ の倍数を指定することができます。重みは、省略された場合1となります。負の重みも指 定することができます。
151
+
152
+ script形式 [3]
153
+
154
+ ECMAScript風の構文で検索条件やレコードへの操作を記述します。
155
+
156
+ 式中のIDENTIFIER(識別子)は、以下のいずれかを指します。
157
+
158
+ [引数名]
159
+ grn式が受け取る引数の名前
160
+
161
+ [カラム名]
162
+ 操作対象としているレコードのカラム名
163
+
164
+ [型名・関数名・テーブル名]
165
+ データベースに定義された型・テーブル・関数の名前
166
+
167
+
168
+ == 説明
169
+
170
+ grn式は、検索条件やデータベースへの操作を表現するために使用される文字列の形式です。
171
+
172
+ selectやloadなどのいくつかの組込コマンドや、API関数grn_table_select()などで使用されます。grn式はquery
173
+ 形式とscript形式という2種類の方式で記述することができます。query形式は、多くのweb検索エンジンなどで検索フォームにユーザが指定
174
+ 可能なクエリ文字列の書式に合わせた形式です。script形式は、ECMAScriptの構文から式(expression)以下の構文要素を抜粋
175
+ した形式になっており、文(statement)や制御構造などは表現できません。
176
+
177
+ query形式のgrn式もscript形式のgrn式も、共通の中間形式に翻訳された上で処理されますので、処理速度や効率には差違はありません。
178
+ 記述できる処理の範囲はscript形式の方がquery形式より広くなっています。たとえば更新系の操作はscript形式のみで記述できます。
179
+
180
+ DB-APIレイヤでは、異なる形式で記述された複数のgrn式を結合することも可能です。
181
+
182
+
183
+ == 例
184
+
185
+ query形式でcolumn1の値が'hoge'に等しいという条件
186
+
187
+ column1:hoge
188
+
189
+ script形式でcolumn1の値が'hoge'に等しいという条件
190
+
191
+ column1 == "hoge"
192
+
193
+
194
+ == 構文
195
+
196
+ query形式のgrn式で有効な式の構文を拡張BNF記法で示します。
197
+
198
+ query ::= query_element
199
+ | ( query query_element )
200
+ | ( query "+" query_element )
201
+ | ( query "-" query_element )
202
+ | ( query "OR" query_element )
203
+ query_element ::= STRING
204
+ | ( "(" query ")" )
205
+ | ( IDENTIFIER relative_operator query_element )
206
+ relative_operator ::= ( ":" | ":!" | ":<" | ":>" | ":<=" | ":>=" | ":@" )
207
+
208
+ script形式のgrn式で有効な式の構文を拡張BNF記法で示します。
209
+
210
+ expression ::= assignment_expression
211
+ expression ::= ( expression "," assignment_expression )
212
+ assignment_expression ::= conditional_expression
213
+ | ( lefthand_side_expression assign_operator assignment_expression )
214
+ assign_operator ::= ( "=" | "*=" | "/=" | "%=" | "+=" | "-=" | "<<=" | ">>=" | ">>>=" | "&=" | "^=" | "|=" )
215
+ conditional_expression ::= logical_or_expression
216
+ | ( logical_or_expression "?" assignment_expression ":" assignment_expression )
217
+ logical_or_expression ::= logical_and_expression
218
+ | ( logical_or_expression "||" logical_and_expression )
219
+ logical_and_expression ::= bitwise_or_expression
220
+ | ( logical_and_expression logical_and_operator bitwise_or_expression )
221
+ logical_and_operator ::= ( "&&" | "&!" )
222
+ bitwise_or_expression ::= bitwise_xor_expression
223
+ | ( bitwise_or_expression "|" bitwise_xor_expression )
224
+ bitwise_xor_expression ::= bitwise_and_expression
225
+ | ( bitwise_xor_expression "^" bitwise_and_expression )
226
+ bitwise_and_expression ::= equality_expression
227
+ | bitwise_and_expression "&" equality_expression )
228
+ equality_expression ::= relational_expression
229
+ | ( equality_expression equality_operator relational_expression )
230
+ equality_operator ::= ( "==" | "!=" )
231
+ relational_expression ::= shift_expression
232
+ | ( relational_expression relational_operator shift_expression )
233
+ relational_operator ::= ( "<" | ">" | "<=" | ">=" | "in" | "@" )
234
+ shift_expression ::= additive_expression
235
+ | ( shift_expression shift_operator additive_expression )
236
+ shift_operator ::= ( "<<" | ">>" | ">>>" )
237
+ additive_expression ::= multiplicative_expression
238
+ | ( additive_expression additive_operator multiplicative_expression )
239
+ additive_operator ::= ( "+" | "-" )
240
+ multiplicative_expression ::= unary_expression
241
+ | ( multiplicative_expression multiplicative_operator unary_expression )
242
+ multiplicative_operator ::= ( "*" | "/" | "%" )
243
+ unary_expression ::= postfix_expression
244
+ | ( unary_operator unary_expression )
245
+ unary_operator ::= ( "delete" : "++" : "--" : "+" : "-" : "!" : "~" )
246
+ postfix_expression ::= lefthand_side_expression
247
+ | ( lefthand_side_expression postfix_operator )
248
+ postfix_operator ::= ( "++" | "--" )
249
+ lefthand_side_expression ::= (call_expression | member_expression)
250
+ call_expression ::= member_expression arguments
251
+ member_expression ::= primary_expression
252
+ member_expression ::= member_expression member_expression_part
253
+ primary_expression ::= object_literal
254
+ | ( "(" expression ")" )
255
+ | IDENTIFIER
256
+ | array_literal
257
+ | DECIMAL
258
+ | HEX_INTEGER
259
+ | STRING
260
+ | "true"
261
+ | "false
262
+ | "null"
263
+ array_literal ::= ( "[" elision "]" )
264
+ | ( "[" `element_list elision` "]" )
265
+ | ( "[" element_list "]" )
266
+ elision ::= "," | ( elision "," )
267
+ element_list ::= assignment_expression
268
+ | ( elision assignment_expression )
269
+ | ( element_list elision assignment_expression )
270
+ object_literal ::= ( "{" property_name_and_value_list "}" )
271
+ property_name_and_value_list ::= ( property_name_and_value_list "," property_name_and_value )
272
+ property_name_and_value ::= ( property_name ":" assignment_expression )
273
+ property_name ::= IDENTIFIER | STRING | DECIMAL
274
+ member_expression_part ::= "[" expression "]" | ( "." IDENTIFIER )
275
+ arguments ::= ( "(" argument_list ")" )
276
+ argument_list ::= assignment_expression | ( argument_list "," assignment_expression )
277
+
278
+ -[ 脚注 ]-
279
+
280
+ [1] 補助演算子はv1.0でサポートされます。
281
+
282
+ [2] プラグマはv1.0でサポートされます。
283
+
284
+ [3] script形式のgrn式はv1.0でサポートされます。
Binary file
Binary file
Binary file
Binary file
@@ -0,0 +1,2285 @@
1
+ /* Copyright(C) 2009 Brazil
2
+
3
+ This library is free software; you can redistribute it and/or
4
+ modify it under the terms of the GNU Lesser General Public
5
+ License as published by the Free Software Foundation; either
6
+ version 2.1 of the License, or (at your option) any later version.
7
+
8
+ This library is distributed in the hope that it will be useful,
9
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
10
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
11
+ Lesser General Public License for more details.
12
+
13
+ You should have received a copy of the GNU Lesser General Public
14
+ License along with this library; if not, write to the Free Software
15
+ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
16
+ */
17
+ #ifndef GROONGA_H
18
+ #define GROONGA_H
19
+
20
+ #ifdef __cplusplus
21
+ extern "C" {
22
+ #endif
23
+
24
+ #ifndef GRN_API
25
+ #if defined(_WIN32) || defined(_WIN64)
26
+ #define GRN_API __declspec(dllimport)
27
+ #else
28
+ #define GRN_API
29
+ #endif /* defined(_WIN32) || defined(_WIN64) */
30
+ #endif /* GRN_API */
31
+
32
+ typedef unsigned grn_id;
33
+
34
+ #define GRN_ID_NIL (0x00)
35
+ #define GRN_ID_MAX (0x3fffffff)
36
+
37
+ #define GRN_TRUE (1)
38
+ #define GRN_FALSE (0)
39
+
40
+ typedef enum {
41
+ GRN_SUCCESS = 0,
42
+ GRN_END_OF_DATA = 1,
43
+ GRN_UNKNOWN_ERROR = -1,
44
+ GRN_OPERATION_NOT_PERMITTED = -2,
45
+ GRN_NO_SUCH_FILE_OR_DIRECTORY = -3,
46
+ GRN_NO_SUCH_PROCESS = -4,
47
+ GRN_INTERRUPTED_FUNCTION_CALL = -5,
48
+ GRN_INPUT_OUTPUT_ERROR = -6,
49
+ GRN_NO_SUCH_DEVICE_OR_ADDRESS = -7,
50
+ GRN_ARG_LIST_TOO_LONG = -8,
51
+ GRN_EXEC_FORMAT_ERROR = -9,
52
+ GRN_BAD_FILE_DESCRIPTOR = -10,
53
+ GRN_NO_CHILD_PROCESSES = -11,
54
+ GRN_RESOURCE_TEMPORARILY_UNAVAILABLE = -12,
55
+ GRN_NOT_ENOUGH_SPACE = -13,
56
+ GRN_PERMISSION_DENIED = -14,
57
+ GRN_BAD_ADDRESS = -15,
58
+ GRN_RESOURCE_BUSY = -16,
59
+ GRN_FILE_EXISTS = -17,
60
+ GRN_IMPROPER_LINK = -18,
61
+ GRN_NO_SUCH_DEVICE = -19,
62
+ GRN_NOT_A_DIRECTORY = -20,
63
+ GRN_IS_A_DIRECTORY = -21,
64
+ GRN_INVALID_ARGUMENT = -22,
65
+ GRN_TOO_MANY_OPEN_FILES_IN_SYSTEM = -23,
66
+ GRN_TOO_MANY_OPEN_FILES = -24,
67
+ GRN_INAPPROPRIATE_I_O_CONTROL_OPERATION = -25,
68
+ GRN_FILE_TOO_LARGE = -26,
69
+ GRN_NO_SPACE_LEFT_ON_DEVICE = -27,
70
+ GRN_INVALID_SEEK = -28,
71
+ GRN_READ_ONLY_FILE_SYSTEM = -29,
72
+ GRN_TOO_MANY_LINKS = -30,
73
+ GRN_BROKEN_PIPE = -31,
74
+ GRN_DOMAIN_ERROR = -32,
75
+ GRN_RESULT_TOO_LARGE = -33,
76
+ GRN_RESOURCE_DEADLOCK_AVOIDED = -34,
77
+ GRN_NO_MEMORY_AVAILABLE = -35,
78
+ GRN_FILENAME_TOO_LONG = -36,
79
+ GRN_NO_LOCKS_AVAILABLE = -37,
80
+ GRN_FUNCTION_NOT_IMPLEMENTED = -38,
81
+ GRN_DIRECTORY_NOT_EMPTY = -39,
82
+ GRN_ILLEGAL_BYTE_SEQUENCE = -40,
83
+ GRN_SOCKET_NOT_INITIALIZED = -41,
84
+ GRN_OPERATION_WOULD_BLOCK = -42,
85
+ GRN_ADDRESS_IS_NOT_AVAILABLE = -43,
86
+ GRN_NETWORK_IS_DOWN = -44,
87
+ GRN_NO_BUFFER = -45,
88
+ GRN_SOCKET_IS_ALREADY_CONNECTED = -46,
89
+ GRN_SOCKET_IS_NOT_CONNECTED = -47,
90
+ GRN_SOCKET_IS_ALREADY_SHUTDOWNED = -48,
91
+ GRN_OPERATION_TIMEOUT = -49,
92
+ GRN_CONNECTION_REFUSED = -50,
93
+ GRN_RANGE_ERROR = -51,
94
+ GRN_TOKENIZER_ERROR = -52,
95
+ GRN_FILE_CORRUPT = -53,
96
+ GRN_INVALID_FORMAT = -54,
97
+ GRN_OBJECT_CORRUPT = -55,
98
+ GRN_TOO_MANY_SYMBOLIC_LINKS = -56,
99
+ GRN_NOT_SOCKET = -57,
100
+ GRN_OPERATION_NOT_SUPPORTED = -58,
101
+ GRN_ADDRESS_IS_IN_USE = -59,
102
+ GRN_ZLIB_ERROR = -60,
103
+ GRN_LZO_ERROR = -61,
104
+ GRN_STACK_OVER_FLOW = -62,
105
+ GRN_SYNTAX_ERROR = -63,
106
+ GRN_RETRY_MAX = -64,
107
+ GRN_INCOMPATIBLE_FILE_FORMAT = -65,
108
+ GRN_UPDATE_NOT_ALLOWED = -66,
109
+ } grn_rc;
110
+
111
+ GRN_API grn_rc grn_init(void);
112
+ GRN_API grn_rc grn_fin(void);
113
+
114
+ typedef enum {
115
+ GRN_ENC_DEFAULT = 0,
116
+ GRN_ENC_NONE,
117
+ GRN_ENC_EUC_JP,
118
+ GRN_ENC_UTF8,
119
+ GRN_ENC_SJIS,
120
+ GRN_ENC_LATIN1,
121
+ GRN_ENC_KOI8R
122
+ } grn_encoding;
123
+
124
+ typedef enum {
125
+ GRN_LOG_NONE = 0,
126
+ GRN_LOG_EMERG,
127
+ GRN_LOG_ALERT,
128
+ GRN_LOG_CRIT,
129
+ GRN_LOG_ERROR,
130
+ GRN_LOG_WARNING,
131
+ GRN_LOG_NOTICE,
132
+ GRN_LOG_INFO,
133
+ GRN_LOG_DEBUG,
134
+ GRN_LOG_DUMP
135
+ } grn_log_level;
136
+
137
+ typedef enum {
138
+ GRN_CONTENT_NONE = 0,
139
+ GRN_CONTENT_TSV,
140
+ GRN_CONTENT_JSON,
141
+ GRN_CONTENT_XML
142
+ } grn_content_type;
143
+
144
+ typedef struct _grn_obj grn_obj;
145
+ typedef struct _grn_ctx grn_ctx;
146
+
147
+ #define GRN_CTX_MSGSIZE (0x80)
148
+ #define GRN_CTX_FIN (0xff)
149
+
150
+ typedef union {
151
+ int int_value;
152
+ grn_id id;
153
+ void *ptr;
154
+ } grn_user_data;
155
+
156
+ typedef grn_obj *grn_proc_func(grn_ctx *ctx, int nargs, grn_obj **args,
157
+ grn_user_data *user_data);
158
+
159
+ struct _grn_ctx {
160
+ grn_rc rc;
161
+ int flags;
162
+ grn_encoding encoding;
163
+ unsigned char ntrace;
164
+ unsigned char errlvl;
165
+ unsigned char stat;
166
+ unsigned int seqno;
167
+ unsigned int subno;
168
+ unsigned int seqno2;
169
+ unsigned int errline;
170
+ grn_user_data user_data;
171
+ grn_ctx *prev;
172
+ grn_ctx *next;
173
+ const char *errfile;
174
+ const char *errfunc;
175
+ struct _grn_ctx_impl *impl;
176
+ void *trace[16];
177
+ char errbuf[GRN_CTX_MSGSIZE];
178
+ };
179
+
180
+ #define GRN_CTX_USER_DATA(ctx) (&((ctx)->user_data))
181
+
182
+ /**
183
+ * grn_ctx_init:
184
+ * @ctx: 初期化するctx構造体へのポインタを指定します。
185
+ * @flags: 初期化するctxのオプションを指定します。
186
+ *
187
+ * ctxを初期化します。
188
+ **/
189
+
190
+ #define GRN_CTX_USE_QL (0x03)
191
+ #define GRN_CTX_BATCH_MODE (0x04)
192
+
193
+ GRN_API grn_rc grn_ctx_init(grn_ctx *ctx, int flags);
194
+
195
+ /**
196
+ * grn_ctx_open:
197
+ * @flags: 初期化するctxのオプションを指定します。
198
+ *
199
+ *
200
+ * 初期化されたgrn_ctxオブジェクトを返します。
201
+ * grn_ctx_initで初期化されたgrn_ctxオブジェクトは構造体の実体を
202
+ * APIの呼び元で確保するのに対して、grn_ctx_openではgroongaライブラリの内部で、
203
+ * 実体を確保します。どちらで初期化されたgrn_ctxも、grn_ctx_fin()で解放できます。
204
+ * grn_ctx_openで確保したgrn_ctx構造体に関しては、grn_ctx_fin()で解放した後に、
205
+ * そのgrn_ctxで作成したgrn_objをgrn_obj_close()によって解放しても問題ありません。
206
+ **/
207
+
208
+ GRN_API grn_ctx *grn_ctx_open(int flags);
209
+
210
+ /**
211
+ * grn_ctx_fin:
212
+ * @ctx: 解放するctx構造体へのポインタを指定します。
213
+ *
214
+ * ctxの管理するメモリを解放し、使用を終了します。
215
+ **/
216
+ GRN_API grn_rc grn_ctx_fin(grn_ctx *ctx);
217
+
218
+ /**
219
+ * grn_get_default_encoding:
220
+ *
221
+ * デフォルトのencodingを返します。
222
+ **/
223
+ GRN_API grn_encoding grn_get_default_encoding(void);
224
+
225
+ /**
226
+ * grn_set_default_encoding:
227
+ * @encoding: 変更後のデフォルトのencodingを指定します。
228
+ *
229
+ * デフォルトのencodingを変更します。
230
+ **/
231
+ GRN_API grn_rc grn_set_default_encoding(grn_encoding encoding);
232
+
233
+ #define GRN_CTX_GET_ENCODING(ctx) ((ctx)->encoding)
234
+ #define GRN_CTX_SET_ENCODING(ctx,enc) \
235
+ ((ctx)->encoding = (enc == GRN_ENC_DEFAULT) ? grn_get_default_encoding() : enc)
236
+
237
+ GRN_API const char *grn_get_version(void);
238
+ GRN_API const char *grn_get_package(void);
239
+
240
+ /* obj */
241
+
242
+ typedef unsigned short int grn_obj_flags;
243
+
244
+ #define GRN_OBJ_TABLE_TYPE_MASK (0x07)
245
+ #define GRN_OBJ_TABLE_HASH_KEY (0x00)
246
+ #define GRN_OBJ_TABLE_PAT_KEY (0x01)
247
+ #define GRN_OBJ_TABLE_NO_KEY (0x03)
248
+ #define GRN_OBJ_TABLE_VIEW (0x04)
249
+
250
+ #define GRN_OBJ_KEY_MASK (0x07<<3)
251
+ #define GRN_OBJ_KEY_UINT (0x00<<3)
252
+ #define GRN_OBJ_KEY_INT (0x01<<3)
253
+ #define GRN_OBJ_KEY_FLOAT (0x02<<3)
254
+
255
+ #define GRN_OBJ_KEY_WITH_SIS (0x01<<6)
256
+ #define GRN_OBJ_KEY_NORMALIZE (0x01<<7)
257
+
258
+ #define GRN_OBJ_COLUMN_TYPE_MASK (0x07)
259
+ #define GRN_OBJ_COLUMN_SCALAR (0x00)
260
+ #define GRN_OBJ_COLUMN_VECTOR (0x01)
261
+ #define GRN_OBJ_COLUMN_INDEX (0x02)
262
+
263
+ #define GRN_OBJ_COMPRESS_MASK (0x07<<4)
264
+ #define GRN_OBJ_COMPRESS_NONE (0x00<<4)
265
+ #define GRN_OBJ_COMPRESS_ZLIB (0x01<<4)
266
+ #define GRN_OBJ_COMPRESS_LZO (0x02<<4)
267
+
268
+ #define GRN_OBJ_WITH_SECTION (0x01<<7)
269
+ #define GRN_OBJ_WITH_WEIGHT (0x01<<8)
270
+ #define GRN_OBJ_WITH_POSITION (0x01<<9)
271
+ #define GRN_OBJ_WITH_BUFFER (0x01<<10)
272
+
273
+ #define GRN_OBJ_UNIT_MASK (0x0f<<8)
274
+ #define GRN_OBJ_UNIT_DOCUMENT_NONE (0x00<<8)
275
+ #define GRN_OBJ_UNIT_DOCUMENT_SECTION (0x01<<8)
276
+ #define GRN_OBJ_UNIT_DOCUMENT_POSITION (0x02<<8)
277
+ #define GRN_OBJ_UNIT_SECTION_NONE (0x03<<8)
278
+ #define GRN_OBJ_UNIT_SECTION_POSITION (0x04<<8)
279
+ #define GRN_OBJ_UNIT_POSITION_NONE (0x05<<8)
280
+ #define GRN_OBJ_UNIT_USERDEF_DOCUMENT (0x06<<8)
281
+ #define GRN_OBJ_UNIT_USERDEF_SECTION (0x07<<8)
282
+ #define GRN_OBJ_UNIT_USERDEF_POSITION (0x08<<8)
283
+
284
+ #define GRN_OBJ_NO_SUBREC (0x00<<13)
285
+ #define GRN_OBJ_WITH_SUBREC (0x01<<13)
286
+
287
+ #define GRN_OBJ_KEY_VAR_SIZE (0x01<<14)
288
+
289
+ #define GRN_OBJ_TEMPORARY (0x00<<15)
290
+ #define GRN_OBJ_PERSISTENT (0x01<<15)
291
+
292
+ /* obj types */
293
+
294
+ #define GRN_VOID (0x00)
295
+ #define GRN_BULK (0x02)
296
+ #define GRN_PTR (0x03)
297
+ #define GRN_UVECTOR (0x04) /* vector of grn_id */
298
+ #define GRN_PVECTOR (0x05) /* vector of grn_obj* */
299
+ #define GRN_VECTOR (0x06) /* vector of arbitrary data */
300
+ #define GRN_MSG (0x07)
301
+ #define GRN_QUERY (0x08)
302
+ #define GRN_ACCESSOR (0x09)
303
+ #define GRN_ACCESSOR_VIEW (0x0a)
304
+ #define GRN_SNIP (0x0b)
305
+ #define GRN_PATSNIP (0x0c)
306
+ #define GRN_CURSOR_TABLE_HASH_KEY (0x10)
307
+ #define GRN_CURSOR_TABLE_PAT_KEY (0x11)
308
+ #define GRN_CURSOR_TABLE_NO_KEY (0x13)
309
+ #define GRN_CURSOR_TABLE_VIEW (0x14)
310
+ #define GRN_CURSOR_COLUMN_INDEX (0x18)
311
+ #define GRN_TYPE (0x20)
312
+ #define GRN_PROC (0x21)
313
+ #define GRN_EXPR (0x22)
314
+ #define GRN_TABLE_HASH_KEY (0x30)
315
+ #define GRN_TABLE_PAT_KEY (0x31)
316
+ #define GRN_TABLE_NO_KEY (0x33)
317
+ #define GRN_TABLE_VIEW (0x34)
318
+ #define GRN_DB (0x37)
319
+ #define GRN_COLUMN_FIX_SIZE (0x40)
320
+ #define GRN_COLUMN_VAR_SIZE (0x41)
321
+ #define GRN_COLUMN_INDEX (0x48)
322
+
323
+ typedef struct _grn_section grn_section;
324
+ typedef struct _grn_obj_header grn_obj_header;
325
+
326
+ struct _grn_section {
327
+ unsigned int offset;
328
+ unsigned int length;
329
+ unsigned int weight;
330
+ grn_id domain;
331
+ };
332
+
333
+ struct _grn_obj_header {
334
+ unsigned char type;
335
+ unsigned char impl_flags;
336
+ grn_obj_flags flags;
337
+ grn_id domain;
338
+ };
339
+
340
+ struct _grn_obj {
341
+ grn_obj_header header;
342
+ union {
343
+ struct {
344
+ char *head;
345
+ char *curr;
346
+ char *tail;
347
+ } b;
348
+ struct {
349
+ grn_obj *body;
350
+ grn_section *sections;
351
+ int n_sections;
352
+ } v;
353
+ } u;
354
+ };
355
+
356
+ #define GRN_OBJ_REFER (0x01<<0)
357
+ #define GRN_OBJ_OUTPLACE (0x01<<1)
358
+
359
+ #define GRN_OBJ_INIT(obj,obj_type,obj_flags,obj_domain) do { \
360
+ (obj)->header.type = (obj_type);\
361
+ (obj)->header.impl_flags = (obj_flags);\
362
+ (obj)->header.flags = 0;\
363
+ (obj)->header.domain = (obj_domain);\
364
+ (obj)->u.b.head = NULL;\
365
+ (obj)->u.b.curr = NULL;\
366
+ (obj)->u.b.tail = NULL;\
367
+ } while (0)
368
+
369
+ #define GRN_OBJ_FIN(ctx,obj) (grn_obj_close((ctx), (obj)))
370
+
371
+ /**
372
+ * grn_db_create:
373
+ * @path: 作成するdbを格納するファイルパス。NULLならtemporary dbとなる。
374
+ * NULL以外のパスを指定した場合はpersistent dbとなる。
375
+ * @optarg: 作成するdbの組み込み型の名前を変更する時に指定する。
376
+ * optarg.builtin_type_namesには組み込み型の名前となるnul終端文字列の配列を指定する。
377
+ * optarg.n_builtin_type_namesには、optarg.builtin_type_namesで指定する文字列の数を
378
+ * 指定する。配列のoffsetはenum型grn_builtin_typeの値に対応する。
379
+ *
380
+ * 新たなdbを作成する。
381
+ **/
382
+
383
+ typedef struct _grn_db_create_optarg grn_db_create_optarg;
384
+
385
+ struct _grn_db_create_optarg {
386
+ char **builtin_type_names;
387
+ int n_builtin_type_names;
388
+ };
389
+
390
+ GRN_API grn_obj *grn_db_create(grn_ctx *ctx, const char *path, grn_db_create_optarg *optarg);
391
+
392
+ #define GRN_DB_OPEN_OR_CREATE(ctx,path,optarg,db) \
393
+ (((db) = grn_db_open((ctx), (path))) || (db = grn_db_create((ctx), (path), (optarg))))
394
+
395
+ /**
396
+ * grn_db_open:
397
+ * @path: 開こうとするdbを格納するファイルパス。
398
+ *
399
+ * 既存のdbを開く。
400
+ **/
401
+ GRN_API grn_obj *grn_db_open(grn_ctx *ctx, const char *path);
402
+
403
+ /**
404
+ * grn_ctx_use:
405
+ * @db: ctxが使用するdbを指定します。
406
+ *
407
+ * ctxが操作対象とするdbを指定します。NULLを指定した場合は、
408
+ * dbを操作しない状態(init直後の状態)になります。
409
+ **/
410
+ GRN_API grn_rc grn_ctx_use(grn_ctx *ctx, grn_obj *db);
411
+
412
+ /**
413
+ * grn_ctx_db:
414
+ *
415
+ * ctxが現在操作対象としているdbを返します。
416
+ * dbを使用していない場合はNULLを返します。
417
+ **/
418
+ GRN_API grn_obj *grn_ctx_db(grn_ctx *ctx);
419
+
420
+ /**
421
+ * grn_ctx_get:
422
+ * @name: 検索しようとするオブジェクトの名前。
423
+ * @name_size: @nameのbyte長。
424
+ *
425
+ * ctxが使用するdbからnameに対応するオブジェクトを検索して返す。
426
+ * nameに一致するオブジェクトが存在しなければNULLを返す。
427
+ **/
428
+ GRN_API grn_obj *grn_ctx_get(grn_ctx *ctx, const char *name, unsigned name_size);
429
+
430
+ /**
431
+ * grn_ctx_at:
432
+ * @id: 検索しようとするオブジェクトのid。
433
+ *
434
+ * ctx、またはctxが使用するdbからidに対応するオブジェクトを検索して返す。
435
+ * idに一致するオブジェクトが存在しなければNULLを返す。
436
+ **/
437
+
438
+ typedef enum {
439
+ GRN_DB_VOID = 0,
440
+ GRN_DB_DB,
441
+ GRN_DB_OBJECT,
442
+ GRN_DB_BOOL,
443
+ GRN_DB_INT8,
444
+ GRN_DB_UINT8,
445
+ GRN_DB_INT16,
446
+ GRN_DB_UINT16,
447
+ GRN_DB_INT32,
448
+ GRN_DB_UINT32,
449
+ GRN_DB_INT64,
450
+ GRN_DB_UINT64,
451
+ GRN_DB_FLOAT,
452
+ GRN_DB_TIME,
453
+ GRN_DB_SHORT_TEXT,
454
+ GRN_DB_TEXT,
455
+ GRN_DB_LONG_TEXT,
456
+ GRN_DB_TOKYO_GEO_POINT,
457
+ GRN_DB_WGS84_GEO_POINT
458
+ } grn_builtin_type;
459
+
460
+ typedef enum {
461
+ GRN_DB_MECAB = 64,
462
+ GRN_DB_DELIMIT,
463
+ GRN_DB_UNIGRAM,
464
+ GRN_DB_BIGRAM,
465
+ GRN_DB_TRIGRAM,
466
+ } grn_builtin_tokenizer;
467
+
468
+ GRN_API grn_obj *grn_ctx_at(grn_ctx *ctx, grn_id id);
469
+
470
+ /**
471
+ * grn_type_create:
472
+ * @name: 作成するtypeの名前。
473
+ * @flags: GRN_OBJ_KEY_VAR_SIZE, GRN_OBJ_KEY_FLOAT, GRN_OBJ_KEY_INT, GRN_OBJ_KEY_UINT
474
+ * のいずれかを指定
475
+ * @size: GRN_OBJ_KEY_VAR_SIZEの場合は最大長、
476
+ * それ以外の場合は長さを指定(単位:byte)
477
+ *
478
+ * nameに対応する新たなtype(型)をdbに定義する。
479
+ **/
480
+
481
+ GRN_API grn_obj *grn_type_create(grn_ctx *ctx, const char *name, unsigned name_size,
482
+ grn_obj_flags flags, unsigned int size);
483
+
484
+ GRN_API grn_rc grn_db_load(grn_ctx *ctx, const char *path);
485
+
486
+ /**
487
+ * grn_proc_create:
488
+ * @name: 作成するprocの名前。
489
+ * @type: procの種類。
490
+ * @init: 初期化関数のポインタ
491
+ * @next: 実処理関数のポインタ
492
+ * @fin: 終了関数のポインタ
493
+ * @nvars: procで使用する変数の数
494
+ * @vars: procで使用する変数の定義(grn_expr_var構造体の配列)
495
+ *
496
+ * nameに対応する新たなproc(手続き)をctxが使用するdbに定義する。
497
+ **/
498
+
499
+ typedef struct {
500
+ char *name;
501
+ unsigned name_size;
502
+ grn_obj value;
503
+ } grn_expr_var;
504
+
505
+ typedef grn_rc grn_proc_init_func(grn_ctx *ctx, const char *path);
506
+
507
+ typedef enum {
508
+ GRN_PROC_TOKENIZER = 1,
509
+ GRN_PROC_PROCEDURE,
510
+ GRN_PROC_FUNCTION,
511
+ GRN_PROC_HOOK
512
+ } grn_proc_type;
513
+
514
+ GRN_API grn_obj *grn_proc_create(grn_ctx *ctx,
515
+ const char *name, unsigned name_size,
516
+ const char *path, grn_proc_type type,
517
+ grn_proc_func *init, grn_proc_func *next, grn_proc_func *fin,
518
+ unsigned nvars, grn_expr_var *vars);
519
+ /**
520
+ * grn_proc_vars:
521
+ * @user_data: grn_proc_funcに渡されたuser_data
522
+ * @nvars: 変数の数
523
+ *
524
+ * user_dataをキーとして、現在実行中のgrn_proc_func関数および
525
+ * 定義されている変数(grn_expr_var)の配列とその数を取得する。
526
+ **/
527
+
528
+ GRN_API grn_obj *grn_proc_get_info(grn_ctx *ctx, grn_user_data *user_data,
529
+ grn_expr_var **vars, unsigned *nvars, grn_obj **caller);
530
+
531
+ /*-------------------------------------------------------------
532
+ * table操作のための関数
533
+ */
534
+
535
+ #define GRN_TABLE_MAX_KEY_SIZE (0x1000)
536
+
537
+ /**
538
+ * grn_table_create:
539
+ * @name: 作成するtableの名前。NULLなら無名tableとなる。
540
+ * persistent dbに対して名前をありのtableを作成するときには、
541
+ * flagsにGRN_OBJ_PERSISTENTが指定されていなければならない。
542
+ * @path: 作成するtableのファイルパス。
543
+ * flagsにGRN_OBJ_PERSISTENTが指定されている場合のみ有効。
544
+ * NULLなら自動的にファイルパスが付与される。
545
+ * @flags: GRN_OBJ_PERSISTENTを指定すると永続tableとなる。
546
+ * GRN_OBJ_TABLE_PAT_KEY,GRN_OBJ_TABLE_HASH_KEY,GRN_OBJ_TABLE_NO_KEY
547
+ * のいずれかを指定する。
548
+ * GRN_OBJ_KEY_NORMALIZEを指定すると正規化された文字列がkeyとなる。
549
+ * GRN_OBJ_KEY_WITH_SISを指定するとkey文字列の全suffixが自動的に登録される。
550
+ * @key_type: keyの型を指定する。GRN_OBJ_TABLE_NO_KEYが指定された場合は無効。
551
+ * 既存のtypeあるいはtableを指定できる。
552
+ * key_typeにtable Aを指定してtable Bを作成した場合、Bは必ずAのサブセットとなる。
553
+ * @value_type: keyに対応する値を格納する領域の型。tableはcolumnとは別に、
554
+ * keyに対応する値を格納する領域を一つだけ持つことができる。
555
+ *
556
+ * nameに対応する新たなtableをctxが使用するdbに定義する。
557
+ **/
558
+ GRN_API grn_obj *grn_table_create(grn_ctx *ctx,
559
+ const char *name, unsigned name_size,
560
+ const char *path, grn_obj_flags flags,
561
+ grn_obj *key_type, grn_obj *value_type);
562
+
563
+ #define GRN_TABLE_OPEN_OR_CREATE(ctx,name,name_size,path,flags,key_type,value_type,table) \
564
+ (((table) = grn_ctx_get((ctx), (name), (name_size))) ||\
565
+ ((table) = grn_table_create((ctx), (name), (name_size), (path), (flags), (key_type), (value_type))))
566
+
567
+ /**
568
+ * grn_table_add:
569
+ * @table: 対象table
570
+ * @key: 検索key
571
+ * @added: NULL以外の値が指定された場合、
572
+ * 新たにrecordが追加された時には1が、既存recordだった時には0がセットされる。
573
+ *
574
+ * keyに対応する新しいrecordをtableに追加し、そのIDを返す。
575
+ * keyに対応するrecordがすでにtableに存在するならば、そのrecordのIDを返す。
576
+ * GRN_OBJ_TABLE_NO_KEYが指定されたtableでは、key, key_size は無視される。
577
+ **/
578
+ GRN_API grn_id grn_table_add(grn_ctx *ctx, grn_obj *table,
579
+ const void *key, unsigned key_size, int *added);
580
+
581
+ /**
582
+ * grn_table_get:
583
+ * @table: 対象table
584
+ * @key: 検索key
585
+ *
586
+ * tableからkeyに対応するrecordを検索し、対応するIDを返す。
587
+ **/
588
+ GRN_API grn_id grn_table_get(grn_ctx *ctx, grn_obj *table,
589
+ const void *key, unsigned key_size);
590
+
591
+ /**
592
+ * grn_table_lcp_search:
593
+ * @table: 対象table
594
+ * @key: 検索key
595
+ *
596
+ * tableがGRN_TABLE_PAT_KEYを指定して作ったtableなら、
597
+ * longest common prefix searchを行い、対応するIDを返す。
598
+ **/
599
+ GRN_API grn_id grn_table_lcp_search(grn_ctx *ctx, grn_obj *table,
600
+ const void *key, unsigned key_size);
601
+
602
+ /**
603
+ * grn_table_get_key:
604
+ * @table: 対象table
605
+ * @id: 対象レコードのID
606
+ * @keybuf: keyを格納するバッファ(呼出側で準備する)
607
+ * @buf_size: keybufのサイズ(byte長)
608
+ *
609
+ * tableのIDに対応するレコードのkeyを取得する。対応するレコードが存在する場合はkey長を返す。
610
+ * 見つからない場合は0を返す。
611
+ * 対応するキーの検索に成功し、またbuf_sizeの長さがkey長以上であった場合は、
612
+ * keybufに該当するkeyをコピーする。
613
+ *
614
+ **/
615
+ GRN_API int grn_table_get_key(grn_ctx *ctx, grn_obj *table,
616
+ grn_id id, void *keybuf, int buf_size);
617
+
618
+ /**
619
+ * grn_table_delete:
620
+ * @table: 対象table
621
+ * @key: 検索key
622
+ * @key_size: 検索keyのサイズ
623
+ *
624
+ * tableのkeyに対応するレコードを削除する。
625
+ * 対応するレコードが存在しない場合はGRN_INVALID_ARGUMENTを返す。
626
+ **/
627
+ GRN_API grn_rc grn_table_delete(grn_ctx *ctx, grn_obj *table,
628
+ const void *key, unsigned key_size);
629
+
630
+ /**
631
+ * grn_table_delete_by_id:
632
+ * @table: 対象table
633
+ * @id: レコードID
634
+ *
635
+ * tableのkeyに対応するレコードを削除する。
636
+ * 対応するレコードが存在しない場合はGRN_INVALID_ARGUMENTを返す。
637
+ **/
638
+ GRN_API grn_rc grn_table_delete_by_id(grn_ctx *ctx, grn_obj *table, grn_id id);
639
+
640
+ /**
641
+ * grn_table_truncate:
642
+ * @table: 対象table
643
+ *
644
+ * tableの全レコードを一括して削除する。
645
+ * 注意: multithread環境では他のthreadのアクセスによって
646
+ * 存在しないアドレスへアクセスし、SIGSEGVが発生する可能性がある。
647
+ **/
648
+ GRN_API grn_rc grn_table_truncate(grn_ctx *ctx, grn_obj *table);
649
+
650
+ typedef grn_obj grn_table_cursor;
651
+
652
+ #define GRN_CURSOR_ASCENDING (0x00<<0)
653
+ #define GRN_CURSOR_DESCENDING (0x01<<0)
654
+ #define GRN_CURSOR_GE (0x00<<1)
655
+ #define GRN_CURSOR_GT (0x01<<1)
656
+ #define GRN_CURSOR_LE (0x00<<2)
657
+ #define GRN_CURSOR_LT (0x01<<2)
658
+ #define GRN_CURSOR_BY_KEY (0x00<<3)
659
+ #define GRN_CURSOR_BY_ID (0x01<<3)
660
+ #define GRN_CURSOR_PREFIX (0x01<<4)
661
+
662
+ /**
663
+ * grn_table_cursor_open:
664
+ * @table: 対象table
665
+ * @min: keyの下限 (NULLは下限なしと見なす)
666
+ * @min_size: @minのsize
667
+ * @max: keyの上限 (NULLは上限なしと見なす)
668
+ * @max_size: @maxのsize
669
+ * @flags: GRN_CURSOR_ASCENDINGを指定すると昇順にレコードを取り出す。
670
+ * GRN_CURSOR_DESCENDINGを指定すると降順にレコードを取り出す。
671
+ * GRN_CURSOR_GTを指定するとminに一致したkeyをcursorの範囲に含まない。
672
+ * GRN_CURSOR_LTを指定するとmaxに一致したkeyをcursorの範囲に含まない。
673
+ * GRN_CURSOR_BY_IDを指定するとID順にレコードを取り出す。
674
+ * GRN_OBJ_TABLE_PAT_KEYを指定したtableについては、
675
+ * GRN_CURSOR_BY_KEYを指定するとkey順にレコードを取り出す。
676
+ * (GRN_OBJ_TABLE_HASH_KEY,GRN_OBJ_TABLE_NO_KEYではGRN_CURSOR_BY_KEYは無視される)
677
+ * @offset: 該当する範囲のレコードのうち、(0ベースで)offset番目からレコードを取り出す。
678
+ * @limit: 該当する範囲のレコードのうち、limit件のみを取り出す。
679
+ * -1が指定された場合は、全件が指定されたものとみなす。
680
+ *
681
+ * tableに登録されているレコードを順番に取り出すためのカーソルを生成して返す。
682
+ **/
683
+ GRN_API grn_table_cursor *grn_table_cursor_open(grn_ctx *ctx, grn_obj *table,
684
+ const void *min, unsigned min_size,
685
+ const void *max, unsigned max_size,
686
+ int offset, int limit, int flags);
687
+
688
+ /**
689
+ * grn_table_cursor_close:
690
+ * @tc: 対象cursor
691
+ *
692
+ * grn_table_cursor_openで生成したcursorを解放する。
693
+ **/
694
+ GRN_API grn_rc grn_table_cursor_close(grn_ctx *ctx, grn_table_cursor *tc);
695
+
696
+ /**
697
+ * grn_table_cursor_next:
698
+ * @tc: 対象cursor
699
+ *
700
+ * cursorのカレントレコードを一件進めてそのIDを返す。
701
+ * cursorの対象範囲の末尾に達するとGRN_ID_NILを返す。
702
+ **/
703
+ GRN_API grn_id grn_table_cursor_next(grn_ctx *ctx, grn_table_cursor *tc);
704
+
705
+ /**
706
+ * grn_table_cursor_get_key:
707
+ * @tc: 対象cursor
708
+ * @key: カレントレコードのkeyへのポインタがセットされる。
709
+ * cursorのカレントレコードのkeyを@keyにセットし、その長さを返す。
710
+ **/
711
+ GRN_API int grn_table_cursor_get_key(grn_ctx *ctx, grn_table_cursor *tc, void **key);
712
+
713
+ /**
714
+ * grn_table_cursor_get_value:
715
+ * @tc: 対象cursor
716
+ * @value: カレントレコードのvalueへのポインタがセットされる。
717
+ * cursorのカレントレコードのvalueを@valueにセットし、その長さを返す。
718
+ **/
719
+ GRN_API int grn_table_cursor_get_value(grn_ctx *ctx, grn_table_cursor *tc, void **value);
720
+
721
+ /**
722
+ * grn_table_cursor_set_value:
723
+ * @tc: 対象cursor
724
+ * @value: 新しいvalueの値。
725
+ * @flags: grn_obj_set_valueのflagsと同様の値を指定できる。
726
+ *
727
+ * cursorのカレントレコードのvalueを引数の内容に置き換える。
728
+ * cursorのカレントレコードが存在しない場合はGRN_INVALID_ARGUMENTを返す。
729
+ **/
730
+ GRN_API grn_rc grn_table_cursor_set_value(grn_ctx *ctx, grn_table_cursor *tc,
731
+ void *value, int flags);
732
+
733
+ /**
734
+ * grn_table_cursor_delete:
735
+ * @tc: 対象cursor
736
+ *
737
+ * cursorのカレントレコードを削除する。
738
+ * cursorのカレントレコードが存在しない場合はGRN_INVALID_ARGUMENTを返す。
739
+ **/
740
+ GRN_API grn_rc grn_table_cursor_delete(grn_ctx *ctx, grn_table_cursor *tc);
741
+
742
+ /**
743
+ * grn_table_cursor_table:
744
+ * @tc: 対象cursor
745
+ *
746
+ * cursorが属するtableを返す。
747
+ **/
748
+ GRN_API grn_obj *grn_table_cursor_table(grn_ctx *ctx, grn_table_cursor *tc);
749
+
750
+ #define GRN_TABLE_EACH(ctx,table,head,tail,id,key,key_size,value,block) do {\
751
+ (ctx)->errlvl = GRN_LOG_NOTICE;\
752
+ (ctx)->rc = GRN_SUCCESS;\
753
+ if ((ctx)->seqno & 1) {\
754
+ (ctx)->subno++;\
755
+ } else {\
756
+ (ctx)->seqno++;\
757
+ }\
758
+ if (table) {\
759
+ switch ((table)->header.type) {\
760
+ case GRN_TABLE_PAT_KEY :\
761
+ GRN_PAT_EACH((ctx), (grn_pat *)(table), (id), (key), (key_size), (value), block);\
762
+ break;\
763
+ case GRN_TABLE_HASH_KEY :\
764
+ GRN_HASH_EACH((ctx), (grn_hash *)(table), (id), (key), (key_size), (value), block);\
765
+ break;\
766
+ case GRN_TABLE_NO_KEY :\
767
+ GRN_ARRAY_EACH((ctx), (grn_array *)(table), (head), (tail), (id), (value), block);\
768
+ break;\
769
+ }\
770
+ }\
771
+ if ((ctx)->subno) {\
772
+ (ctx)->subno--;\
773
+ } else {\
774
+ (ctx)->seqno++;\
775
+ }\
776
+ } while (0)
777
+
778
+ /**
779
+ * grn_table_sort:
780
+ * @table: 対象table
781
+ * @offset: sortされたレコードのうち、(0ベースで)offset番目から順にresにレコードを格納する
782
+ * @limit: resに格納するレコードの上限
783
+ * @result: 結果を格納するtable
784
+ * @keys: ソートキー配列へのポインタ
785
+ * @n_keys: ソートキー配列のサイズ
786
+ *
787
+ * table内のレコードをソートし、上位limit個の要素をresultに格納する。
788
+ * keys.keyには、tableのcolumn,accessor,procのいずれかが指定できる。
789
+ * keys.flagsには、GRN_TABLE_SORT_ASC/GRN_TABLE_SORT_DESCのいずれかを指定できる。
790
+ * GRN_TABLE_SORT_ASCでは昇順、GRN_TABLE_SORT_DESCでは降順でソートされる。
791
+ * keys.offsetは、内部利用のためのメンバである。
792
+ **/
793
+
794
+ typedef struct _grn_table_sort_key grn_table_sort_key;
795
+ typedef unsigned char grn_table_sort_flags;
796
+
797
+ #define GRN_TABLE_SORT_ASC (0x00<<0)
798
+ #define GRN_TABLE_SORT_DESC (0x01<<0)
799
+
800
+ struct _grn_table_sort_key {
801
+ grn_obj *key;
802
+ grn_table_sort_flags flags;
803
+ int offset;
804
+ };
805
+
806
+ GRN_API int grn_table_sort(grn_ctx *ctx, grn_obj *table, int offset, int limit,
807
+ grn_obj *result, grn_table_sort_key *keys, int n_keys);
808
+
809
+ /**
810
+ * grn_table_group:
811
+ * @table: 対象table
812
+ * @keys: group化キー構造体の配列へのポインタ
813
+ * @n_keys: group化キー構造体の配列のサイズ
814
+ * @results: group化の結果を格納する構造体の配列へのポインタ
815
+ * @n_results:group化の結果を格納する構造体の配列のサイズ
816
+ *
817
+ * tableのレコードを特定の条件でグループ化する
818
+ **/
819
+
820
+ typedef struct _grn_table_group_result grn_table_group_result;
821
+ typedef unsigned int grn_table_group_flags;
822
+
823
+ #define GRN_TABLE_GROUP_CALC_COUNT (0x01<<3)
824
+ #define GRN_TABLE_GROUP_CALC_MAX (0x01<<4)
825
+ #define GRN_TABLE_GROUP_CALC_MIN (0x01<<5)
826
+ #define GRN_TABLE_GROUP_CALC_SUM (0x01<<6)
827
+ #define GRN_TABLE_GROUP_CALC_AVG (0x01<<7)
828
+
829
+ typedef enum {
830
+ GRN_OP_PUSH = 0,
831
+ GRN_OP_POP,
832
+ GRN_OP_NOP,
833
+ GRN_OP_CALL,
834
+ GRN_OP_INTERN,
835
+ GRN_OP_GET_REF,
836
+ GRN_OP_GET_VALUE,
837
+ GRN_OP_AND,
838
+ GRN_OP_BUT,
839
+ GRN_OP_OR,
840
+ GRN_OP_ASSIGN,
841
+ GRN_OP_STAR_ASSIGN,
842
+ GRN_OP_SLASH_ASSIGN,
843
+ GRN_OP_MOD_ASSIGN,
844
+ GRN_OP_PLUS_ASSIGN,
845
+ GRN_OP_MINUS_ASSIGN,
846
+ GRN_OP_SHIFTL_ASSIGN,
847
+ GRN_OP_SHIFTR_ASSIGN,
848
+ GRN_OP_SHIFTRR_ASSIGN,
849
+ GRN_OP_AND_ASSIGN,
850
+ GRN_OP_XOR_ASSIGN,
851
+ GRN_OP_OR_ASSIGN,
852
+ GRN_OP_JUMP,
853
+ GRN_OP_CJUMP,
854
+ GRN_OP_COMMA,
855
+ GRN_OP_BITWISE_OR,
856
+ GRN_OP_BITWISE_XOR,
857
+ GRN_OP_BITWISE_AND,
858
+ GRN_OP_BITWISE_NOT,
859
+ GRN_OP_EQUAL,
860
+ GRN_OP_NOT_EQUAL,
861
+ GRN_OP_LESS,
862
+ GRN_OP_GREATER,
863
+ GRN_OP_LESS_EQUAL,
864
+ GRN_OP_GREATER_EQUAL,
865
+ GRN_OP_IN,
866
+ GRN_OP_MATCH,
867
+ GRN_OP_NEAR,
868
+ GRN_OP_NEAR2,
869
+ GRN_OP_SIMILAR,
870
+ GRN_OP_TERM_EXTRACT,
871
+ GRN_OP_SHIFTL,
872
+ GRN_OP_SHIFTR,
873
+ GRN_OP_SHIFTRR,
874
+ GRN_OP_PLUS,
875
+ GRN_OP_MINUS,
876
+ GRN_OP_STAR,
877
+ GRN_OP_SLASH,
878
+ GRN_OP_MOD,
879
+ GRN_OP_DELETE,
880
+ GRN_OP_INCR,
881
+ GRN_OP_DECR,
882
+ GRN_OP_INCR_POST,
883
+ GRN_OP_DECR_POST,
884
+ GRN_OP_NOT,
885
+ GRN_OP_ADJUST,
886
+ GRN_OP_EXACT,
887
+ GRN_OP_LCP,
888
+ GRN_OP_PARTIAL,
889
+ GRN_OP_UNSPLIT,
890
+ GRN_OP_PREFIX,
891
+ GRN_OP_SUFFIX,
892
+ GRN_OP_GEO_DISTANCE1,
893
+ GRN_OP_GEO_DISTANCE2,
894
+ GRN_OP_GEO_DISTANCE3,
895
+ GRN_OP_GEO_DISTANCE4,
896
+ GRN_OP_GEO_WITHINP5,
897
+ GRN_OP_GEO_WITHINP6,
898
+ GRN_OP_GEO_WITHINP8,
899
+ GRN_OP_OBJ_SEARCH,
900
+ GRN_OP_EXPR_GET_VAR,
901
+ GRN_OP_TABLE_CREATE,
902
+ GRN_OP_TABLE_SELECT,
903
+ GRN_OP_TABLE_SORT,
904
+ GRN_OP_TABLE_GROUP,
905
+ GRN_OP_JSON_PUT
906
+ } grn_operator;
907
+
908
+ struct _grn_table_group_result {
909
+ grn_obj *table;
910
+ unsigned char key_begin;
911
+ unsigned char key_end;
912
+ int limit;
913
+ grn_table_group_flags flags;
914
+ grn_operator op;
915
+ };
916
+
917
+ GRN_API grn_rc grn_table_group(grn_ctx *ctx, grn_obj *table,
918
+ grn_table_sort_key *keys, int n_keys,
919
+ grn_table_group_result *results, int n_results);
920
+
921
+ /**
922
+ * grn_table_setoperation:
923
+ * @table1: 対象table1
924
+ * @table2: 対象table2
925
+ * @res: 結果を格納するtable
926
+ * @op: 実行する演算の種類
927
+ *
928
+ * table1とtable2をopの指定に従って集合演算した結果をresに格納する。
929
+ * resにtable1あるいはtable2そのものを指定した場合を除けば、table1, table2は破壊されない。
930
+ **/
931
+ GRN_API grn_rc grn_table_setoperation(grn_ctx *ctx, grn_obj *table1, grn_obj *table2,
932
+ grn_obj *res, grn_operator op);
933
+
934
+ /**
935
+ * grn_table_difference:
936
+ * @table1: 対象table1
937
+ * @table2: 対象table2
938
+ * @res1: 結果を格納するtable
939
+ * @res2: 結果を格納するtable
940
+ *
941
+ * table1とtable2から重複するレコードを取り除いた結果をそれぞれres1, res2に格納する。
942
+ **/
943
+ GRN_API grn_rc grn_table_difference(grn_ctx *ctx, grn_obj *table1, grn_obj *table2,
944
+ grn_obj *res1, grn_obj *res2);
945
+
946
+ /**
947
+ * grn_table_columns:
948
+ * @table: 対象table
949
+ * @name: 取得したいカラム名のprefix
950
+ * @name_size: @nameの長さ
951
+ * @res: 結果を格納するGRN_TABLE_HASH_KEYのtable
952
+ *
953
+ * @nameから始まるtableのカラムIDを@resに格納する。
954
+ * @name_sizeが0の場合はすべてのカラムIDを格納する。格納した
955
+ * カラムIDの数を返す。
956
+ **/
957
+ GRN_API int grn_table_columns(grn_ctx *ctx, grn_obj *table,
958
+ const char *name, unsigned name_size,
959
+ grn_obj *res);
960
+
961
+ /**
962
+ * grn_obj_column:
963
+ * @table: 対象table
964
+ * @name: カラム名
965
+ *
966
+ * nameがカラム名の場合、それに対応するtableのカラムを返す。
967
+ * 対応するカラムが存在しなければNULLを返す。
968
+ * nameはアクセサ文字列の場合、それに対応するaccessorを返す。
969
+ * アクセサ文字列とは、カラム名等を'.'で連結した文字列である。
970
+ * '_id', '_key'は特殊なアクセサで、それぞれレコードID/keyを返す。
971
+ * 例) 'col1' / 'col2.col3' / 'col2._id'
972
+ **/
973
+ GRN_API grn_obj *grn_obj_column(grn_ctx *ctx, grn_obj *table,
974
+ const char *name, unsigned name_size);
975
+
976
+
977
+ /**
978
+ * grn_table_size:
979
+ * @table: 対象table
980
+ *
981
+ * tableに登録されているレコードの件数を返す。
982
+ **/
983
+ GRN_API unsigned int grn_table_size(grn_ctx *ctx, grn_obj *table);
984
+
985
+ /*-------------------------------------------------------------
986
+ * column操作のための関数
987
+ */
988
+
989
+ /**
990
+ * grn_column_create:
991
+ * @table: 対象table
992
+ * @name: カラム名
993
+ * @name_size: @nameのsize(byte)
994
+ * @path: カラムを格納するファイルパス。
995
+ * flagsにGRN_OBJ_PERSISTENTが指定されている場合のみ有効。
996
+ * NULLなら自動的にファイルパスが付与される。
997
+ * @flags: GRN_OBJ_PERSISTENTを指定すると永続columnとなる。
998
+ * GRN_OBJ_COLUMN_INDEXを指定すると転置インデックスとなる。
999
+ * GRN_OBJ_COLUMN_SCALARを指定するとスカラ値(単独の値)を格納する。
1000
+ * GRN_OBJ_COLUMN_VECTORを指定すると値の配列を格納する。
1001
+ * GRN_OBJ_COMPRESS_ZLIBを指定すると値をzlib圧縮して格納する。
1002
+ * GRN_OBJ_COMPRESS_LZOを指定すると値をlzo圧縮して格納する。
1003
+ * GRN_OBJ_COLUMN_INDEXと共にGRN_OBJ_WITH_SECTIONを指定すると、
1004
+ * 転置索引にsection(段落情報)を合わせて格納する。
1005
+ * GRN_OBJ_COLUMN_INDEXと共にGRN_OBJ_WITH_WEIGHTを指定すると、
1006
+ * 転置索引にweight情報を合わせて格納する。
1007
+ * GRN_OBJ_COLUMN_INDEXと共にGRN_OBJ_WITH_POSITIONを指定すると、
1008
+ * 転置索引に出現位置情報を合わせて格納する。
1009
+ * @type: カラム値の型。定義済みのtypeあるいはtableを指定できる。
1010
+ *
1011
+ * tableに新たなカラムを定義する。nameは省略できない。
1012
+ * 一つのtableに同一のnameのcolumnを複数定義することはできない。
1013
+ **/
1014
+ GRN_API grn_obj *grn_column_create(grn_ctx *ctx, grn_obj *table,
1015
+ const char *name, unsigned name_size,
1016
+ const char *path, grn_obj_flags flags, grn_obj *type);
1017
+
1018
+ #define GRN_COLUMN_OPEN_OR_CREATE(ctx,table,name,name_size,path,flags,type,column) \
1019
+ (((column) = grn_obj_column((ctx), (table), (name), (name_size))) ||\
1020
+ ((column) = grn_column_create((ctx), (table), (name), (name_size), (path), (flags), (type))))
1021
+
1022
+ /**
1023
+ * grn_column_index_update
1024
+ * @column: 対象column
1025
+ * @id: 対象レコードのID
1026
+ * @section: 対象レコードのセクション番号
1027
+ * @oldvalue: 更新前の値
1028
+ * @newvalue: 更新後の値
1029
+ *
1030
+ * oldvalue, newvalueの値から得られるキーに対応するcolumnの値の中の、
1031
+ * id, sectionに対応するエントリを更新する。
1032
+ * columnはGRN_OBJ_COLUMN_INDEX型のカラムでなければならない。
1033
+ **/
1034
+ GRN_API grn_rc grn_column_index_update(grn_ctx *ctx, grn_obj *column,
1035
+ grn_id id, unsigned int section,
1036
+ grn_obj *oldvalue, grn_obj *newvalue);
1037
+
1038
+ /**
1039
+ * grn_column_table:
1040
+ * @column: 対象column
1041
+ *
1042
+ * columnが属するtableを返す。
1043
+ **/
1044
+ GRN_API grn_obj *grn_column_table(grn_ctx *ctx, grn_obj *column);
1045
+
1046
+ /*-------------------------------------------------------------
1047
+ * db, table, columnの全てまたは幾つかで共通に使用できる関数
1048
+ */
1049
+
1050
+ typedef enum {
1051
+ GRN_INFO_ENCODING = 0,
1052
+ GRN_INFO_SOURCE,
1053
+ GRN_INFO_DEFAULT_TOKENIZER,
1054
+ GRN_INFO_ELEMENT_SIZE,
1055
+ GRN_INFO_CURR_MAX,
1056
+ GRN_INFO_MAX_ELEMENT_SIZE,
1057
+ GRN_INFO_SEG_SIZE,
1058
+ GRN_INFO_CHUNK_SIZE,
1059
+ GRN_INFO_MAX_SECTION,
1060
+ GRN_INFO_HOOK_LOCAL_DATA,
1061
+ GRN_INFO_ELEMENT_A,
1062
+ GRN_INFO_ELEMENT_CHUNK,
1063
+ GRN_INFO_ELEMENT_CHUNK_SIZE,
1064
+ GRN_INFO_ELEMENT_BUFFER_FREE,
1065
+ GRN_INFO_ELEMENT_NTERMS,
1066
+ GRN_INFO_ELEMENT_NTERMS_VOID,
1067
+ GRN_INFO_ELEMENT_SIZE_IN_CHUNK,
1068
+ GRN_INFO_ELEMENT_POS_IN_CHUNK,
1069
+ GRN_INFO_ELEMENT_SIZE_IN_BUFFER,
1070
+ GRN_INFO_ELEMENT_POS_IN_BUFFER,
1071
+ GRN_INFO_ELEMENT_ESTIMATE_SIZE,
1072
+ GRN_INFO_NGRAM_UNIT_SIZE,
1073
+ /*
1074
+ GRN_INFO_VERSION,
1075
+ GRN_INFO_CONFIGURE_OPTIONS,
1076
+ GRN_INFO_CONFIG_PATH,
1077
+ */
1078
+ GRN_INFO_PARTIAL_MATCH_THRESHOLD,
1079
+ GRN_INFO_II_SPLIT_THRESHOLD
1080
+ } grn_info_type;
1081
+
1082
+ /**
1083
+ * grn_obj_get_info:
1084
+ * @obj: 対象obj
1085
+ * @type: 取得する情報の種類
1086
+ * @valuebuf: 値を格納するバッファ(呼出側で準備)
1087
+ *
1088
+ * objのtypeに対応する情報をvaluebufに格納する。
1089
+ **/
1090
+ GRN_API grn_obj *grn_obj_get_info(grn_ctx *ctx, grn_obj *obj, grn_info_type type, grn_obj *valuebuf);
1091
+
1092
+ /**
1093
+ * grn_obj_set_info:
1094
+ * @obj: 対象obj
1095
+ * @type: 設定する情報の種類
1096
+ * @value: 設定しようとする値
1097
+ *
1098
+ * objのtypeに対応する情報をvalueの内容に更新する。
1099
+ **/
1100
+ GRN_API grn_rc grn_obj_set_info(grn_ctx *ctx, grn_obj *obj, grn_info_type type, grn_obj *value);
1101
+
1102
+ /**
1103
+ * grn_obj_get_element_info:
1104
+ * @obj: 対象obj
1105
+ * @id: 対象ID
1106
+ * @type: 取得する情報の種類
1107
+ * @value: 値を格納するバッファ(呼出側で準備)
1108
+ *
1109
+ * objのidに対応するレコードの、typeに対応する情報をvaluebufに格納する。
1110
+ * 呼出側ではtypeに応じて十分なサイズのバッファを確保しなければならない。
1111
+ **/
1112
+ GRN_API grn_obj *grn_obj_get_element_info(grn_ctx *ctx, grn_obj *obj, grn_id id,
1113
+ grn_info_type type, grn_obj *value);
1114
+
1115
+ /**
1116
+ * grn_obj_set_element_info:
1117
+ * @obj: 対象object
1118
+ * @id: 対象ID
1119
+ * @type: 設定する情報の種類
1120
+ * @value: 設定しようとする値
1121
+ *
1122
+ * objのidに対応するレコードのtypeに対応する情報をvalueの内容に更新する。
1123
+ **/
1124
+ GRN_API grn_rc grn_obj_set_element_info(grn_ctx *ctx, grn_obj *obj, grn_id id,
1125
+ grn_info_type type, grn_obj *value);
1126
+
1127
+
1128
+ /**
1129
+ * grn_obj_get_value:
1130
+ * @obj: 対象object
1131
+ * @id: 対象レコードのID
1132
+ * @value: 値を格納するバッファ(呼出側で準備する)
1133
+ *
1134
+ * objのIDに対応するレコードのvalueを取得する。
1135
+ * valueを戻り値として返す。
1136
+ **/
1137
+ GRN_API grn_obj *grn_obj_get_value(grn_ctx *ctx, grn_obj *obj, grn_id id, grn_obj *value);
1138
+
1139
+ /**
1140
+ * grn_obj_set_value:
1141
+ * @obj: 対象object
1142
+ * @id: 対象レコードのID
1143
+ * @value: 格納する値
1144
+ * @flags: 以下の値を指定できる
1145
+ * GRN_OBJ_SET: レコードの値をvalueと置き換える。
1146
+ * GRN_OBJ_INCR: レコードの値にvalueを加算する。
1147
+ * GRN_OBJ_DECR: レコードの値にvalueを減算する。
1148
+ * GRN_OBJ_APPEND: レコードの値の末尾にvalueを追加する。
1149
+ * GRN_OBJ_PREPEND: レコードの値の先頭にvalueを追加する。
1150
+ * GRN_OBJ_GET: 新しいレコードの値をvalueにセットする。
1151
+ * GRN_OBJ_COMPARE: レコードの値とvalueが等しいか調べる。
1152
+ * GRN_OBJ_LOCK: 当該レコードをロックする。GRN_OBJ_COMPAREと共に指定された場合は、
1153
+ * レコードの値とvalueが等しい場合に限ってロックする。
1154
+ * GRN_OBJ_UNLOCK: 当該レコードのロックを解除する。
1155
+ *
1156
+ * objのIDに対応するレコードの値を更新する。
1157
+ * 対応するレコードが存在しない場合はGRN_INVALID_ARGUMENTを返す。
1158
+ **/
1159
+
1160
+ #define GRN_OBJ_SET_MASK (0x07)
1161
+ #define GRN_OBJ_SET (0x01)
1162
+ #define GRN_OBJ_INCR (0x02)
1163
+ #define GRN_OBJ_DECR (0x03)
1164
+ #define GRN_OBJ_APPEND (0x04)
1165
+ #define GRN_OBJ_PREPEND (0x05)
1166
+ #define GRN_OBJ_GET (0x01<<4)
1167
+ #define GRN_OBJ_COMPARE (0x01<<5)
1168
+ #define GRN_OBJ_LOCK (0x01<<6)
1169
+ #define GRN_OBJ_UNLOCK (0x01<<7)
1170
+
1171
+ GRN_API grn_rc grn_obj_set_value(grn_ctx *ctx, grn_obj *obj, grn_id id, grn_obj *value, int flags);
1172
+
1173
+ /**
1174
+ * grn_obj_remove:
1175
+ * @obj: 対象object
1176
+ *
1177
+ * objをメモリから解放し、それが永続オブジェクトであった場合は、
1178
+ * 該当するファイル一式を削除する。
1179
+ **/
1180
+ GRN_API grn_rc grn_obj_remove(grn_ctx *ctx, grn_obj *obj);
1181
+
1182
+ /**
1183
+ * grn_obj_close:
1184
+ * @obj: 対象object
1185
+ *
1186
+ * 一時的なobjectであるobjをメモリから解放する。
1187
+ * objに属するobjectも再帰的にメモリから解放される。
1188
+ * 永続的な、table・column・exprなどは解放してはならない。
1189
+ * 一般的には、一時的か永続的かを気にしなくてよいgrn_obj_unlinkを用いるべき。
1190
+ **/
1191
+ GRN_API grn_rc grn_obj_close(grn_ctx *ctx, grn_obj *obj);
1192
+
1193
+ /**
1194
+ * grn_obj_reinit:
1195
+ * @obj: 対象object
1196
+ * @domain: 変更後のobjの型
1197
+ * @flags: GRN_OBJ_VECTORを指定するとdomain型の値のベクタを格納するオブジェクトになる。
1198
+ *
1199
+ * objの型を変更する。objはGRN_OBJ_INITマクロなどで初期化済みでなければならない。
1200
+ **/
1201
+ GRN_API grn_rc grn_obj_reinit(grn_ctx *ctx, grn_obj *obj, grn_id domain, unsigned char flags);
1202
+
1203
+ /**
1204
+ * grn_obj_unlink:
1205
+ * @obj: 対象object
1206
+ *
1207
+ * objをメモリから解放する。
1208
+ * objに属するobjectも再帰的にメモリから解放される。
1209
+ **/
1210
+ GRN_API void grn_obj_unlink(grn_ctx *ctx, grn_obj *obj);
1211
+
1212
+ /**
1213
+ * grn_obj_user_data
1214
+ * @obj: 対象object
1215
+ *
1216
+ * objectに登録できるユーザデータへのポインタを返す。table, column, proc, exprのみ使用可能。
1217
+ **/
1218
+ GRN_API grn_user_data *grn_obj_user_data(grn_ctx *ctx, grn_obj *obj);
1219
+
1220
+ /**
1221
+ * grn_obj_set_finalizer
1222
+ * @obj: 対象object
1223
+ * @func: objectを破棄するときに呼ばれる関数
1224
+ *
1225
+ * objectを破棄するときに呼ばれる関数を設定する。table, column, proc, exprのみ設定可能。
1226
+ **/
1227
+ GRN_API grn_rc grn_obj_set_finalizer(grn_ctx *ctx, grn_obj *obj, grn_proc_func *func);
1228
+
1229
+ /**
1230
+ * grn_obj_path:
1231
+ * @obj: 対象object
1232
+ *
1233
+ * objに対応するファイルパスを返す。一時objectならNULLを返す。
1234
+ **/
1235
+ GRN_API const char *grn_obj_path(grn_ctx *ctx, grn_obj *obj);
1236
+
1237
+ /**
1238
+ * grn_obj_name:
1239
+ * @obj: 対象object
1240
+ * @namebuf: 名前を格納するバッファ(呼出側で準備する)
1241
+ * @buf_size: namebufのサイズ(byte長)
1242
+ *
1243
+ * objの名前の長さを返す。無名objectなら0を返す。
1244
+ * 名前付きのobjectであり、buf_sizeの長さが名前の長以上であった場合は、
1245
+ * namebufに該当する名前をコピーする。
1246
+ **/
1247
+ GRN_API int grn_obj_name(grn_ctx *ctx, grn_obj *obj, char *namebuf, int buf_size);
1248
+
1249
+ /**
1250
+ * grn_column_name:
1251
+ * @obj: 対象object
1252
+ * @namebuf: 名前を格納するバッファ(呼出側で準備する)
1253
+ * @buf_size: namebufのサイズ(byte長)
1254
+ *
1255
+ * カラムobjの名前の長さを返す。
1256
+ * buf_sizeの長さが名前の長以上であった場合は、
1257
+ * namebufに該当する名前をコピーする。
1258
+ **/
1259
+ GRN_API int grn_column_name(grn_ctx *ctx, grn_obj *obj, char *namebuf, int buf_size);
1260
+
1261
+ /**
1262
+ * grn_obj_get_range:
1263
+ * @obj: 対象object
1264
+ *
1265
+ * @objのとる値の範囲を表わしているオブジェクトのIDを返す。
1266
+ * 例えば、grn_builtin_typeにあるGRN_DB_INTなどを返す。
1267
+ **/
1268
+ GRN_API grn_id grn_obj_get_range(grn_ctx *ctx, grn_obj *obj);
1269
+
1270
+ #define GRN_OBJ_GET_DOMAIN(obj) \
1271
+ ((obj)->header.type == GRN_TABLE_NO_KEY ? GRN_ID_NIL : (obj)->header.domain)
1272
+
1273
+ /**
1274
+ * grn_obj_expire:
1275
+ * @obj: 対象object
1276
+ *
1277
+ * objの占有するメモリのうち、可能な領域をthresholdを指標として解放する。
1278
+ **/
1279
+ GRN_API int grn_obj_expire(grn_ctx *ctx, grn_obj *obj, int threshold);
1280
+
1281
+ /**
1282
+ * grn_obj_check:
1283
+ * @obj: 対象object
1284
+ *
1285
+ * objに対応するファイルの整合性を検査する。
1286
+ **/
1287
+ GRN_API int grn_obj_check(grn_ctx *ctx, grn_obj *obj);
1288
+
1289
+ /**
1290
+ * grn_obj_lock:
1291
+ * @obj: 対象object
1292
+ *
1293
+ * objをlockする。timeout(秒)経過してもlockを取得できない場合は
1294
+ * GRN_RESOURCE_DEADLOCK_AVOIDEDを返す。
1295
+ **/
1296
+ GRN_API grn_rc grn_obj_lock(grn_ctx *ctx, grn_obj *obj, grn_id id, int timeout);
1297
+
1298
+ /**
1299
+ * grn_obj_unlock:
1300
+ * @obj: 対象object
1301
+ *
1302
+ * objをunlockする。
1303
+ **/
1304
+ GRN_API grn_rc grn_obj_unlock(grn_ctx *ctx, grn_obj *obj, grn_id id);
1305
+
1306
+ /**
1307
+ * grn_obj_clear_lock:
1308
+ * @obj: 対象object
1309
+ *
1310
+ * 強制的にロックをクリアする。
1311
+ **/
1312
+ GRN_API grn_rc grn_obj_clear_lock(grn_ctx *ctx, grn_obj *obj);
1313
+
1314
+ /**
1315
+ * grn_obj_is_locked;
1316
+ * @obj: 対象object
1317
+ *
1318
+ * objが現在lockされていれば0以外の値を返す。
1319
+ **/
1320
+ GRN_API unsigned int grn_obj_is_locked(grn_ctx *ctx, grn_obj *obj);
1321
+
1322
+ /**
1323
+ * grn_obj_db:
1324
+ * @obj: 対象object
1325
+ *
1326
+ * objの属するdbを返す。
1327
+ **/
1328
+ GRN_API grn_obj *grn_obj_db(grn_ctx *ctx, grn_obj *obj);
1329
+
1330
+ /**
1331
+ * grn_obj_id:
1332
+ * @obj: 対象object
1333
+ *
1334
+ * objのidを返す。
1335
+ **/
1336
+ GRN_API grn_id grn_obj_id(grn_ctx *ctx, grn_obj *obj);
1337
+
1338
+
1339
+ /**
1340
+ * grn_obj_search:
1341
+ * @obj: 検索対象のobject
1342
+ * @query: 検索クエリ
1343
+ * @res: 検索結果を格納するテーブル
1344
+ * @op: GRN_OP_OR, GRN_OP_AND, GRN_OP_BUT, GRN_OP_ADJUSTのいずれかを指定する
1345
+ * @optarg: 詳細検索条件
1346
+ *
1347
+ * objを対象としてqueryにマッチするレコードを検索し、
1348
+ * opの指定に従ってresにレコードを追加あるいは削除する。
1349
+ **/
1350
+
1351
+ typedef struct _grn_search_optarg grn_search_optarg;
1352
+
1353
+ struct _grn_search_optarg {
1354
+ grn_operator mode;
1355
+ int similarity_threshold;
1356
+ int max_interval;
1357
+ int *weight_vector;
1358
+ int vector_size;
1359
+ grn_obj *proc;
1360
+ int max_size;
1361
+ };
1362
+
1363
+ GRN_API grn_rc grn_obj_search(grn_ctx *ctx, grn_obj *obj, grn_obj *query,
1364
+ grn_obj *res, grn_operator op, grn_search_optarg *optarg);
1365
+
1366
+ /*-------------------------------------------------------------
1367
+ * grn_vector
1368
+ */
1369
+
1370
+ GRN_API unsigned int grn_vector_size(grn_ctx *ctx, grn_obj *vector);
1371
+
1372
+ GRN_API grn_rc grn_vector_add_element(grn_ctx *ctx, grn_obj *vector,
1373
+ const char *str, unsigned int str_len,
1374
+ unsigned int weight, grn_id domain);
1375
+
1376
+ GRN_API unsigned int grn_vector_get_element(grn_ctx *ctx, grn_obj *vector,
1377
+ unsigned int offset, const char **str,
1378
+ unsigned int *weight, grn_id *domain);
1379
+
1380
+ /*-------------------------------------------------------------
1381
+ * hook操作のための関数
1382
+ */
1383
+
1384
+ GRN_API int grn_proc_call_next(grn_ctx *ctx, grn_obj *exec_info, grn_obj *in, grn_obj *out);
1385
+ GRN_API void *grn_proc_get_ctx_local_data(grn_ctx *ctx, grn_obj *exec_info);
1386
+ GRN_API void *grn_proc_get_hook_local_data(grn_ctx *ctx, grn_obj *exec_info);
1387
+
1388
+ typedef enum {
1389
+ GRN_HOOK_SET = 0,
1390
+ GRN_HOOK_GET,
1391
+ GRN_HOOK_INSERT,
1392
+ GRN_HOOK_DELETE,
1393
+ GRN_HOOK_SELECT
1394
+ } grn_hook_entry;
1395
+
1396
+ /**
1397
+ * grn_obj_add_hook:
1398
+ * @obj: 対象object
1399
+ * @entry: GRN_HOOK_GETは、objectの参照時に呼び出されるhookを定義する。
1400
+ GRN_HOOK_SETは、objectの更新時に呼び出されるhookを定義する。
1401
+ GRN_HOOK_SELECTは、検索処理の実行中に適時呼び出され、
1402
+ 処理の実行状況を調べたり、実行の中断を指示することができる。
1403
+ * @offset: hookの実行順位。offsetに対応するhookの直前に新たなhookを挿入する。
1404
+ 0を指定した場合は先頭に挿入される。-1を指定した場合は末尾に挿入される。
1405
+ objectに複数のhookが定義されている場合は順位の順に呼び出される。
1406
+ * @proc: 手続き
1407
+ * @data: hook固有情報
1408
+ *
1409
+ * objに対してhookを追加する。
1410
+ **/
1411
+ GRN_API grn_rc grn_obj_add_hook(grn_ctx *ctx, grn_obj *obj, grn_hook_entry entry,
1412
+ int offset, grn_obj *proc, grn_obj *data);
1413
+
1414
+ /**
1415
+ * grn_obj_get_nhooks:
1416
+ * @obj: 対象object
1417
+ * @entry: hookタイプ
1418
+ *
1419
+ * objに定義されているhookの数を返す。
1420
+ **/
1421
+ GRN_API int grn_obj_get_nhooks(grn_ctx *ctx, grn_obj *obj, grn_hook_entry entry);
1422
+
1423
+ /**
1424
+ * grn_obj_get_hook:
1425
+ * @obj: 対象object
1426
+ * @entry: hookタイプ
1427
+ * @offset: 実行順位
1428
+ * @data: hook固有情報格納バッファ
1429
+ *
1430
+ * objに定義されているhookの手続き(proc)を返す。hook固有情報が定義されている場合は、
1431
+ * その内容をdataにコピーして返す。
1432
+ **/
1433
+ GRN_API grn_obj *grn_obj_get_hook(grn_ctx *ctx, grn_obj *obj, grn_hook_entry entry,
1434
+ int offset, grn_obj *data);
1435
+
1436
+ /**
1437
+ * grn_obj_delete_hook:
1438
+ * @obj: 対象object
1439
+ * @entry: hookタイプ
1440
+ * @offset: 実行順位
1441
+ *
1442
+ * objに定義されているhookを削除する。
1443
+ **/
1444
+ GRN_API grn_rc grn_obj_delete_hook(grn_ctx *ctx, grn_obj *obj, grn_hook_entry entry, int offset);
1445
+
1446
+ GRN_API grn_obj *grn_obj_open(grn_ctx *ctx, unsigned char type, grn_obj_flags flags, grn_id domain);
1447
+
1448
+ /**
1449
+ * grn_column_index:
1450
+ * @column: 対象のcolumn
1451
+ * @op: indexで実行したい操作
1452
+ * @indexbuf: indexを格納するバッファ(呼出側で準備する)
1453
+ * @buf_size: namebufのサイズ(byte長)
1454
+ * @section: section番号を格納するint長バッファ(呼出側で準備する)
1455
+ *
1456
+ * columnに張られているindexのうち、opの操作を実行可能なものの数を返す。
1457
+ * またそれらのidを、buf_sizeに指定された個数を上限としてindexbufに返す。
1458
+ **/
1459
+ GRN_API int grn_column_index(grn_ctx *ctx, grn_obj *column, grn_operator op,
1460
+ grn_obj **indexbuf, int buf_size, int *section);
1461
+
1462
+ /* query & snippet */
1463
+
1464
+ #ifndef GRN_QUERY_AND
1465
+ #define GRN_QUERY_AND '+'
1466
+ #endif /* GRN_QUERY_AND */
1467
+ #ifndef GRN_QUERY_BUT
1468
+ #define GRN_QUERY_BUT '-'
1469
+ #endif /* GRN_QUERY_BUT */
1470
+ #ifndef GRN_QUERY_ADJ_INC
1471
+ #define GRN_QUERY_ADJ_INC '>'
1472
+ #endif /* GRN_QUERY_ADJ_POS2 */
1473
+ #ifndef GRN_QUERY_ADJ_DEC
1474
+ #define GRN_QUERY_ADJ_DEC '<'
1475
+ #endif /* GRN_QUERY_ADJ_POS1 */
1476
+ #ifndef GRN_QUERY_ADJ_NEG
1477
+ #define GRN_QUERY_ADJ_NEG '~'
1478
+ #endif /* GRN_QUERY_ADJ_NEG */
1479
+ #ifndef GRN_QUERY_PREFIX
1480
+ #define GRN_QUERY_PREFIX '*'
1481
+ #endif /* GRN_QUERY_PREFIX */
1482
+ #ifndef GRN_QUERY_PARENL
1483
+ #define GRN_QUERY_PARENL '('
1484
+ #endif /* GRN_QUERY_PARENL */
1485
+ #ifndef GRN_QUERY_PARENR
1486
+ #define GRN_QUERY_PARENR ')'
1487
+ #endif /* GRN_QUERY_PARENR */
1488
+ #ifndef GRN_QUERY_QUOTEL
1489
+ #define GRN_QUERY_QUOTEL '"'
1490
+ #endif /* GRN_QUERY_QUOTEL */
1491
+ #ifndef GRN_QUERY_QUOTER
1492
+ #define GRN_QUERY_QUOTER '"'
1493
+ #endif /* GRN_QUERY_QUOTER */
1494
+ #ifndef GRN_QUERY_ESCAPE
1495
+ #define GRN_QUERY_ESCAPE '\\'
1496
+ #endif /* GRN_QUERY_ESCAPE */
1497
+ #ifndef GRN_QUERY_COLUMN
1498
+ #define GRN_QUERY_COLUMN ':'
1499
+ #endif /* GRN_QUERY_COLUMN */
1500
+
1501
+ typedef struct _grn_snip grn_snip;
1502
+ typedef struct _grn_query grn_query;
1503
+ typedef struct _grn_snip_mapping grn_snip_mapping;
1504
+
1505
+ struct _grn_snip_mapping {
1506
+ void *dummy;
1507
+ };
1508
+
1509
+ GRN_API grn_query *grn_query_open(grn_ctx *ctx, const char *str, unsigned int str_len,
1510
+ grn_operator default_op, int max_exprs);
1511
+ GRN_API unsigned int grn_query_rest(grn_ctx *ctx, grn_query *q, const char ** const rest);
1512
+ GRN_API grn_rc grn_query_close(grn_ctx *ctx, grn_query *q);
1513
+
1514
+ GRN_API grn_rc grn_query_scan(grn_ctx *ctx, grn_query *q, const char **strs, unsigned int *str_lens,
1515
+ unsigned int nstrs, int flags, int *found, int *score);
1516
+ GRN_API grn_snip *grn_query_snip(grn_ctx *ctx, grn_query *query, int flags,
1517
+ unsigned int width, unsigned int max_results,
1518
+ unsigned int n_tags,
1519
+ const char **opentags, unsigned int *opentag_lens,
1520
+ const char **closetags, unsigned int *closetag_lens,
1521
+ grn_snip_mapping *mapping);
1522
+
1523
+ #define GRN_SNIP_NORMALIZE (0x01<<0)
1524
+ #define GRN_SNIP_COPY_TAG (0x01<<1)
1525
+ #define GRN_SNIP_SKIP_LEADING_SPACES (0x01<<2)
1526
+ #define GRN_QUERY_SCAN_NORMALIZE GRN_SNIP_NORMALIZE
1527
+
1528
+ GRN_API grn_snip *grn_snip_open(grn_ctx *ctx, int flags, unsigned int width,
1529
+ unsigned int max_results,
1530
+ const char *defaultopentag, unsigned int defaultopentag_len,
1531
+ const char *defaultclosetag, unsigned int defaultclosetag_len,
1532
+ grn_snip_mapping *mapping);
1533
+ GRN_API grn_rc grn_snip_close(grn_ctx *ctx, grn_snip *snip);
1534
+ GRN_API grn_rc grn_snip_add_cond(grn_ctx *ctx, grn_snip *snip,
1535
+ const char *keyword, unsigned int keyword_len,
1536
+ const char *opentag, unsigned int opentag_len,
1537
+ const char *closetag, unsigned int closetag_len);
1538
+ GRN_API grn_rc grn_snip_exec(grn_ctx *ctx, grn_snip *snip,
1539
+ const char *string, unsigned int string_len,
1540
+ unsigned int *nresults, unsigned int *max_tagged_len);
1541
+ GRN_API grn_rc grn_snip_get_result(grn_ctx *ctx, grn_snip *snip, const unsigned int index,
1542
+ char *result, unsigned int *result_len);
1543
+
1544
+ /* log */
1545
+
1546
+ #define GRN_LOG_TIME (0x01<<0)
1547
+ #define GRN_LOG_TITLE (0x01<<1)
1548
+ #define GRN_LOG_MESSAGE (0x01<<2)
1549
+ #define GRN_LOG_LOCATION (0x01<<3)
1550
+
1551
+ typedef struct _grn_logger_info grn_logger_info;
1552
+
1553
+ struct _grn_logger_info {
1554
+ grn_log_level max_level;
1555
+ int flags;
1556
+ void (*func)(int, const char *, const char *, const char *, const char *, void *);
1557
+ void *func_arg;
1558
+ };
1559
+
1560
+ GRN_API grn_rc grn_logger_info_set(grn_ctx *ctx, const grn_logger_info *info);
1561
+
1562
+ GRN_API void grn_logger_put(grn_ctx *ctx, grn_log_level level,
1563
+ const char *file, int line, const char *func, const char *fmt, ...);
1564
+
1565
+ GRN_API int grn_logger_pass(grn_ctx *ctx, grn_log_level level);
1566
+
1567
+ #ifndef GRN_LOG_DEFAULT_LEVEL
1568
+ #define GRN_LOG_DEFAULT_LEVEL GRN_LOG_NOTICE
1569
+ #endif /* GRN_LOG_DEFAULT_LEVEL */
1570
+
1571
+ #define GRN_LOG(ctx,level,...) do {\
1572
+ if (grn_logger_pass(ctx, level)) {\
1573
+ grn_logger_put(ctx, (level), __FILE__, __LINE__, __FUNCTION__, __VA_ARGS__); \
1574
+ }\
1575
+ } while (0)
1576
+
1577
+ /* grn_bulk */
1578
+
1579
+ #define GRN_BULK_BUFSIZE (sizeof(grn_obj) - sizeof(grn_obj_header))
1580
+ #define GRN_BULK_OUTP(bulk) ((bulk)->header.impl_flags & GRN_OBJ_OUTPLACE)
1581
+ #define GRN_BULK_REWIND(bulk) do {\
1582
+ if (GRN_BULK_OUTP(bulk)) {\
1583
+ (bulk)->u.b.curr = (bulk)->u.b.head;\
1584
+ } else {\
1585
+ (bulk)->header.flags = 0;\
1586
+ }\
1587
+ } while (0)
1588
+ #define GRN_BULK_WSIZE(bulk) \
1589
+ (GRN_BULK_OUTP(bulk)\
1590
+ ? ((bulk)->u.b.tail - (bulk)->u.b.head)\
1591
+ : GRN_BULK_BUFSIZE)
1592
+ #define GRN_BULK_REST(bulk) \
1593
+ (GRN_BULK_OUTP(bulk)\
1594
+ ? ((bulk)->u.b.tail - (bulk)->u.b.curr)\
1595
+ : GRN_BULK_BUFSIZE - (bulk)->header.flags)
1596
+ #define GRN_BULK_VSIZE(bulk) \
1597
+ (GRN_BULK_OUTP(bulk)\
1598
+ ? ((bulk)->u.b.curr - (bulk)->u.b.head)\
1599
+ : (bulk)->header.flags)
1600
+ #define GRN_BULK_EMPTYP(bulk) \
1601
+ (GRN_BULK_OUTP(bulk)\
1602
+ ? ((bulk)->u.b.curr == (bulk)->u.b.head)\
1603
+ : !((bulk)->header.flags))
1604
+ #define GRN_BULK_HEAD(bulk) \
1605
+ (GRN_BULK_OUTP(bulk)\
1606
+ ? ((bulk)->u.b.head)\
1607
+ : (char *)&((bulk)->u.b.head))
1608
+ #define GRN_BULK_CURR(bulk) \
1609
+ (GRN_BULK_OUTP(bulk)\
1610
+ ? ((bulk)->u.b.curr)\
1611
+ : (char *)&((bulk)->u.b.head) + (bulk)->header.flags)
1612
+ #define GRN_BULK_TAIL(bulk) \
1613
+ (GRN_BULK_OUTP(bulk)\
1614
+ ? ((bulk)->u.b.tail)\
1615
+ : (char *)&((bulk)[1]))
1616
+
1617
+ GRN_API grn_rc grn_bulk_reinit(grn_ctx *ctx, grn_obj *bulk, unsigned int size);
1618
+ GRN_API grn_rc grn_bulk_resize(grn_ctx *ctx, grn_obj *bulk, unsigned int newsize);
1619
+ GRN_API grn_rc grn_bulk_write(grn_ctx *ctx, grn_obj *bulk,
1620
+ const char *str, unsigned int len);
1621
+ GRN_API grn_rc grn_bulk_write_from(grn_ctx *ctx, grn_obj *bulk,
1622
+ const char *str, unsigned int from, unsigned int len);
1623
+ GRN_API grn_rc grn_bulk_reserve(grn_ctx *ctx, grn_obj *bulk, unsigned int len);
1624
+ GRN_API grn_rc grn_bulk_space(grn_ctx *ctx, grn_obj *bulk, unsigned int len);
1625
+ GRN_API grn_rc grn_bulk_truncate(grn_ctx *ctx, grn_obj *bulk, unsigned int len);
1626
+ GRN_API grn_rc grn_bulk_fin(grn_ctx *ctx, grn_obj *bulk);
1627
+
1628
+ /* grn_text */
1629
+
1630
+ GRN_API grn_rc grn_text_itoa(grn_ctx *ctx, grn_obj *bulk, int i);
1631
+ GRN_API grn_rc grn_text_itoa_padded(grn_ctx *ctx, grn_obj *bulk, int i, char ch, unsigned int len);
1632
+ GRN_API grn_rc grn_text_lltoa(grn_ctx *ctx, grn_obj *bulk, long long int i);
1633
+ GRN_API grn_rc grn_text_ftoa(grn_ctx *ctx, grn_obj *bulk, double d);
1634
+ GRN_API grn_rc grn_text_itoh(grn_ctx *ctx, grn_obj *bulk, int i, unsigned int len);
1635
+ GRN_API grn_rc grn_text_itob(grn_ctx *ctx, grn_obj *bulk, grn_id id);
1636
+ GRN_API grn_rc grn_text_lltob32h(grn_ctx *ctx, grn_obj *bulk, long long int i);
1637
+ GRN_API grn_rc grn_text_benc(grn_ctx *ctx, grn_obj *bulk, unsigned int v);
1638
+ GRN_API grn_rc grn_text_esc(grn_ctx *ctx, grn_obj *bulk, const char *s, unsigned int len);
1639
+ GRN_API grn_rc grn_text_urlenc(grn_ctx *ctx, grn_obj *buf,
1640
+ const char *str, unsigned int len);
1641
+ GRN_API const char *grn_text_urldec(grn_ctx *ctx, grn_obj *buf,
1642
+ const char *s, const char *e, char d);
1643
+ GRN_API grn_rc grn_text_escape_xml(grn_ctx *ctx, grn_obj *buf,
1644
+ const char *s, unsigned int len);
1645
+ GRN_API grn_rc grn_text_time2rfc1123(grn_ctx *ctx, grn_obj *bulk, int sec);
1646
+
1647
+ typedef struct _grn_obj_format grn_obj_format;
1648
+
1649
+ #define GRN_OBJ_FORMAT_WITH_COLUMN_NAMES (0x01<<0)
1650
+ #define GRN_OBJ_FORMAT_ASARRAY (0x01<<3)
1651
+
1652
+ struct _grn_obj_format {
1653
+ grn_obj columns;
1654
+ const void *min;
1655
+ const void *max;
1656
+ unsigned min_size;
1657
+ unsigned max_size;
1658
+ int nhits;
1659
+ int offset;
1660
+ int limit;
1661
+ int flags;
1662
+ };
1663
+
1664
+ #define GRN_OBJ_FORMAT_INIT(format,format_nhits,format_offset,format_limit) do { \
1665
+ GRN_PTR_INIT(&(format)->columns, GRN_OBJ_VECTOR, GRN_ID_NIL);\
1666
+ (format)->nhits = (format_nhits);\
1667
+ (format)->offset = (format_offset);\
1668
+ (format)->limit = (format_limit);\
1669
+ } while (0)
1670
+
1671
+ #define GRN_OBJ_FORMAT_FIN(ctx,format) do {\
1672
+ int ncolumns = GRN_BULK_VSIZE(&(format)->columns) / sizeof(grn_obj *);\
1673
+ grn_obj **columns = (grn_obj **)GRN_BULK_HEAD(&(format)->columns);\
1674
+ while (ncolumns--) { grn_obj_unlink((ctx), *columns++); }\
1675
+ GRN_OBJ_FIN((ctx), &(format)->columns);\
1676
+ } while (0)
1677
+
1678
+ GRN_API grn_rc grn_text_otoj(grn_ctx *ctx, grn_obj *bulk, grn_obj *obj,
1679
+ grn_obj_format *format);
1680
+
1681
+ /* various values exchanged via grn_obj */
1682
+
1683
+ #define GRN_OBJ_DO_SHALLOW_COPY (GRN_OBJ_REFER|GRN_OBJ_OUTPLACE)
1684
+ #define GRN_OBJ_VECTOR (0x01<<7)
1685
+
1686
+ #define GRN_OBJ_MUTABLE(obj) ((obj) && (obj)->header.type <= GRN_VECTOR)
1687
+
1688
+ #define GRN_VALUE_FIX_SIZE_INIT(obj,flags,domain)\
1689
+ GRN_OBJ_INIT((obj), ((flags) & GRN_OBJ_VECTOR) ? GRN_UVECTOR : GRN_BULK,\
1690
+ ((flags) & GRN_OBJ_DO_SHALLOW_COPY), (domain))
1691
+ #define GRN_VALUE_VAR_SIZE_INIT(obj,flags,domain)\
1692
+ GRN_OBJ_INIT((obj), ((flags) & GRN_OBJ_VECTOR) ? GRN_VECTOR : GRN_BULK,\
1693
+ ((flags) & GRN_OBJ_DO_SHALLOW_COPY), (domain))
1694
+
1695
+ #define GRN_VOID_INIT(obj) GRN_OBJ_INIT((obj), GRN_VOID, 0, GRN_DB_VOID)
1696
+ #define GRN_TEXT_INIT(obj,flags) \
1697
+ GRN_VALUE_VAR_SIZE_INIT(obj, flags, GRN_DB_TEXT)
1698
+ #define GRN_SHORT_TEXT_INIT(obj,flags) \
1699
+ GRN_VALUE_VAR_SIZE_INIT(obj, flags, GRN_DB_SHORT_TEXT)
1700
+ #define GRN_LONG_TEXT_INIT(obj,flags) \
1701
+ GRN_VALUE_VAR_SIZE_INIT(obj, flags, GRN_DB_LONG_TEXT)
1702
+ #define GRN_TEXT_SET_REF(obj,str,len) do {\
1703
+ (obj)->u.b.head = (char *)(str);\
1704
+ (obj)->u.b.curr = (char *)(str) + (len);\
1705
+ } while (0)
1706
+ #define GRN_TEXT_SET(ctx,obj,str,len) do {\
1707
+ if ((obj)->header.impl_flags & GRN_OBJ_REFER) {\
1708
+ GRN_TEXT_SET_REF((obj), (str), (len));\
1709
+ } else {\
1710
+ grn_bulk_write_from((ctx), (obj), (const char *)(str), 0, (unsigned int)(len));\
1711
+ }\
1712
+ } while (0)
1713
+ #define GRN_TEXT_PUT(ctx,obj,str,len) \
1714
+ grn_bulk_write((ctx), (obj), (const char *)(str), (unsigned int)(len))
1715
+ #define GRN_TEXT_PUTC(ctx,obj,c) do {\
1716
+ char _c = (c); grn_bulk_write((ctx), (obj), &_c, 1);\
1717
+ } while (0)
1718
+
1719
+ #define GRN_TEXT_PUTS(ctx,obj,str) GRN_TEXT_PUT((ctx), (obj), (str), strlen(str))
1720
+ #define GRN_TEXT_SETS(ctx,obj,str) GRN_TEXT_SET((ctx), (obj), (str), strlen(str))
1721
+ #define GRN_TEXT_VALUE(obj) GRN_BULK_HEAD(obj)
1722
+ #define GRN_TEXT_LEN(obj) GRN_BULK_VSIZE(obj)
1723
+
1724
+ #define GRN_BOOL_INIT(obj,flags) \
1725
+ GRN_VALUE_FIX_SIZE_INIT(obj, flags, GRN_DB_BOOL)
1726
+ #define GRN_INT8_INIT(obj,flags) \
1727
+ GRN_VALUE_FIX_SIZE_INIT(obj, flags, GRN_DB_INT8)
1728
+ #define GRN_UINT8_INIT(obj,flags) \
1729
+ GRN_VALUE_FIX_SIZE_INIT(obj, flags, GRN_DB_UINT8)
1730
+ #define GRN_INT16_INIT(obj,flags) \
1731
+ GRN_VALUE_FIX_SIZE_INIT(obj, flags, GRN_DB_INT16)
1732
+ #define GRN_UINT16_INIT(obj,flags) \
1733
+ GRN_VALUE_FIX_SIZE_INIT(obj, flags, GRN_DB_UINT16)
1734
+ #define GRN_INT32_INIT(obj,flags) \
1735
+ GRN_VALUE_FIX_SIZE_INIT(obj, flags, GRN_DB_INT32)
1736
+ #define GRN_UINT32_INIT(obj,flags) \
1737
+ GRN_VALUE_FIX_SIZE_INIT(obj, flags, GRN_DB_UINT32)
1738
+ #define GRN_INT64_INIT(obj,flags) \
1739
+ GRN_VALUE_FIX_SIZE_INIT(obj, flags, GRN_DB_INT64)
1740
+ #define GRN_UINT64_INIT(obj,flags) \
1741
+ GRN_VALUE_FIX_SIZE_INIT(obj, flags, GRN_DB_UINT64)
1742
+ #define GRN_FLOAT_INIT(obj,flags) \
1743
+ GRN_VALUE_FIX_SIZE_INIT(obj, flags, GRN_DB_FLOAT)
1744
+ #define GRN_TIME_INIT(obj,flags) \
1745
+ GRN_VALUE_FIX_SIZE_INIT(obj, flags, GRN_DB_TIME)
1746
+ #define GRN_RECORD_INIT GRN_VALUE_FIX_SIZE_INIT
1747
+ #define GRN_PTR_INIT(obj,flags,domain)\
1748
+ GRN_OBJ_INIT((obj), ((flags) & GRN_OBJ_VECTOR) ? GRN_PVECTOR : GRN_PTR,\
1749
+ ((flags) & GRN_OBJ_DO_SHALLOW_COPY), (domain))
1750
+
1751
+ #define GRN_BOOL_SET(ctx,obj,val) do {\
1752
+ unsigned char _val = (unsigned char)(val);\
1753
+ grn_bulk_write_from((ctx), (obj), (char *)&_val, 0, sizeof(unsigned char));\
1754
+ } while (0)
1755
+ #define GRN_INT8_SET(ctx,obj,val) do {\
1756
+ signed char _val = (signed char)(val);\
1757
+ grn_bulk_write_from((ctx), (obj), (char *)&_val, 0, sizeof(signed char));\
1758
+ } while (0)
1759
+ #define GRN_UINT8_SET(ctx,obj,val) do {\
1760
+ unsigned char _val = (unsigned char)(val);\
1761
+ grn_bulk_write_from((ctx), (obj), (char *)&_val, 0, sizeof(unsigned char));\
1762
+ } while (0)
1763
+ #define GRN_INT16_SET(ctx,obj,val) do {\
1764
+ signed short _val = (signed short)(val);\
1765
+ grn_bulk_write_from((ctx), (obj), (char *)&_val, 0, sizeof(signed short));\
1766
+ } while (0)
1767
+ #define GRN_UINT16_SET(ctx,obj,val) do {\
1768
+ unsigned short _val = (unsigned short)(val);\
1769
+ grn_bulk_write_from((ctx), (obj), (char *)&_val, 0, sizeof(unsigned short));\
1770
+ } while (0)
1771
+ #define GRN_INT32_SET(ctx,obj,val) do {\
1772
+ int _val = (int)(val);\
1773
+ grn_bulk_write_from((ctx), (obj), (char *)&_val, 0, sizeof(int));\
1774
+ } while (0)
1775
+ #define GRN_UINT32_SET(ctx,obj,val) do {\
1776
+ unsigned int _val = (unsigned int)(val);\
1777
+ grn_bulk_write_from((ctx), (obj), (char *)&_val, 0, sizeof(unsigned int));\
1778
+ } while (0)
1779
+ #define GRN_INT64_SET(ctx,obj,val) do {\
1780
+ long long int _val = (long long int)(val);\
1781
+ grn_bulk_write_from((ctx), (obj), (char *)&_val, 0, sizeof(long long int));\
1782
+ } while (0)
1783
+ #define GRN_UINT64_SET(ctx,obj,val) do {\
1784
+ long long unsigned int _val = (long long unsigned int)(val);\
1785
+ grn_bulk_write_from((ctx), (obj), (char *)&_val, 0, sizeof(long long unsigned int));\
1786
+ } while (0)
1787
+ #define GRN_FLOAT_SET(ctx,obj,val) do {\
1788
+ double _val = (double)(val);\
1789
+ grn_bulk_write_from((ctx), (obj), (char *)&_val, 0, sizeof(double));\
1790
+ } while (0)
1791
+ #define GRN_TIME_SET GRN_INT64_SET
1792
+ #define GRN_RECORD_SET(ctx,obj,val) do {\
1793
+ grn_id _val = (grn_id)(val);\
1794
+ grn_bulk_write_from((ctx), (obj), (char *)&_val, 0, sizeof(grn_id));\
1795
+ } while (0)
1796
+ #define GRN_PTR_SET(ctx,obj,val) do {\
1797
+ grn_obj *_val = (grn_obj *)(val);\
1798
+ grn_bulk_write_from((ctx), (obj), (char *)&_val, 0, sizeof(grn_obj *));\
1799
+ } while (0)
1800
+
1801
+ #define GRN_BOOL_SET_AT(ctx,obj,offset,val) do {\
1802
+ unsigned char _val = (unsigned char)(val);\
1803
+ grn_bulk_write_from((ctx), (obj), (char *)&_val,\
1804
+ (offset), sizeof(unsigned char));\
1805
+ } while (0)
1806
+ #define GRN_INT8_SET_AT(ctx,obj,offset,val) do {\
1807
+ signed char _val = (signed char)(val);\
1808
+ grn_bulk_write_from((ctx), (obj), (char *)&_val,\
1809
+ (offset) * sizeof(signed char), sizeof(signed char));\
1810
+ } while (0)
1811
+ #define GRN_UINT8_SET_AT(ctx,obj,offset,val) do { \
1812
+ unsigned char _val = (unsigned char)(val);\
1813
+ grn_bulk_write_from((ctx), (obj), (char *)&_val,\
1814
+ (offset) * sizeof(unsigned char), sizeof(unsigned char));\
1815
+ } while (0)
1816
+ #define GRN_INT16_SET_AT(ctx,obj,offset,val) do {\
1817
+ signed short _val = (signed short)(val);\
1818
+ grn_bulk_write_from((ctx), (obj), (char *)&_val,\
1819
+ (offset) * sizeof(signed short), sizeof(signed short));\
1820
+ } while (0)
1821
+ #define GRN_UINT16_SET_AT(ctx,obj,offset,val) do { \
1822
+ unsigned short _val = (unsigned short)(val);\
1823
+ grn_bulk_write_from((ctx), (obj), (char *)&_val,\
1824
+ (offset) * sizeof(unsigned short), sizeof(unsigned short));\
1825
+ } while (0)
1826
+ #define GRN_INT32_SET_AT(ctx,obj,offset,val) do {\
1827
+ int _val = (int)(val);\
1828
+ grn_bulk_write_from((ctx), (obj), (char *)&_val,\
1829
+ (offset) * sizeof(int), sizeof(int));\
1830
+ } while (0)
1831
+ #define GRN_UINT32_SET_AT(ctx,obj,offset,val) do { \
1832
+ unsigned int _val = (unsigned int)(val);\
1833
+ grn_bulk_write_from((ctx), (obj), (char *)&_val,\
1834
+ (offset) * sizeof(unsigned int), sizeof(unsigned int));\
1835
+ } while (0)
1836
+ #define GRN_INT64_SET_AT(ctx,obj,offset,val) do {\
1837
+ long long int _val = (long long int)(val);\
1838
+ grn_bulk_write_from((ctx), (obj), (char *)&_val,\
1839
+ (offset) * sizeof(long long int), sizeof(long long int));\
1840
+ } while (0)
1841
+ #define GRN_UINT64_SET_AT(ctx,obj,offset,val) do {\
1842
+ long long unsigned int _val = (long long unsigned int)(val);\
1843
+ grn_bulk_write_from((ctx), (obj), (char *)&_val,\
1844
+ (offset) * sizeof(long long unsigned int),\
1845
+ sizeof(long long unsigned int));\
1846
+ } while (0)
1847
+ #define GRN_FLOAT_SET_AT(ctx,obj,offset,val) do {\
1848
+ double _val = (double)(val);\
1849
+ grn_bulk_write_from((ctx), (obj), (char *)&_val,\
1850
+ (offset) * sizeof(double), sizeof(double));\
1851
+ } while (0)
1852
+ #define GRN_TIME_SET_AT GRN_INT64_SET_AT
1853
+ #define GRN_RECORD_SET_AT(ctx,obj,offset,val) do {\
1854
+ grn_id _val = (grn_id)(val);\
1855
+ grn_bulk_write_from((ctx), (obj), (char *)&_val,\
1856
+ (offset) * sizeof(grn_id), sizeof(grn_id));\
1857
+ } while (0)
1858
+ #define GRN_PTR_SET_AT(ctx,obj,offset,val) do {\
1859
+ grn_obj *_val = (grn_obj *)(val);\
1860
+ grn_bulk_write_from((ctx), (obj), (char *)&_val,\
1861
+ (offset) * sizeof(grn_obj *), sizeof(grn_obj *));\
1862
+ } while (0)
1863
+
1864
+ #define GRN_TIME_USEC_PER_SEC 1000000
1865
+ #define GRN_TIME_PACK(sec, usec) ((long long int)(sec) * GRN_TIME_USEC_PER_SEC + (usec))
1866
+ #define GRN_TIME_UNPACK(time_value, sec, usec) do {\
1867
+ sec = (time_value) / GRN_TIME_USEC_PER_SEC;\
1868
+ usec = (time_value) % GRN_TIME_USEC_PER_SEC;\
1869
+ } while (0)
1870
+
1871
+ GRN_API void grn_time_now(grn_ctx *ctx, grn_obj *obj);
1872
+
1873
+ #define GRN_TIME_NOW(ctx,obj) (grn_time_now((ctx), (obj)))
1874
+
1875
+ #define GRN_BOOL_VALUE(obj) (*((unsigned char *)GRN_BULK_HEAD(obj)))
1876
+ #define GRN_INT8_VALUE(obj) (*((signed char *)GRN_BULK_HEAD(obj)))
1877
+ #define GRN_UINT8_VALUE(obj) (*((unsigned char *)GRN_BULK_HEAD(obj)))
1878
+ #define GRN_INT16_VALUE(obj) (*((signed short *)GRN_BULK_HEAD(obj)))
1879
+ #define GRN_UINT16_VALUE(obj) (*((unsigned short *)GRN_BULK_HEAD(obj)))
1880
+ #define GRN_INT32_VALUE(obj) (*((int *)GRN_BULK_HEAD(obj)))
1881
+ #define GRN_UINT32_VALUE(obj) (*((unsigned int *)GRN_BULK_HEAD(obj)))
1882
+ #define GRN_INT64_VALUE(obj) (*((long long int *)GRN_BULK_HEAD(obj)))
1883
+ #define GRN_UINT64_VALUE(obj) (*((long long unsigned int *)GRN_BULK_HEAD(obj)))
1884
+ #define GRN_FLOAT_VALUE(obj) (*((double *)GRN_BULK_HEAD(obj)))
1885
+ #define GRN_TIME_VALUE GRN_INT64_VALUE
1886
+ #define GRN_RECORD_VALUE(obj) (*((grn_id *)GRN_BULK_HEAD(obj)))
1887
+ #define GRN_PTR_VALUE(obj) (*((grn_obj **)GRN_BULK_HEAD(obj)))
1888
+
1889
+ #define GRN_BOOL_VALUE_AT(obj,offset) (((unsigned char *)GRN_BULK_HEAD(obj))[offset])
1890
+ #define GRN_INT8_VALUE_AT(obj,offset) (((signed char *)GRN_BULK_HEAD(obj))[offset])
1891
+ #define GRN_UINT8_VALUE_AT(obj,offset) (((unsigned char *)GRN_BULK_HEAD(obj))[offset])
1892
+ #define GRN_INT16_VALUE_AT(obj,offset) (((signed short *)GRN_BULK_HEAD(obj))[offset])
1893
+ #define GRN_UINT16_VALUE_AT(obj,offset) (((unsigned short *)GRN_BULK_HEAD(obj))[offset])
1894
+ #define GRN_INT32_VALUE_AT(obj,offset) (((int *)GRN_BULK_HEAD(obj))[offset])
1895
+ #define GRN_UINT32_VALUE_AT(obj,offset) (((unsigned int *)GRN_BULK_HEAD(obj))[offset])
1896
+ #define GRN_INT64_VALUE_AT(obj,offset) (((long long int *)GRN_BULK_HEAD(obj))[offset])
1897
+ #define GRN_UINT64_VALUE_AT(obj,offset) (((long long unsigned int *)GRN_BULK_HEAD(obj))[offset])
1898
+ #define GRN_FLOAT_VALUE_AT(ob,offsetj) (((double *)GRN_BULK_HEAD(obj))[offset])
1899
+ #define GRN_TIME_VALUE_AT GRN_INT64_VALUE_AT
1900
+ #define GRN_RECORD_VALUE_AT(obj,offset) (((grn_id *)GRN_BULK_HEAD(obj))[offset])
1901
+ #define GRN_PTR_VALUE_AT(obj,offset) (((grn_obj **)GRN_BULK_HEAD(obj))[offset])
1902
+
1903
+ #define GRN_BOOL_PUT(ctx,obj,val) do {\
1904
+ unsigned char _val = (unsigned char)(val);\
1905
+ grn_bulk_write((ctx), (obj), (char *)&_val, sizeof(unsigned char));\
1906
+ } while (0)
1907
+ #define GRN_INT8_PUT(ctx,obj,val) do {\
1908
+ signed char _val = (signed char)(val); grn_bulk_write((ctx), (obj), (char *)&_val, sizeof(signed char));\
1909
+ } while (0)
1910
+ #define GRN_UINT8_PUT(ctx,obj,val) do {\
1911
+ unsigned char _val = (unsigned char)(val);\
1912
+ grn_bulk_write((ctx), (obj), (char *)&_val, sizeof(unsigned char));\
1913
+ } while (0)
1914
+ #define GRN_INT16_PUT(ctx,obj,val) do {\
1915
+ signed short _val = (signed short)(val); grn_bulk_write((ctx), (obj), (char *)&_val, sizeof(signed short));\
1916
+ } while (0)
1917
+ #define GRN_UINT16_PUT(ctx,obj,val) do {\
1918
+ unsigned short _val = (unsigned short)(val);\
1919
+ grn_bulk_write((ctx), (obj), (char *)&_val, sizeof(unsigned short));\
1920
+ } while (0)
1921
+ #define GRN_INT32_PUT(ctx,obj,val) do {\
1922
+ int _val = (int)(val); grn_bulk_write((ctx), (obj), (char *)&_val, sizeof(int));\
1923
+ } while (0)
1924
+ #define GRN_UINT32_PUT(ctx,obj,val) do {\
1925
+ unsigned int _val = (unsigned int)(val);\
1926
+ grn_bulk_write((ctx), (obj), (char *)&_val, sizeof(unsigned int));\
1927
+ } while (0)
1928
+ #define GRN_INT64_PUT(ctx,obj,val) do {\
1929
+ long long int _val = (long long int)(val);\
1930
+ grn_bulk_write((ctx), (obj), (char *)&_val, sizeof(long long int));\
1931
+ } while (0)
1932
+ #define GRN_UINT64_PUT(ctx,obj,val) do {\
1933
+ long long unsigned int _val = (long long unsigned int)(val);\
1934
+ grn_bulk_write((ctx), (obj), (char *)&_val, sizeof(long long unsigned int));\
1935
+ } while (0)
1936
+ #define GRN_FLOAT_PUT(ctx,obj,val) do {\
1937
+ double _val = (double)(val); grn_bulk_write((ctx), (obj), (char *)&_val, sizeof(double));\
1938
+ } while (0)
1939
+ #define GRN_TIME_PUT GRN_INT64_PUT
1940
+ #define GRN_RECORD_PUT(ctx,obj,val) do {\
1941
+ grn_id _val = (grn_id)(val); grn_bulk_write((ctx), (obj), (char *)&_val, sizeof(grn_id));\
1942
+ } while (0)
1943
+ #define GRN_PTR_PUT(ctx,obj,val) do {\
1944
+ grn_obj *_val = (grn_obj *)(val);\
1945
+ grn_bulk_write((ctx), (obj), (char *)&_val, sizeof(grn_obj *));\
1946
+ } while (0)
1947
+
1948
+ /* grn_str */
1949
+
1950
+ typedef struct {
1951
+ const char *orig;
1952
+ char *norm;
1953
+ short *checks;
1954
+ unsigned char *ctypes;
1955
+ int flags;
1956
+ unsigned int orig_blen;
1957
+ unsigned int norm_blen;
1958
+ unsigned int length;
1959
+ grn_encoding encoding;
1960
+ } grn_str;
1961
+
1962
+ #define GRN_STR_REMOVEBLANK (0x01<<0)
1963
+ #define GRN_STR_WITH_CTYPES (0x01<<1)
1964
+ #define GRN_STR_WITH_CHECKS (0x01<<2)
1965
+ #define GRN_STR_NORMALIZE GRN_OBJ_KEY_NORMALIZE
1966
+
1967
+ GRN_API grn_str *grn_str_open(grn_ctx *ctx, const char *str, unsigned int str_len,
1968
+ int flags);
1969
+ GRN_API grn_rc grn_str_close(grn_ctx *ctx, grn_str *nstr);
1970
+
1971
+ GRN_API int grn_charlen(grn_ctx *ctx, const char *str, const char *end);
1972
+
1973
+ /* expr */
1974
+
1975
+ GRN_API grn_obj *grn_expr_create(grn_ctx *ctx, const char *name, unsigned name_size);
1976
+ GRN_API grn_rc grn_expr_close(grn_ctx *ctx, grn_obj *expr);
1977
+ GRN_API grn_obj *grn_expr_add_var(grn_ctx *ctx, grn_obj *expr,
1978
+ const char *name, unsigned name_size);
1979
+ GRN_API grn_obj *grn_expr_get_var(grn_ctx *ctx, grn_obj *expr,
1980
+ const char *name, unsigned name_size);
1981
+ GRN_API grn_obj *grn_expr_get_var_by_offset(grn_ctx *ctx, grn_obj *expr, unsigned int offset);
1982
+
1983
+ GRN_API grn_obj *grn_expr_append_obj(grn_ctx *ctx, grn_obj *expr, grn_obj *obj,
1984
+ grn_operator op, int nargs);
1985
+ GRN_API grn_obj *grn_expr_append_const(grn_ctx *ctx, grn_obj *expr, grn_obj *obj,
1986
+ grn_operator op, int nargs);
1987
+ GRN_API grn_obj *grn_expr_append_const_str(grn_ctx *ctx, grn_obj *expr,
1988
+ const char *str, unsigned str_size,
1989
+ grn_operator op, int nargs);
1990
+ GRN_API grn_obj *grn_expr_append_const_int(grn_ctx *ctx, grn_obj *expr, int i,
1991
+ grn_operator op, int nargs);
1992
+ GRN_API grn_rc grn_expr_append_op(grn_ctx *ctx, grn_obj *expr, grn_operator op, int nargs);
1993
+
1994
+ GRN_API grn_rc grn_expr_compile(grn_ctx *ctx, grn_obj *expr);
1995
+ GRN_API grn_rc grn_expr_exec(grn_ctx *ctx, grn_obj *expr, int nargs);
1996
+ GRN_API grn_rc grn_ctx_push(grn_ctx *ctx, grn_obj *obj);
1997
+ GRN_API grn_obj *grn_ctx_pop(grn_ctx *ctx);
1998
+
1999
+ #define GRN_EXPR_CALL(ctx,expr,nargs) \
2000
+ (grn_expr_exec((ctx), (expr), (nargs)), grn_ctx_pop(ctx))
2001
+
2002
+ GRN_API grn_obj *grn_expr_alloc(grn_ctx *ctx, grn_obj *expr,
2003
+ grn_id domain, grn_obj_flags flags);
2004
+
2005
+ GRN_API grn_obj *grn_table_select(grn_ctx *ctx, grn_obj *table, grn_obj *expr,
2006
+ grn_obj *res, grn_operator op);
2007
+
2008
+ GRN_API int grn_obj_columns(grn_ctx *ctx, grn_obj *table,
2009
+ const char *str, unsigned str_size, grn_obj *res);
2010
+
2011
+ #define GRN_EXPR_CREATE_FOR_QUERY(ctx,table,expr,var) \
2012
+ if (((expr) = grn_expr_create((ctx), NULL, 0)) &&\
2013
+ ((var) = grn_expr_add_var((ctx), (expr), NULL, 0))) {\
2014
+ GRN_RECORD_INIT((var), 0, grn_obj_id((ctx), (table)));\
2015
+ } else {\
2016
+ (var) = NULL;\
2017
+ }
2018
+
2019
+ typedef unsigned int grn_expr_flags;
2020
+
2021
+ #define GRN_EXPR_SYNTAX_QUERY (0x00)
2022
+ #define GRN_EXPR_SYNTAX_SCRIPT (0x01)
2023
+ #define GRN_EXPR_ALLOW_PRAGMA (0x02)
2024
+ #define GRN_EXPR_ALLOW_COLUMN (0x04)
2025
+ #define GRN_EXPR_ALLOW_UPDATE (0x08)
2026
+
2027
+ GRN_API grn_rc grn_expr_parse(grn_ctx *ctx, grn_obj *expr,
2028
+ const char *str, unsigned str_size,
2029
+ grn_obj *default_column, grn_operator default_mode,
2030
+ grn_operator default_op, grn_expr_flags flags);
2031
+
2032
+ GRN_API grn_snip *grn_expr_snip(grn_ctx *ctx, grn_obj *expr, int flags,
2033
+ unsigned int width, unsigned int max_results,
2034
+ unsigned int n_tags,
2035
+ const char **opentags, unsigned int *opentag_lens,
2036
+ const char **closetags, unsigned int *closetag_lens,
2037
+ grn_snip_mapping *mapping);
2038
+
2039
+ GRN_API grn_table_sort_key *grn_table_sort_key_from_str(grn_ctx *ctx,
2040
+ const char *str, unsigned str_size,
2041
+ grn_obj *table, unsigned *nkeys);
2042
+ GRN_API grn_rc grn_table_sort_key_close(grn_ctx *ctx,
2043
+ grn_table_sort_key *keys, unsigned nkeys);
2044
+
2045
+ GRN_API grn_rc grn_select(grn_ctx *ctx, grn_obj *outbuf, grn_content_type output_type,
2046
+ const char *table, unsigned table_len,
2047
+ const char *match_columns, unsigned match_columns_len,
2048
+ const char *query, unsigned query_len,
2049
+ const char *filter, unsigned filter_len,
2050
+ const char *scorer, unsigned scorer_len,
2051
+ const char *sortby, unsigned sortby_len,
2052
+ const char *output_columns, unsigned output_columns_len,
2053
+ int offset, int hits,
2054
+ const char *drilldown, unsigned drilldown_len,
2055
+ const char *drilldown_sortby, unsigned drilldown_sortby_len,
2056
+ const char *drilldown_output_columns,
2057
+ unsigned drilldown_output_columns_len,
2058
+ int drilldown_offset, int drilldown_hits);
2059
+
2060
+ GRN_API grn_rc grn_load(grn_ctx *ctx, grn_content_type input_type,
2061
+ const char *table, unsigned table_len,
2062
+ const char *columns, unsigned columns_len,
2063
+ const char *values, unsigned values_len,
2064
+ const char *ifexists, unsigned ifexists_len);
2065
+
2066
+ #define GRN_CTX_MORE (0x01<<0)
2067
+ #define GRN_CTX_TAIL (0x01<<1)
2068
+ #define GRN_CTX_HEAD (0x01<<2)
2069
+ #define GRN_CTX_QUIET (0x01<<3)
2070
+ #define GRN_CTX_QUIT (0x01<<4)
2071
+
2072
+ GRN_API grn_rc grn_ctx_connect(grn_ctx *ctx, const char *host, int port, int flags);
2073
+ GRN_API unsigned grn_ctx_send(grn_ctx *ctx, char *str, unsigned int str_len, int flags);
2074
+ GRN_API unsigned grn_ctx_recv(grn_ctx *ctx, char **str, unsigned int *str_len, int *flags);
2075
+
2076
+ typedef struct _grn_ctx_info grn_ctx_info;
2077
+
2078
+ struct _grn_ctx_info {
2079
+ int fd;
2080
+ unsigned int com_status;
2081
+ grn_obj *outbuf;
2082
+ unsigned char stat;
2083
+ };
2084
+
2085
+ GRN_API grn_rc grn_ctx_info_get(grn_ctx *ctx, grn_ctx_info *info);
2086
+
2087
+ GRN_API grn_rc grn_set_segv_handler(void);
2088
+
2089
+ /* hash */
2090
+
2091
+ typedef struct _grn_hash grn_hash;
2092
+ typedef struct _grn_hash_cursor grn_hash_cursor;
2093
+
2094
+ GRN_API grn_hash *grn_hash_create(grn_ctx *ctx, const char *path, unsigned int key_size,
2095
+ unsigned int value_size, unsigned int flags);
2096
+
2097
+ GRN_API grn_hash *grn_hash_open(grn_ctx *ctx, const char *path);
2098
+
2099
+ GRN_API grn_rc grn_hash_close(grn_ctx *ctx, grn_hash *hash);
2100
+
2101
+ GRN_API grn_id grn_hash_add(grn_ctx *ctx, grn_hash *hash, const void *key,
2102
+ unsigned int key_size, void **value, int *added);
2103
+ GRN_API grn_id grn_hash_get(grn_ctx *ctx, grn_hash *hash, const void *key,
2104
+ unsigned int key_size, void **value);
2105
+
2106
+ GRN_API int grn_hash_get_key(grn_ctx *ctx, grn_hash *hash, grn_id id, void *keybuf, int bufsize);
2107
+ GRN_API int grn_hash_get_key2(grn_ctx *ctx, grn_hash *hash, grn_id id, grn_obj *bulk);
2108
+ GRN_API int grn_hash_get_value(grn_ctx *ctx, grn_hash *hash, grn_id id, void *valuebuf);
2109
+ GRN_API grn_rc grn_hash_set_value(grn_ctx *ctx, grn_hash *hash, grn_id id, void *value,
2110
+ int flags);
2111
+
2112
+ typedef struct _grn_table_delete_optarg grn_table_delete_optarg;
2113
+
2114
+ struct _grn_table_delete_optarg {
2115
+ int flags;
2116
+ int (*func)(grn_ctx *ctx, grn_obj *, grn_id, void *);
2117
+ void *func_arg;
2118
+ };
2119
+
2120
+ GRN_API grn_rc grn_hash_delete_by_id(grn_ctx *ctx, grn_hash *hash, grn_id id,
2121
+ grn_table_delete_optarg *optarg);
2122
+ GRN_API grn_rc grn_hash_delete(grn_ctx *ctx, grn_hash *hash,
2123
+ const void *key, unsigned int key_size,
2124
+ grn_table_delete_optarg *optarg);
2125
+
2126
+ GRN_API grn_hash_cursor *grn_hash_cursor_open(grn_ctx *ctx, grn_hash *hash,
2127
+ const void *min, unsigned int min_size,
2128
+ const void *max, unsigned int max_size,
2129
+ int offset, int limit, int flags);
2130
+ GRN_API grn_id grn_hash_cursor_next(grn_ctx *ctx, grn_hash_cursor *c);
2131
+ GRN_API void grn_hash_cursor_close(grn_ctx *ctx, grn_hash_cursor *c);
2132
+
2133
+ GRN_API int grn_hash_cursor_get_key(grn_ctx *ctx, grn_hash_cursor *c, void **key);
2134
+ GRN_API int grn_hash_cursor_get_value(grn_ctx *ctx, grn_hash_cursor *c, void **value);
2135
+ GRN_API grn_rc grn_hash_cursor_set_value(grn_ctx *ctx, grn_hash_cursor *c,
2136
+ void *value, int flags);
2137
+
2138
+ GRN_API int grn_hash_cursor_get_key_value(grn_ctx *ctx, grn_hash_cursor *c,
2139
+ void **key, unsigned int *key_size, void **value);
2140
+
2141
+ GRN_API grn_rc grn_hash_cursor_delete(grn_ctx *ctx, grn_hash_cursor *c,
2142
+ grn_table_delete_optarg *optarg);
2143
+
2144
+ #define GRN_HASH_EACH(ctx,hash,id,key,key_size,value,block) do {\
2145
+ grn_hash_cursor *_sc = grn_hash_cursor_open(ctx, hash, NULL, 0, NULL, 0, 0, -1, 0); \
2146
+ if (_sc) {\
2147
+ grn_id id;\
2148
+ while ((id = grn_hash_cursor_next(ctx, _sc))) {\
2149
+ grn_hash_cursor_get_key_value(ctx, _sc, (void **)(key),\
2150
+ (key_size), (void **)(value));\
2151
+ block\
2152
+ }\
2153
+ grn_hash_cursor_close(ctx, _sc);\
2154
+ }\
2155
+ } while (0)
2156
+
2157
+ /* array */
2158
+
2159
+ typedef struct _grn_array grn_array;
2160
+ typedef struct _grn_array_cursor grn_array_cursor;
2161
+
2162
+ GRN_API grn_array *grn_array_create(grn_ctx *ctx, const char *path,
2163
+ unsigned value_size, unsigned flags);
2164
+ GRN_API grn_array *grn_array_open(grn_ctx *ctx, const char *path);
2165
+ GRN_API grn_rc grn_array_close(grn_ctx *ctx, grn_array *array);
2166
+ GRN_API grn_id grn_array_add(grn_ctx *ctx, grn_array *array, void **value);
2167
+ GRN_API int grn_array_get_value(grn_ctx *ctx, grn_array *array, grn_id id, void *valuebuf);
2168
+ GRN_API grn_rc grn_array_set_value(grn_ctx *ctx, grn_array *array, grn_id id,
2169
+ void *value, int flags);
2170
+ GRN_API grn_array_cursor *grn_array_cursor_open(grn_ctx *ctx, grn_array *array,
2171
+ grn_id min, grn_id max,
2172
+ int offset, int limit, int flags);
2173
+ GRN_API grn_id grn_array_cursor_next(grn_ctx *ctx, grn_array_cursor *c);
2174
+ GRN_API int grn_array_cursor_get_value(grn_ctx *ctx, grn_array_cursor *c, void **value);
2175
+ GRN_API grn_rc grn_array_cursor_set_value(grn_ctx *ctx, grn_array_cursor *c,
2176
+ void *value, int flags);
2177
+ GRN_API grn_rc grn_array_cursor_delete(grn_ctx *ctx, grn_array_cursor *c,
2178
+ grn_table_delete_optarg *optarg);
2179
+ GRN_API void grn_array_cursor_close(grn_ctx *ctx, grn_array_cursor *c);
2180
+ GRN_API grn_rc grn_array_delete_by_id(grn_ctx *ctx, grn_array *array, grn_id id,
2181
+ grn_table_delete_optarg *optarg);
2182
+
2183
+ GRN_API grn_id grn_array_next(grn_ctx *ctx, grn_array *array, grn_id id);
2184
+
2185
+ GRN_API void *_grn_array_get_value(grn_ctx *ctx, grn_array *array, grn_id id);
2186
+
2187
+ #define GRN_ARRAY_EACH(ctx,array,head,tail,id,value,block) do {\
2188
+ grn_array_cursor *_sc = grn_array_cursor_open(ctx, array, head, tail, 0, -1, 0); \
2189
+ if (_sc) {\
2190
+ grn_id id;\
2191
+ while ((id = grn_array_cursor_next(ctx, _sc))) {\
2192
+ grn_array_cursor_get_value(ctx, _sc, (void **)(value));\
2193
+ block\
2194
+ }\
2195
+ grn_array_cursor_close(ctx, _sc); \
2196
+ }\
2197
+ } while (0)
2198
+
2199
+ /* pat */
2200
+
2201
+ typedef struct _grn_pat grn_pat;
2202
+ typedef struct _grn_pat_cursor grn_pat_cursor;
2203
+
2204
+ GRN_API grn_pat *grn_pat_create(grn_ctx *ctx, const char *path, unsigned int key_size,
2205
+ unsigned int value_size, unsigned int flags);
2206
+
2207
+ GRN_API grn_pat *grn_pat_open(grn_ctx *ctx, const char *path);
2208
+
2209
+ GRN_API grn_rc grn_pat_close(grn_ctx *ctx, grn_pat *pat);
2210
+
2211
+ GRN_API grn_rc grn_pat_remove(grn_ctx *ctx, const char *path);
2212
+
2213
+ GRN_API grn_id grn_pat_get(grn_ctx *ctx, grn_pat *pat, const void *key,
2214
+ unsigned int key_size, void **value);
2215
+ GRN_API grn_id grn_pat_add(grn_ctx *ctx, grn_pat *pat, const void *key,
2216
+ unsigned int key_size, void **value, int *added);
2217
+
2218
+ GRN_API int grn_pat_get_key(grn_ctx *ctx, grn_pat *pat, grn_id id, void *keybuf, int bufsize);
2219
+ GRN_API int grn_pat_get_key2(grn_ctx *ctx, grn_pat *pat, grn_id id, grn_obj *bulk);
2220
+ GRN_API int grn_pat_get_value(grn_ctx *ctx, grn_pat *pat, grn_id id, void *valuebuf);
2221
+ GRN_API grn_rc grn_pat_set_value(grn_ctx *ctx, grn_pat *pat, grn_id id,
2222
+ void *value, int flags);
2223
+
2224
+ GRN_API grn_rc grn_pat_delete_by_id(grn_ctx *ctx, grn_pat *pat, grn_id id,
2225
+ grn_table_delete_optarg *optarg);
2226
+ GRN_API grn_rc grn_pat_delete(grn_ctx *ctx, grn_pat *pat, const void *key, unsigned int key_size,
2227
+ grn_table_delete_optarg *optarg);
2228
+ GRN_API int grn_pat_delete_with_sis(grn_ctx *ctx, grn_pat *pat, grn_id id,
2229
+ grn_table_delete_optarg *optarg);
2230
+
2231
+ typedef struct _grn_pat_scan_hit grn_pat_scan_hit;
2232
+
2233
+ struct _grn_pat_scan_hit {
2234
+ grn_id id;
2235
+ unsigned int offset;
2236
+ unsigned int length;
2237
+ };
2238
+
2239
+ GRN_API int grn_pat_scan(grn_ctx *ctx, grn_pat *pat, const char *str, unsigned int str_len,
2240
+ grn_pat_scan_hit *sh, unsigned int sh_size, const char **rest);
2241
+
2242
+ GRN_API grn_rc grn_pat_prefix_search(grn_ctx *ctx, grn_pat *pat,
2243
+ const void *key, unsigned int key_size, grn_hash *h);
2244
+ GRN_API grn_rc grn_pat_suffix_search(grn_ctx *ctx, grn_pat *pat,
2245
+ const void *key, unsigned int key_size, grn_hash *h);
2246
+ GRN_API grn_id grn_pat_lcp_search(grn_ctx *ctx, grn_pat *pat,
2247
+ const void *key, unsigned int key_size);
2248
+
2249
+ GRN_API unsigned int grn_pat_size(grn_ctx *ctx, grn_pat *pat);
2250
+
2251
+ GRN_API grn_pat_cursor *grn_pat_cursor_open(grn_ctx *ctx, grn_pat *pat,
2252
+ const void *min, unsigned int min_size,
2253
+ const void *max, unsigned int max_size,
2254
+ int offset, int limit, int flags);
2255
+ GRN_API grn_id grn_pat_cursor_next(grn_ctx *ctx, grn_pat_cursor *c);
2256
+ GRN_API void grn_pat_cursor_close(grn_ctx *ctx, grn_pat_cursor *c);
2257
+
2258
+ GRN_API int grn_pat_cursor_get_key(grn_ctx *ctx, grn_pat_cursor *c, void **key);
2259
+ GRN_API int grn_pat_cursor_get_value(grn_ctx *ctx, grn_pat_cursor *c, void **value);
2260
+
2261
+ GRN_API int grn_pat_cursor_get_key_value(grn_ctx *ctx, grn_pat_cursor *c,
2262
+ void **key, unsigned int *key_size, void **value);
2263
+ GRN_API grn_rc grn_pat_cursor_set_value(grn_ctx *ctx, grn_pat_cursor *c,
2264
+ void *value, int flags);
2265
+ GRN_API grn_rc grn_pat_cursor_delete(grn_ctx *ctx, grn_pat_cursor *c,
2266
+ grn_table_delete_optarg *optarg);
2267
+
2268
+ #define GRN_PAT_EACH(ctx,pat,id,key,key_size,value,block) do { \
2269
+ grn_pat_cursor *_sc = grn_pat_cursor_open(ctx, pat, NULL, 0, NULL, 0, 0, -1, 0); \
2270
+ if (_sc) {\
2271
+ grn_id id;\
2272
+ while ((id = grn_pat_cursor_next(ctx, _sc))) {\
2273
+ grn_pat_cursor_get_key_value(ctx, _sc, (void **)(key),\
2274
+ (key_size), (void **)(value));\
2275
+ block\
2276
+ }\
2277
+ grn_pat_cursor_close(ctx, _sc);\
2278
+ }\
2279
+ } while (0)
2280
+
2281
+ #ifdef __cplusplus
2282
+ }
2283
+ #endif
2284
+
2285
+ #endif /* GROONGA_H */