File: grn_hook.rst

package info (click to toggle)
groonga 9.0.0-1%2Bdeb10u1
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 101,496 kB
  • sloc: ansic: 608,707; ruby: 35,042; xml: 23,643; cpp: 10,319; sh: 7,453; yacc: 5,968; python: 3,033; makefile: 2,609; perl: 133
file content (67 lines) | stat: -rw-r--r-- 2,327 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
.. -*- rst -*-

.. highlightlang:: none

``grn_hook``
============

Summary
-------

TODO...

Example
-------

TODO...

Reference
---------

.. c:type:: grn_hook_entry

   TODO...

.. c:function:: grn_rc grn_obj_add_hook(grn_ctx *ctx, grn_obj *obj, grn_hook_entry entry, int offset, grn_obj *proc, grn_obj *data)

   objに対してhookを追加します。

   :param obj: 対象objectを指定します。
   :param entry:
      ``GRN_HOOK_GET`` は、objectの参照時に呼び出されるhookを定義します。

      ``GRN_HOOK_SET`` は、objectの更新時に呼び出されるhookを定義します。

      ``GRN_HOOK_SELECT`` は、検索処理の実行中に適時呼び出され、処理の実行状況を調べたり、実行の中断を指示することができます。
   :param offset:
      hookの実行順位。offsetに対応するhookの直前に新たなhookを挿入します。

      0を指定した場合は先頭に挿入されます。-1を指定した場合は末尾に挿入されます。

      objectに複数のhookが定義されている場合は順位の順に呼び出されます。
   :param proc: 手続きを指定します。
   :param data: hook固有情報を指定します。

.. c:function:: int grn_obj_get_nhooks(grn_ctx *ctx, grn_obj *obj, grn_hook_entry entry)

   objに定義されているhookの数を返します。

   :param obj: 対象objectを指定します。
   :param entry: hookタイプを指定します。

.. c:function:: grn_obj *grn_obj_get_hook(grn_ctx *ctx, grn_obj *obj, grn_hook_entry entry, int offset, grn_obj *data)

   objに定義されているhookの手続き(proc)を返します。hook固有情報が定義されている場合は、その内容をdataにコピーして返します。

   :param obj: 対象objectを指定します。
   :param entry: hookタイプを指定します。
   :param offset: 実行順位を指定します。
   :param data: hook固有情報格納バッファを指定します。

.. c:function:: grn_rc grn_obj_delete_hook(grn_ctx *ctx, grn_obj *obj, grn_hook_entry entry, int offset)

   objに定義されているhookを削除します。

   :param obj: 対象objectを指定します。
   :param entry: hookタイプを指定します。
   :param offset: 実行順位を指定します。