これはPGroonga 1.X用のドキュメントです。新しいPGroongaを使っているならPGroonga 2.xのドキュメントを見てください。
pgroonga.match_positions_byte
関数1.0.7で追加。
pgroonga.match_positions_byte
関数は指定したテキスト中にある指定したキーワードの位置を返します。単位はバイトです。HTML出力用にキーワードをハイライトしたいならpgroonga.snippet_html
関数またはpgroonga.highlight_html
関数の方が適しているでしょう。pgroonga.match_positions_byte
関数は高度な用途向けです。
文字単位バージョンが欲しい場合は代わりにpgroonga.match_positions_character
を参照してください。
この関数の構文は次の通りです。
integer[2][] pgroonga.match_positions_byte(target, ARRAY[keyword1, keyword2, ...])
target
はキーワード検索対象のテキストです。型はtext
です。
keyword1
、keyword2
、...
は見つけたいキーワードです。型はtext
の配列です。1つ以上のキーワードを指定しなければいけません。
pgroonga.match_positions_byte
は位置の配列を返します。
位置は「オフセット」と「長さ」で表現します。「オフセット」は先頭からキーワードが現れた位置までのバイト数です。「長さ」はマッチしたテキストのバイト数です。「長さ」はキーワードの長さと違うかもしれません。これはキーワードもマッチしたテキストも正規化されるからです。
少なくとも1つキーワードを指定しなければいけません。
SELECT pgroonga.match_positions_byte('PGroonga is a PostgreSQL extension.',
ARRAY['PostgreSQL']);
-- match_positions_byte
-- ----------------------
-- {{14,10}}
-- (1 row)
複数のキーワードを指定できます。
SELECT pgroonga.match_positions_byte('PGroonga is a PostgreSQL extension.',
ARRAY['Groonga', 'PostgreSQL']);
-- match_positions_byte
-- ----------------------
-- {{1,7},{14,10}}
-- (1 row)
pgroonga.query_extract_keywords
関数を使うとクエリーからキーワードを抽出できます。
SELECT pgroonga.match_positions_byte('PGroonga is a PostgreSQL extension.',
pgroonga.query_extract_keywords('Groonga PostgreSQL -extension'));
-- match_positions_byte
-- ----------------------
-- {{1,7},{14,10}}
-- (1 row)
文字は正規化されます。
SELECT pgroonga.match_positions_byte('PGroonga + pglogical = replicatable!',
ARRAY['Pg']);
-- match_positions_byte
-- ----------------------
-- {{0,2},{11,2}}
-- (1 row)
マルチバイト文字にも対応しています。
SELECT pgroonga.match_positions_byte('10㌖先にある100キログラムの米',
ARRAY['キロ']);
-- match_positions_byte
-- ----------------------
-- {{2,3},{20,6}}
-- (1 row)