rroonga 6.0.7-x64-mingw32 → 6.0.9-x64-mingw32
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/doc/text/cross-compile.md +24 -23
- data/doc/text/news.md +10 -0
- data/ext/groonga/rb-grn-database.c +33 -0
- data/ext/groonga/rb-grn-id.c +19 -0
- data/ext/groonga/rb-grn-table.c +3 -1
- data/ext/groonga/rb-grn.h +1 -1
- data/lib/2.1/groonga.so +0 -0
- data/lib/2.2/groonga.so +0 -0
- data/lib/2.3/groonga.so +0 -0
- data/rroonga-build.rb +3 -3
- data/test/test-database.rb +21 -1
- data/test/test-id.rb +16 -0
- data/vendor/local/bin/grndb.exe +0 -0
- data/vendor/local/bin/groonga-benchmark.exe +0 -0
- data/vendor/local/bin/groonga-suggest-create-dataset.exe +0 -0
- data/vendor/local/bin/groonga.exe +0 -0
- data/vendor/local/bin/libgroonga-0.dll +0 -0
- data/vendor/local/bin/libmecab-2.dll +0 -0
- data/vendor/local/bin/libmsgpackc.dll +0 -0
- data/vendor/local/bin/libonig-5.dll +0 -0
- data/vendor/local/bin/libpcre-1.dll +0 -0
- data/vendor/local/bin/libpcrecpp-0.dll +0 -0
- data/vendor/local/bin/libpcreposix-0.dll +0 -0
- data/vendor/local/bin/lz4.exe +0 -0
- data/vendor/local/bin/lz4c.exe +0 -0
- data/vendor/local/bin/lz4cat +0 -0
- data/vendor/local/bin/mecab.exe +0 -0
- data/vendor/local/bin/pcre-config +133 -0
- data/vendor/local/bin/pcregrep.exe +0 -0
- data/vendor/local/bin/pcretest.exe +0 -0
- data/vendor/local/bin/zlib1.dll +0 -0
- data/vendor/local/include/groonga/groonga/db.h +22 -0
- data/vendor/local/include/groonga/groonga/groonga.h +21 -1
- data/vendor/local/include/groonga/groonga/id.h +1 -0
- data/vendor/local/include/pcre.h +677 -0
- data/vendor/local/include/pcre_scanner.h +172 -0
- data/vendor/local/include/pcre_stringpiece.h +180 -0
- data/vendor/local/include/pcrecpp.h +710 -0
- data/vendor/local/include/pcrecpparg.h +174 -0
- data/vendor/local/include/pcreposix.h +146 -0
- data/vendor/local/lib/groonga/plugins/functions/number.a +0 -0
- data/vendor/local/lib/groonga/plugins/functions/number.dll +0 -0
- data/vendor/local/lib/groonga/plugins/functions/number.dll.a +0 -0
- data/vendor/local/lib/groonga/plugins/functions/string.a +0 -0
- data/vendor/local/lib/groonga/plugins/functions/string.dll +0 -0
- data/vendor/local/lib/groonga/plugins/functions/string.dll.a +0 -0
- data/vendor/local/lib/groonga/plugins/functions/time.a +0 -0
- data/vendor/local/lib/groonga/plugins/functions/time.dll +0 -0
- data/vendor/local/lib/groonga/plugins/functions/time.dll.a +0 -0
- data/vendor/local/lib/groonga/plugins/functions/vector.a +0 -0
- data/vendor/local/lib/groonga/plugins/functions/vector.dll +0 -0
- data/vendor/local/lib/groonga/plugins/functions/vector.dll.a +0 -0
- data/vendor/local/lib/groonga/plugins/query_expanders/tsv.a +0 -0
- data/vendor/local/lib/groonga/plugins/query_expanders/tsv.dll +0 -0
- data/vendor/local/lib/groonga/plugins/query_expanders/tsv.dll.a +0 -0
- data/vendor/local/lib/groonga/plugins/sharding/logical_table_remove.rb +253 -23
- data/vendor/local/lib/groonga/plugins/suggest/suggest.a +0 -0
- data/vendor/local/lib/groonga/plugins/suggest/suggest.dll +0 -0
- data/vendor/local/lib/groonga/plugins/suggest/suggest.dll.a +0 -0
- data/vendor/local/lib/groonga/plugins/table/table.a +0 -0
- data/vendor/local/lib/groonga/plugins/table/table.dll +0 -0
- data/vendor/local/lib/groonga/plugins/table/table.dll.a +0 -0
- data/vendor/local/lib/groonga/plugins/token_filters/stop_word.a +0 -0
- data/vendor/local/lib/groonga/plugins/token_filters/stop_word.dll +0 -0
- data/vendor/local/lib/groonga/plugins/token_filters/stop_word.dll.a +0 -0
- data/vendor/local/lib/groonga/plugins/tokenizers/mecab.a +0 -0
- data/vendor/local/lib/groonga/plugins/tokenizers/mecab.dll +0 -0
- data/vendor/local/lib/groonga/plugins/tokenizers/mecab.dll.a +0 -0
- data/vendor/local/lib/groonga/scripts/ruby/context.rb +19 -0
- data/vendor/local/lib/groonga/scripts/ruby/context/rc.rb +12 -4
- data/vendor/local/lib/groonga/scripts/ruby/database.rb +36 -18
- data/vendor/local/lib/groonga/scripts/ruby/scan_info_data.rb +13 -10
- data/vendor/local/lib/libgroonga.a +0 -0
- data/vendor/local/lib/libgroonga.dll.a +0 -0
- data/vendor/local/lib/liblz4.a +0 -0
- data/vendor/local/lib/liblz4.dll +0 -0
- data/vendor/local/lib/liblz4.dll.1 +0 -0
- data/vendor/local/lib/liblz4.dll.1.5.0 +0 -0
- data/vendor/local/lib/libmecab.a +0 -0
- data/vendor/local/lib/libmecab.dll.a +0 -0
- data/vendor/local/lib/libmsgpackc.a +0 -0
- data/vendor/local/lib/libmsgpackc.dll.a +0 -0
- data/vendor/local/lib/libonig.a +0 -0
- data/vendor/local/lib/libonig.dll.a +0 -0
- data/vendor/local/lib/libpcre.a +0 -0
- data/vendor/local/lib/libpcre.dll.a +0 -0
- data/vendor/local/lib/libpcre.la +41 -0
- data/vendor/local/lib/libpcrecpp.a +0 -0
- data/vendor/local/lib/libpcrecpp.dll.a +0 -0
- data/vendor/local/lib/libpcrecpp.la +41 -0
- data/vendor/local/lib/libpcreposix.a +0 -0
- data/vendor/local/lib/libpcreposix.dll.a +0 -0
- data/vendor/local/lib/libpcreposix.la +41 -0
- data/vendor/local/lib/libz.a +0 -0
- data/vendor/local/lib/libz.dll.a +0 -0
- data/vendor/local/lib/pkgconfig/groonga.pc +2 -2
- data/vendor/local/lib/pkgconfig/libpcre.pc +13 -0
- data/vendor/local/lib/pkgconfig/libpcrecpp.pc +12 -0
- data/vendor/local/lib/pkgconfig/libpcreposix.pc +13 -0
- data/vendor/local/libexec/mecab/mecab-cost-train.exe +0 -0
- data/vendor/local/libexec/mecab/mecab-dict-gen.exe +0 -0
- data/vendor/local/libexec/mecab/mecab-dict-index.exe +0 -0
- data/vendor/local/libexec/mecab/mecab-system-eval.exe +0 -0
- data/vendor/local/libexec/mecab/mecab-test-gen.exe +0 -0
- data/vendor/local/sbin/groonga-httpd.exe +0 -0
- data/vendor/local/share/doc/groonga/en/html/.buildinfo +1 -1
- data/vendor/local/share/doc/groonga/en/html/_sources/install/centos.txt +3 -3
- data/vendor/local/share/doc/groonga/en/html/_sources/install/debian.txt +3 -3
- data/vendor/local/share/doc/groonga/en/html/_sources/install/fedora.txt +3 -3
- data/vendor/local/share/doc/groonga/en/html/_sources/install/mac_os_x.txt +3 -3
- data/vendor/local/share/doc/groonga/en/html/_sources/install/others.txt +3 -3
- data/vendor/local/share/doc/groonga/en/html/_sources/install/solaris.txt +3 -3
- data/vendor/local/share/doc/groonga/en/html/_sources/install/ubuntu.txt +3 -3
- data/vendor/local/share/doc/groonga/en/html/_sources/install/windows.txt +9 -9
- data/vendor/local/share/doc/groonga/en/html/_sources/limitations.txt +24 -5
- data/vendor/local/share/doc/groonga/en/html/_sources/news.txt +156 -4
- data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/lock_acquire.txt +1 -1
- data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/lock_release.txt +1 -1
- data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/logical_table_remove.txt +86 -0
- data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/object_list.txt +23 -11
- data/vendor/local/share/doc/groonga/en/html/_sources/reference/commands/table_copy.txt +64 -0
- data/vendor/local/share/doc/groonga/en/html/_sources/reference/tables.txt +88 -45
- data/vendor/local/share/doc/groonga/en/html/characteristic.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/client.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/community.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/contribution.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/contribution/development.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/contribution/development/build.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/contribution/development/build/unix_autotools.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/contribution/development/build/unix_cmake.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/contribution/development/build/windows_cmake.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/contribution/development/com.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/contribution/development/cooperation.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/contribution/development/query.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/contribution/development/release.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/contribution/development/repository.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/contribution/development/test.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/contribution/documentation.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/contribution/documentation/c-api.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/contribution/documentation/i18n.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/contribution/documentation/introduction.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/contribution/report.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/development.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/development/travis-ci.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/genindex.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/index.html +15 -14
- data/vendor/local/share/doc/groonga/en/html/install.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/install/centos.html +8 -8
- data/vendor/local/share/doc/groonga/en/html/install/debian.html +8 -8
- data/vendor/local/share/doc/groonga/en/html/install/fedora.html +8 -8
- data/vendor/local/share/doc/groonga/en/html/install/mac_os_x.html +8 -8
- data/vendor/local/share/doc/groonga/en/html/install/others.html +8 -8
- data/vendor/local/share/doc/groonga/en/html/install/solaris.html +8 -8
- data/vendor/local/share/doc/groonga/en/html/install/ubuntu.html +8 -8
- data/vendor/local/share/doc/groonga/en/html/install/windows.html +14 -14
- data/vendor/local/share/doc/groonga/en/html/limitations.html +28 -9
- data/vendor/local/share/doc/groonga/en/html/news.html +196 -61
- data/vendor/local/share/doc/groonga/en/html/news/0.x.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/news/1.0.x.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/news/1.1.x.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/news/1.2.x.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/news/1.3.x.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/news/2.x.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/news/3.x.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/news/4.x.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/news/5.x.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/news/senna.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/objects.inv +0 -0
- data/vendor/local/share/doc/groonga/en/html/reference.html +15 -14
- data/vendor/local/share/doc/groonga/en/html/reference/alias.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/global_configurations.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/grn_cache.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/grn_column.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/grn_command_version.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/grn_content_type.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/grn_ctx.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/grn_db.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/grn_encoding.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/grn_expr.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/grn_geo.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/grn_hook.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/grn_ii.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/grn_index_cursor.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/grn_info.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/grn_match_escalation.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/grn_obj.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/grn_proc.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/grn_search.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/grn_table.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/grn_table_cursor.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/grn_thread.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/grn_type.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/grn_user_data.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/overview.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/api/plugin.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/cast.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/column.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/columns/index.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/columns/pseudo.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/columns/scalar.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/columns/vector.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/command.html +15 -14
- data/vendor/local/share/doc/groonga/en/html/reference/command/command_version.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/command/output_format.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/command/pretty_print.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/command/request_id.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/command/request_timeout.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/command/return_code.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/cache_limit.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/check.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/clearlock.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/column_copy.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/column_create.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/column_list.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/column_remove.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/column_rename.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/config_delete.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/config_get.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/config_set.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/database_unmap.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/define_selector.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/defrag.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/delete.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/dump.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/io_flush.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/load.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/lock_acquire.html +6 -6
- data/vendor/local/share/doc/groonga/en/html/reference/commands/lock_clear.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/lock_release.html +6 -6
- data/vendor/local/share/doc/groonga/en/html/reference/commands/log_level.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/log_put.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/log_reopen.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/logical_count.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/logical_parameters.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/logical_range_filter.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/logical_select.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/logical_shard_list.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/logical_table_remove.html +98 -8
- data/vendor/local/share/doc/groonga/en/html/reference/commands/normalize.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/normalizer_list.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/object_exist.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/object_inspect.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/object_list.html +32 -18
- data/vendor/local/share/doc/groonga/en/html/reference/commands/object_remove.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/plugin_register.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/plugin_unregister.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/query_expand.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/quit.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/range_filter.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/register.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/reindex.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/request_cancel.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/ruby_eval.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/ruby_load.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/schema.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/select.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/shutdown.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/status.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/commands/suggest.html +10 -10
- data/vendor/local/share/doc/groonga/en/html/reference/commands/table_copy.html +200 -0
- data/vendor/local/share/doc/groonga/en/html/reference/commands/table_create.html +52 -52
- data/vendor/local/share/doc/groonga/en/html/reference/commands/table_list.html +25 -25
- data/vendor/local/share/doc/groonga/en/html/reference/commands/table_remove.html +41 -41
- data/vendor/local/share/doc/groonga/en/html/reference/commands/table_rename.html +31 -31
- data/vendor/local/share/doc/groonga/en/html/reference/commands/table_tokenize.html +41 -41
- data/vendor/local/share/doc/groonga/en/html/reference/commands/thread_limit.html +31 -31
- data/vendor/local/share/doc/groonga/en/html/reference/commands/tokenize.html +43 -43
- data/vendor/local/share/doc/groonga/en/html/reference/commands/tokenizer_list.html +25 -25
- data/vendor/local/share/doc/groonga/en/html/reference/commands/truncate.html +25 -25
- data/vendor/local/share/doc/groonga/en/html/reference/configuration.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/executables.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/executables/grndb.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/executables/grnslap.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-benchmark.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-httpd.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-server-http.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-create-dataset.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-httpd.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga-suggest-learner.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/executables/groonga.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/function.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/between.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/edit_distance.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/fuzzy_search.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_distance.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_in_circle.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/geo_in_rectangle.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/highlight_full.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/highlight_html.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/html_untag.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/in_values.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/now.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/number_classify.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/prefix_rk_search.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/query.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/rand.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/record_number.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/snippet_html.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/string_substring.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/sub_filter.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/time_classify_day.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/time_classify_hour.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/time_classify_minute.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/time_classify_month.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/time_classify_second.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/time_classify_week.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/time_classify_year.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/vector_size.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/functions/vector_slice.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/grn_expr.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/grn_expr/query_syntax.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/grn_expr/script_syntax.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/indexing.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/log.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/normalizers.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/operations.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/operations/geolocation_search.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/operations/prefix_rk_search.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/output.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/query_expanders.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/query_expanders/tsv.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/regular_expression.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/scorer.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/scorers/scorer_tf_at_most.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/scorers/scorer_tf_idf.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/sharding.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/suggest.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/suggest/completion.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/suggest/correction.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/suggest/introduction.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/suggest/suggestion.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/tables.html +41 -34
- data/vendor/local/share/doc/groonga/en/html/reference/token_filters.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/tokenizers.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/tuning.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/reference/types.html +9 -9
- data/vendor/local/share/doc/groonga/en/html/search.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/searchindex.js +1 -1
- data/vendor/local/share/doc/groonga/en/html/server.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/server/gqtp.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/server/http.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/server/http/comparison.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/server/http/groonga-httpd.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/server/http/groonga.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/server/memcached.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/server/package.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/spec.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/spec/gqtp.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/spec/search.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/troubleshooting.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/troubleshooting/different_results_with_the_same_keyword.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/troubleshooting/mmap_cannot_allocate_memory.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/tutorial.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/tutorial/data.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/tutorial/drilldown.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/tutorial/index.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/tutorial/introduction.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/tutorial/lexicon.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/tutorial/match_columns.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/tutorial/micro_blog.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/tutorial/network.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/tutorial/patricia_trie.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/tutorial/query_expansion.html +5 -5
- data/vendor/local/share/doc/groonga/en/html/tutorial/search.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/.buildinfo +1 -1
- data/vendor/local/share/doc/groonga/ja/html/_sources/install/centos.txt +3 -3
- data/vendor/local/share/doc/groonga/ja/html/_sources/install/debian.txt +3 -3
- data/vendor/local/share/doc/groonga/ja/html/_sources/install/fedora.txt +3 -3
- data/vendor/local/share/doc/groonga/ja/html/_sources/install/mac_os_x.txt +3 -3
- data/vendor/local/share/doc/groonga/ja/html/_sources/install/others.txt +3 -3
- data/vendor/local/share/doc/groonga/ja/html/_sources/install/solaris.txt +3 -3
- data/vendor/local/share/doc/groonga/ja/html/_sources/install/ubuntu.txt +3 -3
- data/vendor/local/share/doc/groonga/ja/html/_sources/install/windows.txt +9 -9
- data/vendor/local/share/doc/groonga/ja/html/_sources/limitations.txt +24 -5
- data/vendor/local/share/doc/groonga/ja/html/_sources/news.txt +156 -4
- data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/lock_acquire.txt +1 -1
- data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/lock_release.txt +1 -1
- data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/logical_table_remove.txt +86 -0
- data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/object_list.txt +23 -11
- data/vendor/local/share/doc/groonga/ja/html/_sources/reference/commands/table_copy.txt +64 -0
- data/vendor/local/share/doc/groonga/ja/html/_sources/reference/tables.txt +88 -45
- data/vendor/local/share/doc/groonga/ja/html/characteristic.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/client.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/community.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/contribution.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/contribution/development.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/contribution/development/build.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/contribution/development/build/unix_autotools.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/contribution/development/build/unix_cmake.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/contribution/development/build/windows_cmake.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/contribution/development/com.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/contribution/development/cooperation.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/contribution/development/query.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/contribution/development/release.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/contribution/development/repository.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/contribution/development/test.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/contribution/documentation.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/c-api.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/i18n.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/contribution/documentation/introduction.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/contribution/report.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/development.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/development/travis-ci.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/genindex.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/index.html +15 -14
- data/vendor/local/share/doc/groonga/ja/html/install.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/install/centos.html +8 -8
- data/vendor/local/share/doc/groonga/ja/html/install/debian.html +8 -8
- data/vendor/local/share/doc/groonga/ja/html/install/fedora.html +8 -8
- data/vendor/local/share/doc/groonga/ja/html/install/mac_os_x.html +8 -8
- data/vendor/local/share/doc/groonga/ja/html/install/others.html +8 -8
- data/vendor/local/share/doc/groonga/ja/html/install/solaris.html +8 -8
- data/vendor/local/share/doc/groonga/ja/html/install/ubuntu.html +8 -8
- data/vendor/local/share/doc/groonga/ja/html/install/windows.html +14 -14
- data/vendor/local/share/doc/groonga/ja/html/limitations.html +21 -8
- data/vendor/local/share/doc/groonga/ja/html/news.html +185 -61
- data/vendor/local/share/doc/groonga/ja/html/news/0.x.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/news/1.0.x.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/news/1.1.x.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/news/1.2.x.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/news/1.3.x.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/news/2.x.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/news/3.x.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/news/4.x.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/news/5.x.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/news/senna.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/objects.inv +0 -0
- data/vendor/local/share/doc/groonga/ja/html/reference.html +15 -14
- data/vendor/local/share/doc/groonga/ja/html/reference/alias.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/global_configurations.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_cache.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_column.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_command_version.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_content_type.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_ctx.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_db.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_encoding.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_expr.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_geo.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_hook.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_ii.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_index_cursor.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_info.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_match_escalation.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_obj.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_proc.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_search.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_table.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_table_cursor.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_thread.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_type.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/grn_user_data.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/overview.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/api/plugin.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/cast.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/column.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/columns/index.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/columns/pseudo.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/columns/scalar.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/columns/vector.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/command.html +15 -14
- data/vendor/local/share/doc/groonga/ja/html/reference/command/command_version.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/command/output_format.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/command/pretty_print.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/command/request_id.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/command/request_timeout.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/command/return_code.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/cache_limit.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/check.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/clearlock.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_copy.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_create.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_list.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_remove.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/column_rename.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/config_delete.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/config_get.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/config_set.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/database_unmap.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/define_selector.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/defrag.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/delete.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/dump.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/io_flush.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/load.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/lock_acquire.html +6 -6
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/lock_clear.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/lock_release.html +6 -6
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_level.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_put.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/log_reopen.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/logical_count.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/logical_parameters.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/logical_range_filter.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/logical_select.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/logical_shard_list.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/logical_table_remove.html +88 -8
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/normalize.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/normalizer_list.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/object_exist.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/object_inspect.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/object_list.html +103 -103
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/object_remove.html +6 -6
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/plugin_register.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/plugin_unregister.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/query_expand.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/quit.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/range_filter.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/register.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/reindex.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/request_cancel.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/ruby_eval.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/ruby_load.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/schema.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/select.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/shutdown.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/status.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/suggest.html +10 -10
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_copy.html +201 -0
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_create.html +52 -52
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_list.html +25 -25
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_remove.html +41 -41
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_rename.html +31 -31
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/table_tokenize.html +41 -41
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/thread_limit.html +31 -31
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/tokenize.html +43 -43
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/tokenizer_list.html +25 -25
- data/vendor/local/share/doc/groonga/ja/html/reference/commands/truncate.html +25 -25
- data/vendor/local/share/doc/groonga/ja/html/reference/configuration.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/executables.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/executables/grndb.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/executables/grnslap.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-benchmark.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-httpd.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-server-http.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-create-dataset.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-httpd.html +6 -6
- data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga-suggest-learner.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/executables/groonga.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/function.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/between.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/edit_distance.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/fuzzy_search.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_distance.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_in_circle.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/geo_in_rectangle.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/highlight_full.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/highlight_html.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/html_untag.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/in_values.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/now.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/number_classify.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/prefix_rk_search.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/query.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/rand.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/record_number.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/snippet_html.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/string_substring.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/sub_filter.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/time_classify_day.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/time_classify_hour.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/time_classify_minute.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/time_classify_month.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/time_classify_second.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/time_classify_week.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/time_classify_year.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/vector_size.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/functions/vector_slice.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr/query_syntax.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/grn_expr/script_syntax.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/indexing.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/log.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/normalizers.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/operations.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/operations/geolocation_search.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/operations/prefix_rk_search.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/output.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/query_expanders.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/query_expanders/tsv.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/regular_expression.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/scorer.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/scorers/scorer_tf_at_most.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/scorers/scorer_tf_idf.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/sharding.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/suggest.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/suggest/completion.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/suggest/correction.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/suggest/introduction.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/suggest/suggestion.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/tables.html +33 -10
- data/vendor/local/share/doc/groonga/ja/html/reference/token_filters.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/tokenizers.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/tuning.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/reference/types.html +9 -9
- data/vendor/local/share/doc/groonga/ja/html/search.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/searchindex.js +1 -1
- data/vendor/local/share/doc/groonga/ja/html/server.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/server/gqtp.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/server/http.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/server/http/comparison.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/server/http/groonga-httpd.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/server/http/groonga.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/server/memcached.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/server/package.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/spec.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/spec/gqtp.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/spec/search.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/troubleshooting.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/troubleshooting/different_results_with_the_same_keyword.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/troubleshooting/mmap_cannot_allocate_memory.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/tutorial.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/tutorial/data.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/tutorial/drilldown.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/tutorial/index.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/tutorial/introduction.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/tutorial/lexicon.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/tutorial/match_columns.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/tutorial/micro_blog.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/tutorial/network.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/tutorial/patricia_trie.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/tutorial/query_expansion.html +5 -5
- data/vendor/local/share/doc/groonga/ja/html/tutorial/search.html +5 -5
- data/vendor/local/share/doc/pcre/AUTHORS +45 -0
- data/vendor/local/share/doc/pcre/COPYING +5 -0
- data/vendor/local/share/doc/pcre/ChangeLog +6010 -0
- data/vendor/local/share/doc/pcre/LICENCE +93 -0
- data/vendor/local/share/doc/pcre/NEWS +725 -0
- data/vendor/local/share/doc/pcre/README +1002 -0
- data/vendor/local/share/doc/pcre/html/NON-AUTOTOOLS-BUILD.txt +772 -0
- data/vendor/local/share/doc/pcre/html/README.txt +1002 -0
- data/vendor/local/share/doc/pcre/html/index.html +185 -0
- data/vendor/local/share/doc/pcre/html/pcre-config.html +109 -0
- data/vendor/local/share/doc/pcre/html/pcre.html +224 -0
- data/vendor/local/share/doc/pcre/html/pcre16.html +384 -0
- data/vendor/local/share/doc/pcre/html/pcre32.html +382 -0
- data/vendor/local/share/doc/pcre/html/pcre_assign_jit_stack.html +76 -0
- data/vendor/local/share/doc/pcre/html/pcre_compile.html +111 -0
- data/vendor/local/share/doc/pcre/html/pcre_compile2.html +115 -0
- data/vendor/local/share/doc/pcre/html/pcre_config.html +94 -0
- data/vendor/local/share/doc/pcre/html/pcre_copy_named_substring.html +65 -0
- data/vendor/local/share/doc/pcre/html/pcre_copy_substring.html +61 -0
- data/vendor/local/share/doc/pcre/html/pcre_dfa_exec.html +129 -0
- data/vendor/local/share/doc/pcre/html/pcre_exec.html +111 -0
- data/vendor/local/share/doc/pcre/html/pcre_free_study.html +46 -0
- data/vendor/local/share/doc/pcre/html/pcre_free_substring.html +46 -0
- data/vendor/local/share/doc/pcre/html/pcre_free_substring_list.html +46 -0
- data/vendor/local/share/doc/pcre/html/pcre_fullinfo.html +118 -0
- data/vendor/local/share/doc/pcre/html/pcre_get_named_substring.html +68 -0
- data/vendor/local/share/doc/pcre/html/pcre_get_stringnumber.html +57 -0
- data/vendor/local/share/doc/pcre/html/pcre_get_stringtable_entries.html +60 -0
- data/vendor/local/share/doc/pcre/html/pcre_get_substring.html +64 -0
- data/vendor/local/share/doc/pcre/html/pcre_get_substring_list.html +61 -0
- data/vendor/local/share/doc/pcre/html/pcre_jit_exec.html +108 -0
- data/vendor/local/share/doc/pcre/html/pcre_jit_stack_alloc.html +55 -0
- data/vendor/local/share/doc/pcre/html/pcre_jit_stack_free.html +48 -0
- data/vendor/local/share/doc/pcre/html/pcre_maketables.html +48 -0
- data/vendor/local/share/doc/pcre/html/pcre_pattern_to_host_byte_order.html +58 -0
- data/vendor/local/share/doc/pcre/html/pcre_refcount.html +51 -0
- data/vendor/local/share/doc/pcre/html/pcre_study.html +68 -0
- data/vendor/local/share/doc/pcre/html/pcre_utf16_to_host_byte_order.html +57 -0
- data/vendor/local/share/doc/pcre/html/pcre_utf32_to_host_byte_order.html +57 -0
- data/vendor/local/share/doc/pcre/html/pcre_version.html +46 -0
- data/vendor/local/share/doc/pcre/html/pcreapi.html +2921 -0
- data/vendor/local/share/doc/pcre/html/pcrebuild.html +534 -0
- data/vendor/local/share/doc/pcre/html/pcrecallout.html +286 -0
- data/vendor/local/share/doc/pcre/html/pcrecompat.html +235 -0
- data/vendor/local/share/doc/pcre/html/pcrecpp.html +368 -0
- data/vendor/local/share/doc/pcre/html/pcredemo.html +426 -0
- data/vendor/local/share/doc/pcre/html/pcregrep.html +759 -0
- data/vendor/local/share/doc/pcre/html/pcrejit.html +452 -0
- data/vendor/local/share/doc/pcre/html/pcrelimits.html +90 -0
- data/vendor/local/share/doc/pcre/html/pcrematching.html +242 -0
- data/vendor/local/share/doc/pcre/html/pcrepartial.html +509 -0
- data/vendor/local/share/doc/pcre/html/pcrepattern.html +3273 -0
- data/vendor/local/share/doc/pcre/html/pcreperform.html +195 -0
- data/vendor/local/share/doc/pcre/html/pcreposix.html +290 -0
- data/vendor/local/share/doc/pcre/html/pcreprecompile.html +163 -0
- data/vendor/local/share/doc/pcre/html/pcresample.html +110 -0
- data/vendor/local/share/doc/pcre/html/pcrestack.html +225 -0
- data/vendor/local/share/doc/pcre/html/pcresyntax.html +561 -0
- data/vendor/local/share/doc/pcre/html/pcretest.html +1158 -0
- data/vendor/local/share/doc/pcre/html/pcreunicode.html +262 -0
- data/vendor/local/share/doc/pcre/pcre-config.txt +86 -0
- data/vendor/local/share/doc/pcre/pcre.txt +10454 -0
- data/vendor/local/share/doc/pcre/pcregrep.txt +741 -0
- data/vendor/local/share/doc/pcre/pcretest.txt +1087 -0
- data/vendor/local/share/groonga/html/admin.old/js/groonga-admin.ja.js +11 -6
- data/vendor/local/share/groonga/html/admin.old/js/groonga-admin.js +11 -6
- data/vendor/local/share/license/pcre/LICENCE +93 -0
- data/vendor/local/share/man/man1/pcre-config.1 +92 -0
- data/vendor/local/share/man/man1/pcregrep.1 +683 -0
- data/vendor/local/share/man/man1/pcretest.1 +1156 -0
- data/vendor/local/share/man/man3/pcre.3 +230 -0
- data/vendor/local/share/man/man3/pcre16.3 +371 -0
- data/vendor/local/share/man/man3/pcre16_assign_jit_stack.3 +59 -0
- data/vendor/local/share/man/man3/pcre16_compile.3 +96 -0
- data/vendor/local/share/man/man3/pcre16_compile2.3 +101 -0
- data/vendor/local/share/man/man3/pcre16_config.3 +79 -0
- data/vendor/local/share/man/man3/pcre16_copy_named_substring.3 +51 -0
- data/vendor/local/share/man/man3/pcre16_copy_substring.3 +47 -0
- data/vendor/local/share/man/man3/pcre16_dfa_exec.3 +118 -0
- data/vendor/local/share/man/man3/pcre16_exec.3 +99 -0
- data/vendor/local/share/man/man3/pcre16_free_study.3 +31 -0
- data/vendor/local/share/man/man3/pcre16_free_substring.3 +31 -0
- data/vendor/local/share/man/man3/pcre16_free_substring_list.3 +31 -0
- data/vendor/local/share/man/man3/pcre16_fullinfo.3 +103 -0
- data/vendor/local/share/man/man3/pcre16_get_named_substring.3 +54 -0
- data/vendor/local/share/man/man3/pcre16_get_stringnumber.3 +43 -0
- data/vendor/local/share/man/man3/pcre16_get_stringtable_entries.3 +46 -0
- data/vendor/local/share/man/man3/pcre16_get_substring.3 +50 -0
- data/vendor/local/share/man/man3/pcre16_get_substring_list.3 +47 -0
- data/vendor/local/share/man/man3/pcre16_jit_exec.3 +96 -0
- data/vendor/local/share/man/man3/pcre16_jit_stack_alloc.3 +43 -0
- data/vendor/local/share/man/man3/pcre16_jit_stack_free.3 +35 -0
- data/vendor/local/share/man/man3/pcre16_maketables.3 +33 -0
- data/vendor/local/share/man/man3/pcre16_pattern_to_host_byte_order.3 +44 -0
- data/vendor/local/share/man/man3/pcre16_refcount.3 +36 -0
- data/vendor/local/share/man/man3/pcre16_study.3 +54 -0
- data/vendor/local/share/man/man3/pcre16_utf16_to_host_byte_order.3 +45 -0
- data/vendor/local/share/man/man3/pcre16_version.3 +31 -0
- data/vendor/local/share/man/man3/pcre32.3 +369 -0
- data/vendor/local/share/man/man3/pcre32_assign_jit_stack.3 +59 -0
- data/vendor/local/share/man/man3/pcre32_compile.3 +96 -0
- data/vendor/local/share/man/man3/pcre32_compile2.3 +101 -0
- data/vendor/local/share/man/man3/pcre32_config.3 +79 -0
- data/vendor/local/share/man/man3/pcre32_copy_named_substring.3 +51 -0
- data/vendor/local/share/man/man3/pcre32_copy_substring.3 +47 -0
- data/vendor/local/share/man/man3/pcre32_dfa_exec.3 +118 -0
- data/vendor/local/share/man/man3/pcre32_exec.3 +99 -0
- data/vendor/local/share/man/man3/pcre32_free_study.3 +31 -0
- data/vendor/local/share/man/man3/pcre32_free_substring.3 +31 -0
- data/vendor/local/share/man/man3/pcre32_free_substring_list.3 +31 -0
- data/vendor/local/share/man/man3/pcre32_fullinfo.3 +103 -0
- data/vendor/local/share/man/man3/pcre32_get_named_substring.3 +54 -0
- data/vendor/local/share/man/man3/pcre32_get_stringnumber.3 +43 -0
- data/vendor/local/share/man/man3/pcre32_get_stringtable_entries.3 +46 -0
- data/vendor/local/share/man/man3/pcre32_get_substring.3 +50 -0
- data/vendor/local/share/man/man3/pcre32_get_substring_list.3 +47 -0
- data/vendor/local/share/man/man3/pcre32_jit_exec.3 +96 -0
- data/vendor/local/share/man/man3/pcre32_jit_stack_alloc.3 +43 -0
- data/vendor/local/share/man/man3/pcre32_jit_stack_free.3 +35 -0
- data/vendor/local/share/man/man3/pcre32_maketables.3 +33 -0
- data/vendor/local/share/man/man3/pcre32_pattern_to_host_byte_order.3 +44 -0
- data/vendor/local/share/man/man3/pcre32_refcount.3 +36 -0
- data/vendor/local/share/man/man3/pcre32_study.3 +54 -0
- data/vendor/local/share/man/man3/pcre32_utf32_to_host_byte_order.3 +45 -0
- data/vendor/local/share/man/man3/pcre32_version.3 +31 -0
- data/vendor/local/share/man/man3/pcre_assign_jit_stack.3 +59 -0
- data/vendor/local/share/man/man3/pcre_compile.3 +96 -0
- data/vendor/local/share/man/man3/pcre_compile2.3 +101 -0
- data/vendor/local/share/man/man3/pcre_config.3 +79 -0
- data/vendor/local/share/man/man3/pcre_copy_named_substring.3 +51 -0
- data/vendor/local/share/man/man3/pcre_copy_substring.3 +47 -0
- data/vendor/local/share/man/man3/pcre_dfa_exec.3 +118 -0
- data/vendor/local/share/man/man3/pcre_exec.3 +99 -0
- data/vendor/local/share/man/man3/pcre_free_study.3 +31 -0
- data/vendor/local/share/man/man3/pcre_free_substring.3 +31 -0
- data/vendor/local/share/man/man3/pcre_free_substring_list.3 +31 -0
- data/vendor/local/share/man/man3/pcre_fullinfo.3 +103 -0
- data/vendor/local/share/man/man3/pcre_get_named_substring.3 +54 -0
- data/vendor/local/share/man/man3/pcre_get_stringnumber.3 +43 -0
- data/vendor/local/share/man/man3/pcre_get_stringtable_entries.3 +46 -0
- data/vendor/local/share/man/man3/pcre_get_substring.3 +50 -0
- data/vendor/local/share/man/man3/pcre_get_substring_list.3 +47 -0
- data/vendor/local/share/man/man3/pcre_jit_exec.3 +96 -0
- data/vendor/local/share/man/man3/pcre_jit_stack_alloc.3 +43 -0
- data/vendor/local/share/man/man3/pcre_jit_stack_free.3 +35 -0
- data/vendor/local/share/man/man3/pcre_maketables.3 +33 -0
- data/vendor/local/share/man/man3/pcre_pattern_to_host_byte_order.3 +44 -0
- data/vendor/local/share/man/man3/pcre_refcount.3 +36 -0
- data/vendor/local/share/man/man3/pcre_study.3 +54 -0
- data/vendor/local/share/man/man3/pcre_utf16_to_host_byte_order.3 +45 -0
- data/vendor/local/share/man/man3/pcre_utf32_to_host_byte_order.3 +45 -0
- data/vendor/local/share/man/man3/pcre_version.3 +31 -0
- data/vendor/local/share/man/man3/pcreapi.3 +2918 -0
- data/vendor/local/share/man/man3/pcrebuild.3 +550 -0
- data/vendor/local/share/man/man3/pcrecallout.3 +255 -0
- data/vendor/local/share/man/man3/pcrecompat.3 +200 -0
- data/vendor/local/share/man/man3/pcrecpp.3 +348 -0
- data/vendor/local/share/man/man3/pcredemo.3 +424 -0
- data/vendor/local/share/man/man3/pcrejit.3 +431 -0
- data/vendor/local/share/man/man3/pcrelimits.3 +71 -0
- data/vendor/local/share/man/man3/pcrematching.3 +214 -0
- data/vendor/local/share/man/man3/pcrepartial.3 +476 -0
- data/vendor/local/share/man/man3/pcrepattern.3 +3301 -0
- data/vendor/local/share/man/man3/pcreperform.3 +177 -0
- data/vendor/local/share/man/man3/pcreposix.3 +267 -0
- data/vendor/local/share/man/man3/pcreprecompile.3 +155 -0
- data/vendor/local/share/man/man3/pcresample.3 +99 -0
- data/vendor/local/share/man/man3/pcrestack.3 +215 -0
- data/vendor/local/share/man/man3/pcresyntax.3 +540 -0
- data/vendor/local/share/man/man3/pcreunicode.3 +249 -0
- metadata +255 -59
@@ -0,0 +1,177 @@
|
|
1
|
+
.TH PCREPERFORM 3 "09 January 2012" "PCRE 8.30"
|
2
|
+
.SH NAME
|
3
|
+
PCRE - Perl-compatible regular expressions
|
4
|
+
.SH "PCRE PERFORMANCE"
|
5
|
+
.rs
|
6
|
+
.sp
|
7
|
+
Two aspects of performance are discussed below: memory usage and processing
|
8
|
+
time. The way you express your pattern as a regular expression can affect both
|
9
|
+
of them.
|
10
|
+
.
|
11
|
+
.SH "COMPILED PATTERN MEMORY USAGE"
|
12
|
+
.rs
|
13
|
+
.sp
|
14
|
+
Patterns are compiled by PCRE into a reasonably efficient interpretive code, so
|
15
|
+
that most simple patterns do not use much memory. However, there is one case
|
16
|
+
where the memory usage of a compiled pattern can be unexpectedly large. If a
|
17
|
+
parenthesized subpattern has a quantifier with a minimum greater than 1 and/or
|
18
|
+
a limited maximum, the whole subpattern is repeated in the compiled code. For
|
19
|
+
example, the pattern
|
20
|
+
.sp
|
21
|
+
(abc|def){2,4}
|
22
|
+
.sp
|
23
|
+
is compiled as if it were
|
24
|
+
.sp
|
25
|
+
(abc|def)(abc|def)((abc|def)(abc|def)?)?
|
26
|
+
.sp
|
27
|
+
(Technical aside: It is done this way so that backtrack points within each of
|
28
|
+
the repetitions can be independently maintained.)
|
29
|
+
.P
|
30
|
+
For regular expressions whose quantifiers use only small numbers, this is not
|
31
|
+
usually a problem. However, if the numbers are large, and particularly if such
|
32
|
+
repetitions are nested, the memory usage can become an embarrassment. For
|
33
|
+
example, the very simple pattern
|
34
|
+
.sp
|
35
|
+
((ab){1,1000}c){1,3}
|
36
|
+
.sp
|
37
|
+
uses 51K bytes when compiled using the 8-bit library. When PCRE is compiled
|
38
|
+
with its default internal pointer size of two bytes, the size limit on a
|
39
|
+
compiled pattern is 64K data units, and this is reached with the above pattern
|
40
|
+
if the outer repetition is increased from 3 to 4. PCRE can be compiled to use
|
41
|
+
larger internal pointers and thus handle larger compiled patterns, but it is
|
42
|
+
better to try to rewrite your pattern to use less memory if you can.
|
43
|
+
.P
|
44
|
+
One way of reducing the memory usage for such patterns is to make use of PCRE's
|
45
|
+
.\" HTML <a href="pcrepattern.html#subpatternsassubroutines">
|
46
|
+
.\" </a>
|
47
|
+
"subroutine"
|
48
|
+
.\"
|
49
|
+
facility. Re-writing the above pattern as
|
50
|
+
.sp
|
51
|
+
((ab)(?2){0,999}c)(?1){0,2}
|
52
|
+
.sp
|
53
|
+
reduces the memory requirements to 18K, and indeed it remains under 20K even
|
54
|
+
with the outer repetition increased to 100. However, this pattern is not
|
55
|
+
exactly equivalent, because the "subroutine" calls are treated as
|
56
|
+
.\" HTML <a href="pcrepattern.html#atomicgroup">
|
57
|
+
.\" </a>
|
58
|
+
atomic groups
|
59
|
+
.\"
|
60
|
+
into which there can be no backtracking if there is a subsequent matching
|
61
|
+
failure. Therefore, PCRE cannot do this kind of rewriting automatically.
|
62
|
+
Furthermore, there is a noticeable loss of speed when executing the modified
|
63
|
+
pattern. Nevertheless, if the atomic grouping is not a problem and the loss of
|
64
|
+
speed is acceptable, this kind of rewriting will allow you to process patterns
|
65
|
+
that PCRE cannot otherwise handle.
|
66
|
+
.
|
67
|
+
.
|
68
|
+
.SH "STACK USAGE AT RUN TIME"
|
69
|
+
.rs
|
70
|
+
.sp
|
71
|
+
When \fBpcre_exec()\fP or \fBpcre[16|32]_exec()\fP is used for matching, certain
|
72
|
+
kinds of pattern can cause it to use large amounts of the process stack. In
|
73
|
+
some environments the default process stack is quite small, and if it runs out
|
74
|
+
the result is often SIGSEGV. This issue is probably the most frequently raised
|
75
|
+
problem with PCRE. Rewriting your pattern can often help. The
|
76
|
+
.\" HREF
|
77
|
+
\fBpcrestack\fP
|
78
|
+
.\"
|
79
|
+
documentation discusses this issue in detail.
|
80
|
+
.
|
81
|
+
.
|
82
|
+
.SH "PROCESSING TIME"
|
83
|
+
.rs
|
84
|
+
.sp
|
85
|
+
Certain items in regular expression patterns are processed more efficiently
|
86
|
+
than others. It is more efficient to use a character class like [aeiou] than a
|
87
|
+
set of single-character alternatives such as (a|e|i|o|u). In general, the
|
88
|
+
simplest construction that provides the required behaviour is usually the most
|
89
|
+
efficient. Jeffrey Friedl's book contains a lot of useful general discussion
|
90
|
+
about optimizing regular expressions for efficient performance. This document
|
91
|
+
contains a few observations about PCRE.
|
92
|
+
.P
|
93
|
+
Using Unicode character properties (the \ep, \eP, and \eX escapes) is slow,
|
94
|
+
because PCRE has to use a multi-stage table lookup whenever it needs a
|
95
|
+
character's property. If you can find an alternative pattern that does not use
|
96
|
+
character properties, it will probably be faster.
|
97
|
+
.P
|
98
|
+
By default, the escape sequences \eb, \ed, \es, and \ew, and the POSIX
|
99
|
+
character classes such as [:alpha:] do not use Unicode properties, partly for
|
100
|
+
backwards compatibility, and partly for performance reasons. However, you can
|
101
|
+
set PCRE_UCP if you want Unicode character properties to be used. This can
|
102
|
+
double the matching time for items such as \ed, when matched with
|
103
|
+
a traditional matching function; the performance loss is less with
|
104
|
+
a DFA matching function, and in both cases there is not much difference for
|
105
|
+
\eb.
|
106
|
+
.P
|
107
|
+
When a pattern begins with .* not in parentheses, or in parentheses that are
|
108
|
+
not the subject of a backreference, and the PCRE_DOTALL option is set, the
|
109
|
+
pattern is implicitly anchored by PCRE, since it can match only at the start of
|
110
|
+
a subject string. However, if PCRE_DOTALL is not set, PCRE cannot make this
|
111
|
+
optimization, because the . metacharacter does not then match a newline, and if
|
112
|
+
the subject string contains newlines, the pattern may match from the character
|
113
|
+
immediately following one of them instead of from the very start. For example,
|
114
|
+
the pattern
|
115
|
+
.sp
|
116
|
+
.*second
|
117
|
+
.sp
|
118
|
+
matches the subject "first\enand second" (where \en stands for a newline
|
119
|
+
character), with the match starting at the seventh character. In order to do
|
120
|
+
this, PCRE has to retry the match starting after every newline in the subject.
|
121
|
+
.P
|
122
|
+
If you are using such a pattern with subject strings that do not contain
|
123
|
+
newlines, the best performance is obtained by setting PCRE_DOTALL, or starting
|
124
|
+
the pattern with ^.* or ^.*? to indicate explicit anchoring. That saves PCRE
|
125
|
+
from having to scan along the subject looking for a newline to restart at.
|
126
|
+
.P
|
127
|
+
Beware of patterns that contain nested indefinite repeats. These can take a
|
128
|
+
long time to run when applied to a string that does not match. Consider the
|
129
|
+
pattern fragment
|
130
|
+
.sp
|
131
|
+
^(a+)*
|
132
|
+
.sp
|
133
|
+
This can match "aaaa" in 16 different ways, and this number increases very
|
134
|
+
rapidly as the string gets longer. (The * repeat can match 0, 1, 2, 3, or 4
|
135
|
+
times, and for each of those cases other than 0 or 4, the + repeats can match
|
136
|
+
different numbers of times.) When the remainder of the pattern is such that the
|
137
|
+
entire match is going to fail, PCRE has in principle to try every possible
|
138
|
+
variation, and this can take an extremely long time, even for relatively short
|
139
|
+
strings.
|
140
|
+
.P
|
141
|
+
An optimization catches some of the more simple cases such as
|
142
|
+
.sp
|
143
|
+
(a+)*b
|
144
|
+
.sp
|
145
|
+
where a literal character follows. Before embarking on the standard matching
|
146
|
+
procedure, PCRE checks that there is a "b" later in the subject string, and if
|
147
|
+
there is not, it fails the match immediately. However, when there is no
|
148
|
+
following literal this optimization cannot be used. You can see the difference
|
149
|
+
by comparing the behaviour of
|
150
|
+
.sp
|
151
|
+
(a+)*\ed
|
152
|
+
.sp
|
153
|
+
with the pattern above. The former gives a failure almost instantly when
|
154
|
+
applied to a whole line of "a" characters, whereas the latter takes an
|
155
|
+
appreciable time with strings longer than about 20 characters.
|
156
|
+
.P
|
157
|
+
In many cases, the solution to this kind of performance issue is to use an
|
158
|
+
atomic group or a possessive quantifier.
|
159
|
+
.
|
160
|
+
.
|
161
|
+
.SH AUTHOR
|
162
|
+
.rs
|
163
|
+
.sp
|
164
|
+
.nf
|
165
|
+
Philip Hazel
|
166
|
+
University Computing Service
|
167
|
+
Cambridge CB2 3QH, England.
|
168
|
+
.fi
|
169
|
+
.
|
170
|
+
.
|
171
|
+
.SH REVISION
|
172
|
+
.rs
|
173
|
+
.sp
|
174
|
+
.nf
|
175
|
+
Last updated: 25 August 2012
|
176
|
+
Copyright (c) 1997-2012 University of Cambridge.
|
177
|
+
.fi
|
@@ -0,0 +1,267 @@
|
|
1
|
+
.TH PCREPOSIX 3 "09 January 2012" "PCRE 8.30"
|
2
|
+
.SH NAME
|
3
|
+
PCRE - Perl-compatible regular expressions.
|
4
|
+
.SH "SYNOPSIS"
|
5
|
+
.rs
|
6
|
+
.sp
|
7
|
+
.B #include <pcreposix.h>
|
8
|
+
.PP
|
9
|
+
.nf
|
10
|
+
.B int regcomp(regex_t *\fIpreg\fP, const char *\fIpattern\fP,
|
11
|
+
.B " int \fIcflags\fP);"
|
12
|
+
.sp
|
13
|
+
.B int regexec(regex_t *\fIpreg\fP, const char *\fIstring\fP,
|
14
|
+
.B " size_t \fInmatch\fP, regmatch_t \fIpmatch\fP[], int \fIeflags\fP);"
|
15
|
+
.B " size_t regerror(int \fIerrcode\fP, const regex_t *\fIpreg\fP,"
|
16
|
+
.B " char *\fIerrbuf\fP, size_t \fIerrbuf_size\fP);"
|
17
|
+
.sp
|
18
|
+
.B void regfree(regex_t *\fIpreg\fP);
|
19
|
+
.fi
|
20
|
+
.
|
21
|
+
.SH DESCRIPTION
|
22
|
+
.rs
|
23
|
+
.sp
|
24
|
+
This set of functions provides a POSIX-style API for the PCRE regular
|
25
|
+
expression 8-bit library. See the
|
26
|
+
.\" HREF
|
27
|
+
\fBpcreapi\fP
|
28
|
+
.\"
|
29
|
+
documentation for a description of PCRE's native API, which contains much
|
30
|
+
additional functionality. There is no POSIX-style wrapper for PCRE's 16-bit
|
31
|
+
and 32-bit library.
|
32
|
+
.P
|
33
|
+
The functions described here are just wrapper functions that ultimately call
|
34
|
+
the PCRE native API. Their prototypes are defined in the \fBpcreposix.h\fP
|
35
|
+
header file, and on Unix systems the library itself is called
|
36
|
+
\fBpcreposix.a\fP, so can be accessed by adding \fB-lpcreposix\fP to the
|
37
|
+
command for linking an application that uses them. Because the POSIX functions
|
38
|
+
call the native ones, it is also necessary to add \fB-lpcre\fP.
|
39
|
+
.P
|
40
|
+
I have implemented only those POSIX option bits that can be reasonably mapped
|
41
|
+
to PCRE native options. In addition, the option REG_EXTENDED is defined with
|
42
|
+
the value zero. This has no effect, but since programs that are written to the
|
43
|
+
POSIX interface often use it, this makes it easier to slot in PCRE as a
|
44
|
+
replacement library. Other POSIX options are not even defined.
|
45
|
+
.P
|
46
|
+
There are also some other options that are not defined by POSIX. These have
|
47
|
+
been added at the request of users who want to make use of certain
|
48
|
+
PCRE-specific features via the POSIX calling interface.
|
49
|
+
.P
|
50
|
+
When PCRE is called via these functions, it is only the API that is POSIX-like
|
51
|
+
in style. The syntax and semantics of the regular expressions themselves are
|
52
|
+
still those of Perl, subject to the setting of various PCRE options, as
|
53
|
+
described below. "POSIX-like in style" means that the API approximates to the
|
54
|
+
POSIX definition; it is not fully POSIX-compatible, and in multi-byte encoding
|
55
|
+
domains it is probably even less compatible.
|
56
|
+
.P
|
57
|
+
The header for these functions is supplied as \fBpcreposix.h\fP to avoid any
|
58
|
+
potential clash with other POSIX libraries. It can, of course, be renamed or
|
59
|
+
aliased as \fBregex.h\fP, which is the "correct" name. It provides two
|
60
|
+
structure types, \fIregex_t\fP for compiled internal forms, and
|
61
|
+
\fIregmatch_t\fP for returning captured substrings. It also defines some
|
62
|
+
constants whose names start with "REG_"; these are used for setting options and
|
63
|
+
identifying error codes.
|
64
|
+
.
|
65
|
+
.
|
66
|
+
.SH "COMPILING A PATTERN"
|
67
|
+
.rs
|
68
|
+
.sp
|
69
|
+
The function \fBregcomp()\fP is called to compile a pattern into an
|
70
|
+
internal form. The pattern is a C string terminated by a binary zero, and
|
71
|
+
is passed in the argument \fIpattern\fP. The \fIpreg\fP argument is a pointer
|
72
|
+
to a \fBregex_t\fP structure that is used as a base for storing information
|
73
|
+
about the compiled regular expression.
|
74
|
+
.P
|
75
|
+
The argument \fIcflags\fP is either zero, or contains one or more of the bits
|
76
|
+
defined by the following macros:
|
77
|
+
.sp
|
78
|
+
REG_DOTALL
|
79
|
+
.sp
|
80
|
+
The PCRE_DOTALL option is set when the regular expression is passed for
|
81
|
+
compilation to the native function. Note that REG_DOTALL is not part of the
|
82
|
+
POSIX standard.
|
83
|
+
.sp
|
84
|
+
REG_ICASE
|
85
|
+
.sp
|
86
|
+
The PCRE_CASELESS option is set when the regular expression is passed for
|
87
|
+
compilation to the native function.
|
88
|
+
.sp
|
89
|
+
REG_NEWLINE
|
90
|
+
.sp
|
91
|
+
The PCRE_MULTILINE option is set when the regular expression is passed for
|
92
|
+
compilation to the native function. Note that this does \fInot\fP mimic the
|
93
|
+
defined POSIX behaviour for REG_NEWLINE (see the following section).
|
94
|
+
.sp
|
95
|
+
REG_NOSUB
|
96
|
+
.sp
|
97
|
+
The PCRE_NO_AUTO_CAPTURE option is set when the regular expression is passed
|
98
|
+
for compilation to the native function. In addition, when a pattern that is
|
99
|
+
compiled with this flag is passed to \fBregexec()\fP for matching, the
|
100
|
+
\fInmatch\fP and \fIpmatch\fP arguments are ignored, and no captured strings
|
101
|
+
are returned.
|
102
|
+
.sp
|
103
|
+
REG_UCP
|
104
|
+
.sp
|
105
|
+
The PCRE_UCP option is set when the regular expression is passed for
|
106
|
+
compilation to the native function. This causes PCRE to use Unicode properties
|
107
|
+
when matchine \ed, \ew, etc., instead of just recognizing ASCII values. Note
|
108
|
+
that REG_UTF8 is not part of the POSIX standard.
|
109
|
+
.sp
|
110
|
+
REG_UNGREEDY
|
111
|
+
.sp
|
112
|
+
The PCRE_UNGREEDY option is set when the regular expression is passed for
|
113
|
+
compilation to the native function. Note that REG_UNGREEDY is not part of the
|
114
|
+
POSIX standard.
|
115
|
+
.sp
|
116
|
+
REG_UTF8
|
117
|
+
.sp
|
118
|
+
The PCRE_UTF8 option is set when the regular expression is passed for
|
119
|
+
compilation to the native function. This causes the pattern itself and all data
|
120
|
+
strings used for matching it to be treated as UTF-8 strings. Note that REG_UTF8
|
121
|
+
is not part of the POSIX standard.
|
122
|
+
.P
|
123
|
+
In the absence of these flags, no options are passed to the native function.
|
124
|
+
This means the the regex is compiled with PCRE default semantics. In
|
125
|
+
particular, the way it handles newline characters in the subject string is the
|
126
|
+
Perl way, not the POSIX way. Note that setting PCRE_MULTILINE has only
|
127
|
+
\fIsome\fP of the effects specified for REG_NEWLINE. It does not affect the way
|
128
|
+
newlines are matched by . (they are not) or by a negative class such as [^a]
|
129
|
+
(they are).
|
130
|
+
.P
|
131
|
+
The yield of \fBregcomp()\fP is zero on success, and non-zero otherwise. The
|
132
|
+
\fIpreg\fP structure is filled in on success, and one member of the structure
|
133
|
+
is public: \fIre_nsub\fP contains the number of capturing subpatterns in
|
134
|
+
the regular expression. Various error codes are defined in the header file.
|
135
|
+
.P
|
136
|
+
NOTE: If the yield of \fBregcomp()\fP is non-zero, you must not attempt to
|
137
|
+
use the contents of the \fIpreg\fP structure. If, for example, you pass it to
|
138
|
+
\fBregexec()\fP, the result is undefined and your program is likely to crash.
|
139
|
+
.
|
140
|
+
.
|
141
|
+
.SH "MATCHING NEWLINE CHARACTERS"
|
142
|
+
.rs
|
143
|
+
.sp
|
144
|
+
This area is not simple, because POSIX and Perl take different views of things.
|
145
|
+
It is not possible to get PCRE to obey POSIX semantics, but then PCRE was never
|
146
|
+
intended to be a POSIX engine. The following table lists the different
|
147
|
+
possibilities for matching newline characters in PCRE:
|
148
|
+
.sp
|
149
|
+
Default Change with
|
150
|
+
.sp
|
151
|
+
. matches newline no PCRE_DOTALL
|
152
|
+
newline matches [^a] yes not changeable
|
153
|
+
$ matches \en at end yes PCRE_DOLLARENDONLY
|
154
|
+
$ matches \en in middle no PCRE_MULTILINE
|
155
|
+
^ matches \en in middle no PCRE_MULTILINE
|
156
|
+
.sp
|
157
|
+
This is the equivalent table for POSIX:
|
158
|
+
.sp
|
159
|
+
Default Change with
|
160
|
+
.sp
|
161
|
+
. matches newline yes REG_NEWLINE
|
162
|
+
newline matches [^a] yes REG_NEWLINE
|
163
|
+
$ matches \en at end no REG_NEWLINE
|
164
|
+
$ matches \en in middle no REG_NEWLINE
|
165
|
+
^ matches \en in middle no REG_NEWLINE
|
166
|
+
.sp
|
167
|
+
PCRE's behaviour is the same as Perl's, except that there is no equivalent for
|
168
|
+
PCRE_DOLLAR_ENDONLY in Perl. In both PCRE and Perl, there is no way to stop
|
169
|
+
newline from matching [^a].
|
170
|
+
.P
|
171
|
+
The default POSIX newline handling can be obtained by setting PCRE_DOTALL and
|
172
|
+
PCRE_DOLLAR_ENDONLY, but there is no way to make PCRE behave exactly as for the
|
173
|
+
REG_NEWLINE action.
|
174
|
+
.
|
175
|
+
.
|
176
|
+
.SH "MATCHING A PATTERN"
|
177
|
+
.rs
|
178
|
+
.sp
|
179
|
+
The function \fBregexec()\fP is called to match a compiled pattern \fIpreg\fP
|
180
|
+
against a given \fIstring\fP, which is by default terminated by a zero byte
|
181
|
+
(but see REG_STARTEND below), subject to the options in \fIeflags\fP. These can
|
182
|
+
be:
|
183
|
+
.sp
|
184
|
+
REG_NOTBOL
|
185
|
+
.sp
|
186
|
+
The PCRE_NOTBOL option is set when calling the underlying PCRE matching
|
187
|
+
function.
|
188
|
+
.sp
|
189
|
+
REG_NOTEMPTY
|
190
|
+
.sp
|
191
|
+
The PCRE_NOTEMPTY option is set when calling the underlying PCRE matching
|
192
|
+
function. Note that REG_NOTEMPTY is not part of the POSIX standard. However,
|
193
|
+
setting this option can give more POSIX-like behaviour in some situations.
|
194
|
+
.sp
|
195
|
+
REG_NOTEOL
|
196
|
+
.sp
|
197
|
+
The PCRE_NOTEOL option is set when calling the underlying PCRE matching
|
198
|
+
function.
|
199
|
+
.sp
|
200
|
+
REG_STARTEND
|
201
|
+
.sp
|
202
|
+
The string is considered to start at \fIstring\fP + \fIpmatch[0].rm_so\fP and
|
203
|
+
to have a terminating NUL located at \fIstring\fP + \fIpmatch[0].rm_eo\fP
|
204
|
+
(there need not actually be a NUL at that location), regardless of the value of
|
205
|
+
\fInmatch\fP. This is a BSD extension, compatible with but not specified by
|
206
|
+
IEEE Standard 1003.2 (POSIX.2), and should be used with caution in software
|
207
|
+
intended to be portable to other systems. Note that a non-zero \fIrm_so\fP does
|
208
|
+
not imply REG_NOTBOL; REG_STARTEND affects only the location of the string, not
|
209
|
+
how it is matched.
|
210
|
+
.P
|
211
|
+
If the pattern was compiled with the REG_NOSUB flag, no data about any matched
|
212
|
+
strings is returned. The \fInmatch\fP and \fIpmatch\fP arguments of
|
213
|
+
\fBregexec()\fP are ignored.
|
214
|
+
.P
|
215
|
+
If the value of \fInmatch\fP is zero, or if the value \fIpmatch\fP is NULL,
|
216
|
+
no data about any matched strings is returned.
|
217
|
+
.P
|
218
|
+
Otherwise,the portion of the string that was matched, and also any captured
|
219
|
+
substrings, are returned via the \fIpmatch\fP argument, which points to an
|
220
|
+
array of \fInmatch\fP structures of type \fIregmatch_t\fP, containing the
|
221
|
+
members \fIrm_so\fP and \fIrm_eo\fP. These contain the offset to the first
|
222
|
+
character of each substring and the offset to the first character after the end
|
223
|
+
of each substring, respectively. The 0th element of the vector relates to the
|
224
|
+
entire portion of \fIstring\fP that was matched; subsequent elements relate to
|
225
|
+
the capturing subpatterns of the regular expression. Unused entries in the
|
226
|
+
array have both structure members set to -1.
|
227
|
+
.P
|
228
|
+
A successful match yields a zero return; various error codes are defined in the
|
229
|
+
header file, of which REG_NOMATCH is the "expected" failure code.
|
230
|
+
.
|
231
|
+
.
|
232
|
+
.SH "ERROR MESSAGES"
|
233
|
+
.rs
|
234
|
+
.sp
|
235
|
+
The \fBregerror()\fP function maps a non-zero errorcode from either
|
236
|
+
\fBregcomp()\fP or \fBregexec()\fP to a printable message. If \fIpreg\fP is not
|
237
|
+
NULL, the error should have arisen from the use of that structure. A message
|
238
|
+
terminated by a binary zero is placed in \fIerrbuf\fP. The length of the
|
239
|
+
message, including the zero, is limited to \fIerrbuf_size\fP. The yield of the
|
240
|
+
function is the size of buffer needed to hold the whole message.
|
241
|
+
.
|
242
|
+
.
|
243
|
+
.SH MEMORY USAGE
|
244
|
+
.rs
|
245
|
+
.sp
|
246
|
+
Compiling a regular expression causes memory to be allocated and associated
|
247
|
+
with the \fIpreg\fP structure. The function \fBregfree()\fP frees all such
|
248
|
+
memory, after which \fIpreg\fP may no longer be used as a compiled expression.
|
249
|
+
.
|
250
|
+
.
|
251
|
+
.SH AUTHOR
|
252
|
+
.rs
|
253
|
+
.sp
|
254
|
+
.nf
|
255
|
+
Philip Hazel
|
256
|
+
University Computing Service
|
257
|
+
Cambridge CB2 3QH, England.
|
258
|
+
.fi
|
259
|
+
.
|
260
|
+
.
|
261
|
+
.SH REVISION
|
262
|
+
.rs
|
263
|
+
.sp
|
264
|
+
.nf
|
265
|
+
Last updated: 09 January 2012
|
266
|
+
Copyright (c) 1997-2012 University of Cambridge.
|
267
|
+
.fi
|
@@ -0,0 +1,155 @@
|
|
1
|
+
.TH PCREPRECOMPILE 3 "12 November 2013" "PCRE 8.34"
|
2
|
+
.SH NAME
|
3
|
+
PCRE - Perl-compatible regular expressions
|
4
|
+
.SH "SAVING AND RE-USING PRECOMPILED PCRE PATTERNS"
|
5
|
+
.rs
|
6
|
+
.sp
|
7
|
+
If you are running an application that uses a large number of regular
|
8
|
+
expression patterns, it may be useful to store them in a precompiled form
|
9
|
+
instead of having to compile them every time the application is run.
|
10
|
+
If you are not using any private character tables (see the
|
11
|
+
.\" HREF
|
12
|
+
\fBpcre_maketables()\fP
|
13
|
+
.\"
|
14
|
+
documentation), this is relatively straightforward. If you are using private
|
15
|
+
tables, it is a little bit more complicated. However, if you are using the
|
16
|
+
just-in-time optimization feature, it is not possible to save and reload the
|
17
|
+
JIT data.
|
18
|
+
.P
|
19
|
+
If you save compiled patterns to a file, you can copy them to a different host
|
20
|
+
and run them there. If the two hosts have different endianness (byte order),
|
21
|
+
you should run the \fBpcre[16|32]_pattern_to_host_byte_order()\fP function on the
|
22
|
+
new host before trying to match the pattern. The matching functions return
|
23
|
+
PCRE_ERROR_BADENDIANNESS if they detect a pattern with the wrong endianness.
|
24
|
+
.P
|
25
|
+
Compiling regular expressions with one version of PCRE for use with a different
|
26
|
+
version is not guaranteed to work and may cause crashes, and saving and
|
27
|
+
restoring a compiled pattern loses any JIT optimization data.
|
28
|
+
.
|
29
|
+
.
|
30
|
+
.SH "SAVING A COMPILED PATTERN"
|
31
|
+
.rs
|
32
|
+
.sp
|
33
|
+
The value returned by \fBpcre[16|32]_compile()\fP points to a single block of
|
34
|
+
memory that holds the compiled pattern and associated data. You can find the
|
35
|
+
length of this block in bytes by calling \fBpcre[16|32]_fullinfo()\fP with an
|
36
|
+
argument of PCRE_INFO_SIZE. You can then save the data in any appropriate
|
37
|
+
manner. Here is sample code for the 8-bit library that compiles a pattern and
|
38
|
+
writes it to a file. It assumes that the variable \fIfd\fP refers to a file
|
39
|
+
that is open for output:
|
40
|
+
.sp
|
41
|
+
int erroroffset, rc, size;
|
42
|
+
char *error;
|
43
|
+
pcre *re;
|
44
|
+
.sp
|
45
|
+
re = pcre_compile("my pattern", 0, &error, &erroroffset, NULL);
|
46
|
+
if (re == NULL) { ... handle errors ... }
|
47
|
+
rc = pcre_fullinfo(re, NULL, PCRE_INFO_SIZE, &size);
|
48
|
+
if (rc < 0) { ... handle errors ... }
|
49
|
+
rc = fwrite(re, 1, size, fd);
|
50
|
+
if (rc != size) { ... handle errors ... }
|
51
|
+
.sp
|
52
|
+
In this example, the bytes that comprise the compiled pattern are copied
|
53
|
+
exactly. Note that this is binary data that may contain any of the 256 possible
|
54
|
+
byte values. On systems that make a distinction between binary and non-binary
|
55
|
+
data, be sure that the file is opened for binary output.
|
56
|
+
.P
|
57
|
+
If you want to write more than one pattern to a file, you will have to devise a
|
58
|
+
way of separating them. For binary data, preceding each pattern with its length
|
59
|
+
is probably the most straightforward approach. Another possibility is to write
|
60
|
+
out the data in hexadecimal instead of binary, one pattern to a line.
|
61
|
+
.P
|
62
|
+
Saving compiled patterns in a file is only one possible way of storing them for
|
63
|
+
later use. They could equally well be saved in a database, or in the memory of
|
64
|
+
some daemon process that passes them via sockets to the processes that want
|
65
|
+
them.
|
66
|
+
.P
|
67
|
+
If the pattern has been studied, it is also possible to save the normal study
|
68
|
+
data in a similar way to the compiled pattern itself. However, if the
|
69
|
+
PCRE_STUDY_JIT_COMPILE was used, the just-in-time data that is created cannot
|
70
|
+
be saved because it is too dependent on the current environment. When studying
|
71
|
+
generates additional information, \fBpcre[16|32]_study()\fP returns a pointer to a
|
72
|
+
\fBpcre[16|32]_extra\fP data block. Its format is defined in the
|
73
|
+
.\" HTML <a href="pcreapi.html#extradata">
|
74
|
+
.\" </a>
|
75
|
+
section on matching a pattern
|
76
|
+
.\"
|
77
|
+
in the
|
78
|
+
.\" HREF
|
79
|
+
\fBpcreapi\fP
|
80
|
+
.\"
|
81
|
+
documentation. The \fIstudy_data\fP field points to the binary study data, and
|
82
|
+
this is what you must save (not the \fBpcre[16|32]_extra\fP block itself). The
|
83
|
+
length of the study data can be obtained by calling \fBpcre[16|32]_fullinfo()\fP
|
84
|
+
with an argument of PCRE_INFO_STUDYSIZE. Remember to check that
|
85
|
+
\fBpcre[16|32]_study()\fP did return a non-NULL value before trying to save the
|
86
|
+
study data.
|
87
|
+
.
|
88
|
+
.
|
89
|
+
.SH "RE-USING A PRECOMPILED PATTERN"
|
90
|
+
.rs
|
91
|
+
.sp
|
92
|
+
Re-using a precompiled pattern is straightforward. Having reloaded it into main
|
93
|
+
memory, called \fBpcre[16|32]_pattern_to_host_byte_order()\fP if necessary, you
|
94
|
+
pass its pointer to \fBpcre[16|32]_exec()\fP or \fBpcre[16|32]_dfa_exec()\fP in
|
95
|
+
the usual way.
|
96
|
+
.P
|
97
|
+
However, if you passed a pointer to custom character tables when the pattern
|
98
|
+
was compiled (the \fItableptr\fP argument of \fBpcre[16|32]_compile()\fP), you
|
99
|
+
must now pass a similar pointer to \fBpcre[16|32]_exec()\fP or
|
100
|
+
\fBpcre[16|32]_dfa_exec()\fP, because the value saved with the compiled pattern
|
101
|
+
will obviously be nonsense. A field in a \fBpcre[16|32]_extra()\fP block is used
|
102
|
+
to pass this data, as described in the
|
103
|
+
.\" HTML <a href="pcreapi.html#extradata">
|
104
|
+
.\" </a>
|
105
|
+
section on matching a pattern
|
106
|
+
.\"
|
107
|
+
in the
|
108
|
+
.\" HREF
|
109
|
+
\fBpcreapi\fP
|
110
|
+
.\"
|
111
|
+
documentation.
|
112
|
+
.P
|
113
|
+
\fBWarning:\fP The tables that \fBpcre_exec()\fP and \fBpcre_dfa_exec()\fP use
|
114
|
+
must be the same as those that were used when the pattern was compiled. If this
|
115
|
+
is not the case, the behaviour is undefined.
|
116
|
+
.P
|
117
|
+
If you did not provide custom character tables when the pattern was compiled,
|
118
|
+
the pointer in the compiled pattern is NULL, which causes the matching
|
119
|
+
functions to use PCRE's internal tables. Thus, you do not need to take any
|
120
|
+
special action at run time in this case.
|
121
|
+
.P
|
122
|
+
If you saved study data with the compiled pattern, you need to create your own
|
123
|
+
\fBpcre[16|32]_extra\fP data block and set the \fIstudy_data\fP field to point
|
124
|
+
to the reloaded study data. You must also set the PCRE_EXTRA_STUDY_DATA bit in
|
125
|
+
the \fIflags\fP field to indicate that study data is present. Then pass the
|
126
|
+
\fBpcre[16|32]_extra\fP block to the matching function in the usual way. If the
|
127
|
+
pattern was studied for just-in-time optimization, that data cannot be saved,
|
128
|
+
and so is lost by a save/restore cycle.
|
129
|
+
.
|
130
|
+
.
|
131
|
+
.SH "COMPATIBILITY WITH DIFFERENT PCRE RELEASES"
|
132
|
+
.rs
|
133
|
+
.sp
|
134
|
+
In general, it is safest to recompile all saved patterns when you update to a
|
135
|
+
new PCRE release, though not all updates actually require this.
|
136
|
+
.
|
137
|
+
.
|
138
|
+
.
|
139
|
+
.SH AUTHOR
|
140
|
+
.rs
|
141
|
+
.sp
|
142
|
+
.nf
|
143
|
+
Philip Hazel
|
144
|
+
University Computing Service
|
145
|
+
Cambridge CB2 3QH, England.
|
146
|
+
.fi
|
147
|
+
.
|
148
|
+
.
|
149
|
+
.SH REVISION
|
150
|
+
.rs
|
151
|
+
.sp
|
152
|
+
.nf
|
153
|
+
Last updated: 12 November 2013
|
154
|
+
Copyright (c) 1997-2013 University of Cambridge.
|
155
|
+
.fi
|