1.2.1 - en to ja translation catalogue (28 entries)

en: Execution example::
ja: 実行例::

en: Summary
ja: 概要

en: ``sub_filter`` evaluates ``filter_string`` in ``scope`` context.
ja: ``sub_filter`` は ``filter_string`` を ``scope`` のコンテキストで評価します。

en: ``sub_filter`` can be used in only ``--filter`` in :doc:`/reference/commands/select`.
ja: ``sub_filter`` は :doc:`/reference/commands/select` コマンドの ``--filter`` 内でのみ指定できます。

en: Syntax
ja: 構文

en: ``sub_filter`` requires two arguments. They are ``scope`` and ``filter_string``.
ja: ``sub_filter`` は2つの引数が必要です。 ``scope`` と ``filter_string`` です。

en: Usage
ja: 使い方

en: Here are a schema definition and sample data to show usage.
ja: 使い方を示すために使うスキーマ定義とサンプルデータは以下の通りです。

en: Sample schema:
ja: サンプルスキーマ:

en: Sample data:
ja: サンプルデータ:

en: Here is the simple usage of ``sub_filter`` function which extracts the blog entry commented by user 'A'.
ja: ブログのエントリを抽出する ``sub_filter`` 関数の使用例です。

en: When executing the above query, not only "groonga's blog", but also "mroonga's blog". This is not what you want because user "A" does not mention "groonga" to "mroonga's blog".
ja: 上記のクエリを実行すると、"groonga's blog"だけでなく、"mroonga's blog"もマッチします。ユーザー"A"は"mroonga's blog"に対しては"groonga"に言及していないので、これは意図していない結果です。

en: Without sub_filter, it means that following conditions are met.
ja: sub_filterなしでは、以下の条件が満たされます。

en: There is at least one record that user "A" commented out.
ja: すくなくとも一つはユーザー"A"がコメントしたレコードがある。

en: There is at least one record that mentioned about "groonga".
ja: すくなくとも一つは"groonga"について言及したレコードがある。

en: On the other hand, executing the above query returns the intended result. Because the arguments of sub_filter is evaluated in comments column's context.
ja: 一方、上記のクエリは意図した結果を返します。これは、sub_filterの引数がcommentsカラムのコンテキストで評価されるからです。

en: It means that sub_filter requires the following condition is met.
ja: sub_filterは以下の条件が満たされていることを要求します。

en: There are the records that user "A" mentions about "groonga".
ja: ユーザー"A"が"groonga"について言及しているレコードがある。

en: Parameters
ja: 引数

en: There are two required parameter, ``scope`` and ``filter_string``.
ja: 必須引数は二つあります。 ``scope`` と ``filter_string`` です。

en: Specifies a column of the table that is specified by ``table`` parameter in ``select``. The column has a limitation. The limitation is described later. ``filter_string`` is evaluated in the column context. It means that ``filter_string`` is evaluated like ``select --table TYPE_OF_THE_COLUMN --filter FILTER_STRING``.
ja: ``select`` コマンドの ``table`` パラメーターで指定したテーブルが持つカラムを指定します。このカラムには制限があります。制限については後述します。 ``filter_string`` はこのカラムの文脈で評価されます。これは、 ``filter_string`` は ``select --table カラムの型 --filter フィルター文字列`` というように評価されるということです。

en: The specified column type must be a table. In other words, the column type must be reference type.
ja: 指定したカラムの型はテーブルでなければいけません。言いかえると、カラムの型は参照型でなければいけないということです。

en: You can chain columns by ``COLUMN_1.COLUMN_2.COLUMN_3...COLUMN_N`` syntax. For example, ``user.group.name``.
ja: ``カラム1.カラム2.カラム3...カラムN`` という構文でカラムを数珠つなぎにできます。例えば、 ``user.group.name`` とできます。

en: See :ref:`select-table` about ``table`` parameter in ``select``.
ja: ``select`` コマンドの ``table`` 引数については :ref:`select-table` を参照してください。

en: Specifies a search condition in :doc:`/reference/grn_expr/script_syntax`. It is evaluated in ``scope`` context.
ja: :doc:`/reference/grn_expr/script_syntax` の検索条件を指定します。これは ``scope`` のコンテキストで評価されます。

en: Return value
ja: 戻り値

en: ``sub_filter`` returns whether any record is matched or not. If one or more records are matched, it returns ``true``. Otherwise, it returns ``false``.
ja: ``sub_filter`` は1つでもレコードがマッチしたかどうかを返します。もし、1つ以上のレコードがマッチしたら ``true`` を返します。1つもマッチしなかったら ``false`` を返します。

en: See also
ja: 参考
