rroonga 0.9.2-x86-mingw32

data/text/expression.rdoc

@@ -0,0 +1,284 @@
+
+= grn式 (grn_expr)
+
+
+== 名前
+
+grn式 - 検索条件やデータベースへの操作を表現する文字列の形式。(読み方:"ぐるんしき")
+
+
+== 書式
+
+grn式はquery形式とscript形式のいずれかによって表現することができます。
+
+query形式
+
+[条件式]
+  以下の条件式が使用できます。
+
+  [文字列]
+    全文検索条件(デフォルト検索対象カラムの値が指定された文字列を含んでいる)
+
+  ["文字列"]
+    フレーズ検索条件(デフォルト検索対象カラムの値が指定されたフレーズを含んでいる)
+
+  [カラム名:値]
+    一致条件(カラム値 == 値)
+
+  [カラム名:!値]
+    不一致条件(カラム値 != 値)
+
+  [カラム名:<値]
+    比較条件(カラム値 < 値)
+
+  [カラム名:>値]
+    比較条件(カラム値 > 値)
+
+  [カラム名:<=値]
+    比較条件(カラム値 <= 値)
+
+  [カラム名:>=値]
+    比較条件(カラム値 >= 値)
+
+  [カラム名:@文字列]
+    全文検索条件(カラム値が指定された文字列を含んでいる)
+
+[補助演算子 [1]]
+  全文検索条件の挙動を制御する以下の演算子が指定できます。
+
+  [~文字列]
+    文字列を含んでいた場合は、そのレコードのスコアを下げます。
+
+  [<文字列]
+    文字列を含んでいた場合に加算されるスコアの値を小さくします。
+
+  [>文字列]
+    文字列を含んでいた場合に加算されるスコアの値を大きくします。
+
+  [文字列*]
+    文字列に前方一致する条件を示します。
+
+  [*S[数値]"文字列"]
+    文字列と関連する文書を検索します。文字列から抽出する特徴語の数を数値に指定します。
+
+  [*N[数値]"文字列"]
+    文字列に含まれる複数の語が、近傍に含まれる文書を検索します。近傍の範囲の上限とな
+    る語数を数値に指定します。N-gramの場合は、文字数を指定します。
+
+[結合演算子]
+  複数の条件式を結合するために以下の演算子が使用できる。演算子を伴わずに複数の条件式 が空白('
+  ')区切りで指定された場合は、デフォルトの結合演算子が指定されたものとみな される。
+
+  [a OR b]
+    論理和(aとbといずれかの条件がマッチする)
+
+  [a + b]
+    論理積(aとbの両方がマッチする)
+
+  [a - b]
+    aにマッチし、bにはマッチしない
+
+  [( )]
+    複数の条件をまとめる
+
+[プラグマ [2]]
+  query形式文字列の先頭に、処理方法を指定するプラグマを埋め込むことができます。
+
+  プラグマは必ずクエリ文字列の冒頭に存在しなければなりません。(先頭に空白を入れては いけません)
+
+  一つのクエリに複数のプラグマを指定することができます。
+
+  複数のプラグマを指定する場合は、間に空白を入れてはいけません。
+
+  [*E数値1[,数値2]]
+    検索結果の数が数値1よりも小さい場合、完全一致→非わかち書き→部分一致の順に自動
+    的に検索処理方法を切り替えます。完全一致でヒットした文書と比べて非わかち書き一致、
+    部分一致でヒットした文書には数値2分だけ小さいスコアを付与します。数値2を省略した
+    場合は既定値(=2)と解釈されます。数値1に負の数を指定した場合は以下のように処理し ます。
+
+    -1
+
+    完全一致検索のみを行う
+
+    -2
+
+    非わかち書き検索のみを行う
+
+    -3
+
+    完全一致検索と非わかち書き検索のみを行う
+
+    -4
+
+    部分一致検索のみを行う
+
+    -5
+
+    完全一致検索と部分一致検索のみを行う
+
+    -6
+
+    非わかち書き検索と部分一致検索のみを行う
+
+    -7
+
+    完全一致検索,非わかち書き検索,部分一致検索の全てを行う
+
+    例:
+
+    *E10,3
+
+    検索結果数が10件以下だった場合に検索処理方法を順次切り替え、スコアを3ずつ小さ くします。
+
+  [*D演算子]
+    結合演算子の既定値(演算子を省略した場合にどの演算を行うか)を指定します。指定できる演 算子は、OR, +, - のいずれかです。
+
+    例1:
+
+    *D+ abc def
+
+    abcとdefを両方含む文書を検索します。
+
+    例2:
+
+    *DOR abc def
+
+    abcとdefのいずれかを含む文書を検索します。
+
+  [*W[数値[:重み][,数値[:重み]]...]
+    数値で指定されたセクション番号のみを対象に検索します。セクションごとに検索スコア
+    の倍数を指定することができます。重みは、省略された場合1となります。負の重みも指 定することができます。
+
+script形式 [3]
+
+ECMAScript風の構文で検索条件やレコードへの操作を記述します。
+
+式中のIDENTIFIER(識別子)は、以下のいずれかを指します。
+
+[引数名]
+  grn式が受け取る引数の名前
+
+[カラム名]
+  操作対象としているレコードのカラム名
+
+[型名・関数名・テーブル名]
+  データベースに定義された型・テーブル・関数の名前
+
+
+== 説明
+
+grn式は、検索条件やデータベースへの操作を表現するために使用される文字列の形式です。
+
+selectやloadなどのいくつかの組込コマンドや、API関数grn_table_select()などで使用されます。grn式はquery
+形式とscript形式という2種類の方式で記述することができます。query形式は、多くのweb検索エンジンなどで検索フォームにユーザが指定
+可能なクエリ文字列の書式に合わせた形式です。script形式は、ECMAScriptの構文から式(expression)以下の構文要素を抜粋
+した形式になっており、文(statement)や制御構造などは表現できません。
+
+query形式のgrn式もscript形式のgrn式も、共通の中間形式に翻訳された上で処理されますので、処理速度や効率には差違はありません。
+記述できる処理の範囲はscript形式の方がquery形式より広くなっています。たとえば更新系の操作はscript形式のみで記述できます。
+
+DB-APIレイヤでは、異なる形式で記述された複数のgrn式を結合することも可能です。
+
+
+== 例
+
+query形式でcolumn1の値が'hoge'に等しいという条件
+
+column1:hoge
+
+script形式でcolumn1の値が'hoge'に等しいという条件
+
+column1 == "hoge"
+
+
+== 構文
+
+query形式のgrn式で有効な式の構文を拡張BNF記法で示します。
+
+  query             ::= query_element
+            | ( query query_element )
+            | ( query "+" query_element )
+            | ( query "-" query_element )
+            | ( query "OR" query_element )
+  query_element     ::= STRING
+                    | ( "(" query ")" )
+                    | ( IDENTIFIER relative_operator query_element )
+  relative_operator ::= ( ":" | ":!" | ":<" | ":>" | ":<=" | ":>=" | ":@" )
+
+script形式のgrn式で有効な式の構文を拡張BNF記法で示します。
+
+  expression                   ::= assignment_expression
+  expression                   ::= ( expression "," assignment_expression )
+  assignment_expression        ::= conditional_expression
+                            | ( lefthand_side_expression assign_operator assignment_expression )
+  assign_operator              ::= ( "=" | "*=" | "/=" | "%=" | "+=" | "-=" | "<<=" | ">>=" | ">>>=" | "&=" | "^=" | "|=" )
+  conditional_expression       ::= logical_or_expression
+                             | ( logical_or_expression "?" assignment_expression ":" assignment_expression )
+  logical_or_expression        ::= logical_and_expression
+                            | ( logical_or_expression "||" logical_and_expression )
+  logical_and_expression       ::= bitwise_or_expression
+                             | ( logical_and_expression logical_and_operator bitwise_or_expression )
+  logical_and_operator         ::= ( "&&" | "&!" )
+  bitwise_or_expression        ::= bitwise_xor_expression
+                            | ( bitwise_or_expression "|" bitwise_xor_expression )
+  bitwise_xor_expression       ::= bitwise_and_expression
+                             | ( bitwise_xor_expression "^" bitwise_and_expression )
+  bitwise_and_expression       ::= equality_expression
+                             | bitwise_and_expression "&" equality_expression )
+  equality_expression          ::= relational_expression
+                          | ( equality_expression equality_operator relational_expression )
+  equality_operator            ::= ( "==" | "!=" )
+  relational_expression        ::= shift_expression
+                            | ( relational_expression relational_operator shift_expression )
+  relational_operator          ::= ( "<" | ">" | "<=" | ">=" | "in" | "@" )
+  shift_expression             ::= additive_expression
+                       | ( shift_expression shift_operator additive_expression )
+  shift_operator               ::= ( "<<" | ">>" | ">>>" )
+  additive_expression          ::= multiplicative_expression
+                          | ( additive_expression additive_operator multiplicative_expression )
+  additive_operator            ::= ( "+" | "-" )
+  multiplicative_expression    ::= unary_expression
+                                | ( multiplicative_expression multiplicative_operator unary_expression )
+  multiplicative_operator      ::= ( "*" | "/" | "%" )
+  unary_expression             ::= postfix_expression
+                       | ( unary_operator unary_expression )
+  unary_operator               ::= ( "delete" : "++" : "--" : "+" : "-" : "!" : "~" )
+  postfix_expression           ::= lefthand_side_expression
+                         | ( lefthand_side_expression postfix_operator )
+  postfix_operator             ::= ( "++" | "--" )
+  lefthand_side_expression     ::= (call_expression | member_expression)
+  call_expression              ::= member_expression arguments
+  member_expression            ::= primary_expression
+  member_expression            ::= member_expression member_expression_part
+  primary_expression           ::= object_literal
+                         | ( "(" expression ")" )
+                         | IDENTIFIER
+                         | array_literal
+                         | DECIMAL
+                         | HEX_INTEGER
+                         | STRING
+                         | "true"
+                         | "false
+                         | "null"
+  array_literal                ::= ( "[" elision "]" )
+                    | ( "[" `element_list elision` "]" )
+                    | ( "[" element_list "]" )
+  elision                      ::= "," | ( elision "," )
+  element_list                 ::= assignment_expression
+                   | ( elision assignment_expression )
+                   | ( element_list elision assignment_expression )
+  object_literal               ::= ( "{" property_name_and_value_list "}" )
+  property_name_and_value_list ::= ( property_name_and_value_list "," property_name_and_value )
+  property_name_and_value      ::= ( property_name ":" assignment_expression )
+  property_name                ::= IDENTIFIER | STRING | DECIMAL
+  member_expression_part       ::= "[" expression "]" | ( "." IDENTIFIER )
+  arguments                    ::= ( "(" argument_list ")" )
+  argument_list                ::= assignment_expression | ( argument_list "," assignment_expression )
+
+-[ 脚注 ]-
+
+[1] 補助演算子はv1.0でサポートされます。
+
+[2] プラグマはv1.0でサポートされます。
+
+[3] script形式のgrn式はv1.0でサポートされます。

metadata

@@ -0,0 +1,276 @@
+--- !ruby/object:Gem::Specification 
+name: rroonga
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 9
+  - 2
+  version: 0.9.2
+platform: x86-mingw32
+authors: 
+- Kouhei Sutou
+- Tasuku SUENAGA
+- daijiro
+- Yuto HAYAMIZU
+- SHIDARA Yoji
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-04-20 00:00:00 +09:00
+default_executable: 
+dependencies: []
+
+description: |-
+  rroonga is a extension library to use groonga's DB-API
+  layer. rroonga provides Rubyish readable and writable
+  API. You can use groonga's first and highly functional
+  features from Ruby.
+email: 
+- groonga-users-en@rubyforge.org
+- groonga-dev@lists.sourceforge.jp
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.ja.rdoc
+- NEWS.ja.rdoc
+- text/TUTORIAL.ja.rdoc
+- text/expression.rdoc
+- README.rdoc
+- NEWS.rdoc
+files: 
+- AUTHORS
+- NEWS.ja.rdoc
+- NEWS.rdoc
+- README.ja.rdoc
+- README.rdoc
+- Rakefile
+- benchmark/common.rb
+- benchmark/read-write-many-small-items.rb
+- benchmark/write-many-small-items.rb
+- example/bookmark.rb
+- example/index-html.rb
+- example/search/config.ru
+- example/search/public/css/groonga.css
+- ext/.gitignore
+- ext/groonga/extconf.rb
+- ext/groonga/rb-grn-accessor.c
+- ext/groonga/rb-grn-array-cursor.c
+- ext/groonga/rb-grn-array.c
+- ext/groonga/rb-grn-column.c
+- ext/groonga/rb-grn-context.c
+- ext/groonga/rb-grn-database.c
+- ext/groonga/rb-grn-encoding-support.c
+- ext/groonga/rb-grn-encoding.c
+- ext/groonga/rb-grn-exception.c
+- ext/groonga/rb-grn-expression-builder.c
+- ext/groonga/rb-grn-expression.c
+- ext/groonga/rb-grn-fix-size-column.c
+- ext/groonga/rb-grn-hash-cursor.c
+- ext/groonga/rb-grn-hash.c
+- ext/groonga/rb-grn-index-column.c
+- ext/groonga/rb-grn-logger.c
+- ext/groonga/rb-grn-object.c
+- ext/groonga/rb-grn-operation.c
+- ext/groonga/rb-grn-patricia-trie-cursor.c
+- ext/groonga/rb-grn-patricia-trie.c
+- ext/groonga/rb-grn-procedure.c
+- ext/groonga/rb-grn-query.c
+- ext/groonga/rb-grn-record.c
+- ext/groonga/rb-grn-snippet.c
+- ext/groonga/rb-grn-table-cursor-key-support.c
+- ext/groonga/rb-grn-table-cursor.c
+- ext/groonga/rb-grn-table-key-support.c
+- ext/groonga/rb-grn-table.c
+- ext/groonga/rb-grn-type.c
+- ext/groonga/rb-grn-utils.c
+- ext/groonga/rb-grn-variable-size-column.c
+- ext/groonga/rb-grn-variable.c
+- ext/groonga/rb-grn-view-accessor.c
+- ext/groonga/rb-grn-view-cursor.c
+- ext/groonga/rb-grn-view-record.c
+- ext/groonga/rb-grn-view.c
+- ext/groonga/rb-grn.h
+- ext/groonga/rb-groonga.c
+- extconf.rb
+- html/bar.svg
+- html/developer.html
+- html/developer.svg
+- html/download.svg
+- html/favicon.ico
+- html/favicon.xcf
+- html/footer.html.erb
+- html/head.html.erb
+- html/header.html.erb
+- html/index.html
+- html/install.svg
+- html/logo.xcf
+- html/ranguba.css
+- html/tutorial.svg
+- lib/groonga.rb
+- lib/groonga/context.rb
+- lib/groonga/expression-builder.rb
+- lib/groonga/patricia-trie.rb
+- lib/groonga/record.rb
+- lib/groonga/schema.rb
+- lib/groonga/view-record.rb
+- license/GPL
+- license/LGPL
+- license/RUBY
+- misc/grnop2ruby.rb
+- pkg-config.rb
+- rroonga-build.rb
+- test-unit/Rakefile
+- test-unit/TODO
+- test-unit/bin/testrb
+- test-unit/html/classic.html
+- test-unit/html/index.html
+- test-unit/html/index.html.ja
+- test-unit/lib/test/unit.rb
+- test-unit/lib/test/unit/assertionfailederror.rb
+- test-unit/lib/test/unit/assertions.rb
+- test-unit/lib/test/unit/attribute.rb
+- test-unit/lib/test/unit/autorunner.rb
+- test-unit/lib/test/unit/collector.rb
+- test-unit/lib/test/unit/collector/descendant.rb
+- test-unit/lib/test/unit/collector/dir.rb
+- test-unit/lib/test/unit/collector/load.rb
+- test-unit/lib/test/unit/collector/objectspace.rb
+- test-unit/lib/test/unit/color-scheme.rb
+- test-unit/lib/test/unit/color.rb
+- test-unit/lib/test/unit/diff.rb
+- test-unit/lib/test/unit/error.rb
+- test-unit/lib/test/unit/exceptionhandler.rb
+- test-unit/lib/test/unit/failure.rb
+- test-unit/lib/test/unit/fixture.rb
+- test-unit/lib/test/unit/notification.rb
+- test-unit/lib/test/unit/omission.rb
+- test-unit/lib/test/unit/pending.rb
+- test-unit/lib/test/unit/priority.rb
+- test-unit/lib/test/unit/runner/console.rb
+- test-unit/lib/test/unit/runner/emacs.rb
+- test-unit/lib/test/unit/runner/tap.rb
+- test-unit/lib/test/unit/testcase.rb
+- test-unit/lib/test/unit/testresult.rb
+- test-unit/lib/test/unit/testsuite.rb
+- test-unit/lib/test/unit/ui/console/outputlevel.rb
+- test-unit/lib/test/unit/ui/console/testrunner.rb
+- test-unit/lib/test/unit/ui/emacs/testrunner.rb
+- test-unit/lib/test/unit/ui/tap/testrunner.rb
+- test-unit/lib/test/unit/ui/testrunner.rb
+- test-unit/lib/test/unit/ui/testrunnermediator.rb
+- test-unit/lib/test/unit/ui/testrunnerutilities.rb
+- test-unit/lib/test/unit/util/backtracefilter.rb
+- test-unit/lib/test/unit/util/method-owner-finder.rb
+- test-unit/lib/test/unit/util/observable.rb
+- test-unit/lib/test/unit/util/procwrapper.rb
+- test-unit/lib/test/unit/version.rb
+- test-unit/sample/adder.rb
+- test-unit/sample/subtracter.rb
+- test-unit/sample/test_adder.rb
+- test-unit/sample/test_subtracter.rb
+- test-unit/sample/test_user.rb
+- test-unit/test/collector/test-descendant.rb
+- test-unit/test/collector/test-load.rb
+- test-unit/test/collector/test_dir.rb
+- test-unit/test/collector/test_objectspace.rb
+- test-unit/test/run-test.rb
+- test-unit/test/test-attribute.rb
+- test-unit/test/test-color-scheme.rb
+- test-unit/test/test-color.rb
+- test-unit/test/test-diff.rb
+- test-unit/test/test-emacs-runner.rb
+- test-unit/test/test-fixture.rb
+- test-unit/test/test-notification.rb
+- test-unit/test/test-omission.rb
+- test-unit/test/test-pending.rb
+- test-unit/test/test-priority.rb
+- test-unit/test/test-testcase.rb
+- test-unit/test/test_assertions.rb
+- test-unit/test/test_error.rb
+- test-unit/test/test_failure.rb
+- test-unit/test/test_testresult.rb
+- test-unit/test/test_testsuite.rb
+- test-unit/test/testunit-test-util.rb
+- test-unit/test/ui/test_testrunmediator.rb
+- test-unit/test/util/test-method-owner-finder.rb
+- test-unit/test/util/test_backtracefilter.rb
+- test-unit/test/util/test_observable.rb
+- test-unit/test/util/test_procwrapper.rb
+- test/.gitignore
+- test/groonga-test-utils.rb
+- test/run-test.rb
+- test/test-array.rb
+- test/test-column.rb
+- test/test-context-select.rb
+- test/test-context.rb
+- test/test-database.rb
+- test/test-encoding.rb
+- test/test-exception.rb
+- test/test-expression-builder.rb
+- test/test-expression.rb
+- test/test-fix-size-column.rb
+- test/test-gqtp.rb
+- test/test-hash.rb
+- test/test-index-column.rb
+- test/test-logger.rb
+- test/test-patricia-trie.rb
+- test/test-procedure.rb
+- test/test-query.rb
+- test/test-record.rb
+- test/test-remote.rb
+- test/test-schema-view.rb
+- test/test-schema.rb
+- test/test-snippet.rb
+- test/test-table-cursor.rb
+- test/test-table-offset-and-limit.rb
+- test/test-table-select-normalize.rb
+- test/test-table-select.rb
+- test/test-table.rb
+- test/test-type.rb
+- test/test-variable-size-column.rb
+- test/test-variable.rb
+- test/test-vector-column.rb
+- test/test-version.rb
+- test/test-view.rb
+- text/TUTORIAL.ja.rdoc
+- text/expression.rdoc
+- lib/1.8/groonga.so
+- lib/1.9/groonga.so
+has_rdoc: true
+homepage: http://groonga.rubyforge.org/
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.ja.rdoc
+require_paths: 
+- lib
+- ext/groonga
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: groonga
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Ruby bindings for groonga that provides full text search and column store features.
+test_files: 
+- test/run-test.rb