esruby 0.0.0 → 0.0.2
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/LICENSE +6 -6
- data/bin/esruby +9 -0
- data/lib/esruby.rb +8 -0
- data/resources/mruby/build_config.rb +0 -1
- data/resources/mruby/mrbgems/mruby-print/mrblib/print.rb +1 -1
- data/resources/project_template/app/app.rb +2 -0
- data/resources/project_template/config.rb +35 -0
- data/resources/project_template/www/index.html +17 -0
- metadata +6 -377
- data/resources/mruby/bin/mirb +0 -0
- data/resources/mruby/bin/mrbc +0 -0
- data/resources/mruby/bin/mruby +0 -0
- data/resources/mruby/bin/mruby-strip +0 -0
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/README.md +0 -82
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/mrbgem.rake +0 -63
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/mrblib/regexp_pcre.rb +0 -232
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/mrblib/string_pcre.rb +0 -333
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/132html +0 -313
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/AUTHORS +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/CMakeLists.txt +0 -959
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/COPYING +0 -5
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/ChangeLog +0 -4981
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/CheckMan +0 -67
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/CleanTxt +0 -113
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/Detrail +0 -35
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/HACKING +0 -473
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/INSTALL +0 -370
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/LICENCE +0 -92
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/Makefile.am +0 -877
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/Makefile.in +0 -2917
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/NEWS +0 -611
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/NON-AUTOTOOLS-BUILD +0 -639
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/NON-UNIX-USE +0 -7
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/PrepareRelease +0 -253
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/README +0 -935
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/RunGrepTest +0 -551
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/RunTest +0 -1015
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/RunTest.bat +0 -616
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/aclocal.m4 +0 -1230
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/autom4te.cache/output.0 +0 -21280
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/autom4te.cache/output.1 +0 -21280
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/autom4te.cache/requests +0 -273
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/autom4te.cache/traces.0 +0 -2421
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/autom4te.cache/traces.1 +0 -1144
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/cmake/COPYING-CMAKE-SCRIPTS +0 -22
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/cmake/FindEditline.cmake +0 -17
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/cmake/FindPackageHandleStandardArgs.cmake +0 -58
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/cmake/FindReadline.cmake +0 -29
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/compile +0 -343
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/config-cmake.h.in +0 -54
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/config.guess +0 -1552
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/config.h +0 -392
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/config.h.generic +0 -392
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/config.h.in +0 -343
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/config.sub +0 -1804
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/configure +0 -21280
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/configure.ac +0 -1082
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/depcomp +0 -708
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/dftables.c +0 -212
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/index.html +0 -180
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre-config.html +0 -109
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre.html +0 -204
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre16.html +0 -383
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_assign_jit_stack.html +0 -76
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_compile.html +0 -108
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_compile2.html +0 -112
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_config.html +0 -91
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_copy_named_substring.html +0 -65
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_copy_substring.html +0 -61
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_dfa_exec.html +0 -128
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_exec.html +0 -110
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_free_study.html +0 -46
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_free_substring.html +0 -46
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_free_substring_list.html +0 -46
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_fullinfo.html +0 -108
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_get_named_substring.html +0 -68
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_get_stringnumber.html +0 -57
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_get_stringtable_entries.html +0 -60
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_get_substring.html +0 -64
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_get_substring_list.html +0 -61
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_jit_exec.html +0 -108
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_jit_stack_alloc.html +0 -55
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_jit_stack_free.html +0 -48
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_maketables.html +0 -48
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_pattern_to_host_byte_order.html +0 -58
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_refcount.html +0 -51
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_study.html +0 -68
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_utf16_to_host_byte_order.html +0 -57
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcre_version.html +0 -46
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcreapi.html +0 -2786
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcrebuild.html +0 -517
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcrecallout.html +0 -243
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcrecompat.html +0 -216
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcrecpp.html +0 -368
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcredemo.html +0 -426
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcregrep.html +0 -757
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcrejit.html +0 -458
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcrelimits.html +0 -86
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcrematching.html +0 -233
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcrepartial.html +0 -474
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcrepattern.html +0 -2953
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcreperform.html +0 -195
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcreposix.html +0 -292
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcreprecompile.html +0 -158
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcresample.html +0 -110
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcrestack.html +0 -225
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcresyntax.html +0 -521
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcretest.html +0 -1082
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/html/pcreunicode.html +0 -270
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/index.html.src +0 -180
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre-config.1 +0 -92
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre-config.txt +0 -86
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre.3 +0 -202
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre.txt +0 -9909
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre16.3 +0 -390
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre32.3 +0 -389
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_assign_jit_stack.3 +0 -61
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_compile.3 +0 -98
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_compile2.3 +0 -106
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_config.3 +0 -76
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_copy_named_substring.3 +0 -59
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_copy_substring.3 +0 -52
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_dfa_exec.3 +0 -125
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_exec.3 +0 -103
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_free_study.3 +0 -31
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_free_substring.3 +0 -31
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_free_substring_list.3 +0 -31
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_fullinfo.3 +0 -95
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_get_named_substring.3 +0 -62
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_get_stringnumber.3 +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_get_stringtable_entries.3 +0 -48
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_get_substring.3 +0 -55
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_get_substring_list.3 +0 -49
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_jit_exec.3 +0 -104
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_jit_stack_alloc.3 +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_jit_stack_free.3 +0 -35
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_maketables.3 +0 -33
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_pattern_to_host_byte_order.3 +0 -46
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_refcount.3 +0 -36
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_study.3 +0 -56
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_utf16_to_host_byte_order.3 +0 -46
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_utf32_to_host_byte_order.3 +0 -46
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcre_version.3 +0 -31
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcreapi.3 +0 -2823
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcrebuild.3 +0 -520
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcrecallout.3 +0 -214
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcrecompat.3 +0 -185
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcrecpp.3 +0 -348
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcregrep.1 +0 -679
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcregrep.txt +0 -740
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcrejit.3 +0 -437
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcrelimits.3 +0 -67
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcrematching.3 +0 -206
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcrepartial.3 +0 -445
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcrepattern.3 +0 -2983
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcreperform.3 +0 -177
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcreposix.3 +0 -270
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcreprecompile.3 +0 -151
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcresample.3 +0 -99
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcrestack.3 +0 -215
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcresyntax.3 +0 -496
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcretest.1 +0 -1079
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcretest.txt +0 -1012
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/pcreunicode.3 +0 -255
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/doc/perltest.txt +0 -42
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/install-sh +0 -527
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/libpcre.pc.in +0 -12
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/libpcre16.pc.in +0 -12
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/libpcre32.pc.in +0 -12
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/libpcrecpp.pc.in +0 -12
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/libpcreposix.pc.in +0 -13
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/ltmain.sh +0 -9636
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/m4/ax_pthread.m4 +0 -309
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/m4/libtool.m4 +0 -7844
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/m4/ltoptions.m4 +0 -369
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/m4/ltsugar.m4 +0 -123
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/m4/ltversion.m4 +0 -23
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/m4/lt~obsolete.m4 +0 -98
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/m4/pcre_visibility.m4 +0 -89
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/makevp.bat +0 -66
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/makevp_c.txt +0 -20
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/makevp_l.txt +0 -20
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/missing +0 -331
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre-config.in +0 -133
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre.h +0 -653
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre.h.generic +0 -653
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre.h.in +0 -653
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre16_byte_order.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre16_chartables.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre16_compile.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre16_config.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre16_dfa_exec.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre16_exec.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre16_fullinfo.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre16_get.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre16_globals.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre16_jit_compile.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre16_maketables.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre16_newline.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre16_ord2utf16.c +0 -90
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre16_printint.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre16_refcount.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre16_string_utils.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre16_study.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre16_tables.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre16_ucd.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre16_utf16_utils.c +0 -130
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre16_valid_utf16.c +0 -156
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre16_version.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre16_xclass.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre32_byte_order.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre32_chartables.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre32_compile.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre32_config.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre32_dfa_exec.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre32_exec.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre32_fullinfo.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre32_get.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre32_globals.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre32_jit_compile.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre32_maketables.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre32_newline.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre32_ord2utf32.c +0 -82
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre32_printint.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre32_refcount.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre32_string_utils.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre32_study.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre32_tables.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre32_ucd.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre32_utf32_utils.c +0 -141
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre32_valid_utf32.c +0 -131
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre32_version.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre32_xclass.c +0 -45
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_byte_order.c +0 -318
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_chartables.c +0 -198
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_chartables.c.dist +0 -198
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_compile.c +0 -8386
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_config.c +0 -186
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_dfa_exec.c +0 -3582
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_exec.c +0 -7049
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_fullinfo.c +0 -231
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_get.c +0 -662
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_globals.c +0 -84
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_internal.h +0 -2744
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_jit_compile.c +0 -8560
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_jit_test.c +0 -1614
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_maketables.c +0 -151
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_newline.c +0 -210
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_ord2utf8.c +0 -94
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_printint.c +0 -766
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_refcount.c +0 -92
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_scanner.cc +0 -199
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_scanner.h +0 -172
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_scanner_unittest.cc +0 -159
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_string_utils.c +0 -211
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_stringpiece.cc +0 -43
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_stringpiece.h.in +0 -179
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_stringpiece_unittest.cc +0 -150
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_study.c +0 -1562
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_tables.c +0 -655
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_ucd.c +0 -3298
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_valid_utf8.c +0 -312
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_version.c +0 -98
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcre_xclass.c +0 -198
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcrecpp.cc +0 -922
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcrecpp.h +0 -710
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcrecpp_internal.h +0 -71
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcrecpp_unittest.cc +0 -1291
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcrecpparg.h.in +0 -174
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcredemo.c +0 -406
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcregexp.pas +0 -845
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcregrep.c +0 -3180
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcreposix.c +0 -419
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcreposix.h +0 -146
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/pcretest.c +0 -5488
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/perltest.pl +0 -237
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/sljit/sljitConfig.h +0 -110
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/sljit/sljitConfigInternal.h +0 -484
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/sljit/sljitExecAllocator.c +0 -289
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/sljit/sljitLir.c +0 -1766
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/sljit/sljitLir.h +0 -985
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/sljit/sljitNativeARM_Thumb2.c +0 -2008
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/sljit/sljitNativeARM_v5.c +0 -2515
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/sljit/sljitNativeMIPS_32.c +0 -404
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/sljit/sljitNativeMIPS_common.c +0 -1881
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/sljit/sljitNativePPC_32.c +0 -269
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/sljit/sljitNativePPC_64.c +0 -421
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/sljit/sljitNativePPC_common.c +0 -2014
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/sljit/sljitNativeSPARC_32.c +0 -164
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/sljit/sljitNativeSPARC_common.c +0 -1348
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/sljit/sljitNativeX86_32.c +0 -547
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/sljit/sljitNativeX86_64.c +0 -810
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/sljit/sljitNativeX86_common.c +0 -2836
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/sljit/sljitUtils.c +0 -332
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/grepbinary +0 -0
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/grepfilelist +0 -3
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/grepinput +0 -611
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/grepinput3 +0 -15
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/grepinput8 +0 -11
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/grepinputv +0 -4
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/grepinputx +0 -43
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/greplist +0 -7
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/grepoutput +0 -707
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/grepoutput8 +0 -12
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/grepoutputN +0 -17
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/greppatN4 +0 -2
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/saved16 +0 -0
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/saved16BE-1 +0 -0
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/saved16BE-2 +0 -0
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/saved16LE-1 +0 -0
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/saved16LE-2 +0 -0
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/saved32 +0 -0
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/saved32BE-1 +0 -0
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/saved32BE-2 +0 -0
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/saved32LE-1 +0 -0
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/saved32LE-2 +0 -0
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/saved8 +0 -0
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput1 +0 -5306
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput10 +0 -1337
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput11 +0 -135
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput12 +0 -89
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput13 +0 -9
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput14 +0 -329
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput15 +0 -430
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput16 +0 -35
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput17 +0 -296
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput18 +0 -296
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput19 +0 -22
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput2 +0 -3813
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput20 +0 -19
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput21 +0 -16
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput22 +0 -13
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput23 +0 -16
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput24 +0 -77
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput25 +0 -32
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput26 +0 -80
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput3 +0 -95
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput4 +0 -624
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput5 +0 -772
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput6 +0 -1319
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput7 +0 -672
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput8 +0 -4801
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinput9 +0 -717
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testinputEBC +0 -121
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput1 +0 -8798
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput10 +0 -2726
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput11-16 +0 -713
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput11-32 +0 -713
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput11-8 +0 -713
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput12 +0 -181
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput13 +0 -21
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput14 +0 -476
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput15 +0 -1269
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput16 +0 -121
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput17 +0 -505
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput18-16 +0 -1022
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput18-32 +0 -1019
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput19 +0 -88
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput2 +0 -12484
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput20 +0 -27
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput21-16 +0 -90
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput21-32 +0 -90
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput22-16 +0 -71
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput22-32 +0 -71
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput23 +0 -42
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput24 +0 -145
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput25 +0 -79
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput26 +0 -148
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput3 +0 -169
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput4 +0 -1094
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput5 +0 -1849
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput6 +0 -2137
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput7 +0 -1473
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput8 +0 -8019
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutput9 +0 -1371
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/testoutputEBC +0 -182
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/wintestinput3 +0 -91
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/testdata/wintestoutput3 +0 -166
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/pcre/ucp.h +0 -197
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/run_test.rb +0 -23
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/src/mruby_regexp_pcre.c +0 -364
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/test/matchdata.rb +0 -94
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/test/regexp.rb +0 -264
- data/resources/mruby/build/mrbgems/mruby-regexp-pcre/test/string.rb +0 -201
@@ -1,214 +0,0 @@
|
|
1
|
-
.TH PCRECALLOUT 3 "24 June 2012" "PCRE 8.30"
|
2
|
-
.SH NAME
|
3
|
-
PCRE - Perl-compatible regular expressions
|
4
|
-
.SH SYNOPSIS
|
5
|
-
.rs
|
6
|
-
.sp
|
7
|
-
.B #include <pcre.h>
|
8
|
-
.PP
|
9
|
-
.SM
|
10
|
-
.B int (*pcre_callout)(pcre_callout_block *);
|
11
|
-
.PP
|
12
|
-
.B int (*pcre16_callout)(pcre16_callout_block *);
|
13
|
-
.PP
|
14
|
-
.B int (*pcre32_callout)(pcre32_callout_block *);
|
15
|
-
.
|
16
|
-
.SH DESCRIPTION
|
17
|
-
.rs
|
18
|
-
.sp
|
19
|
-
PCRE provides a feature called "callout", which is a means of temporarily
|
20
|
-
passing control to the caller of PCRE in the middle of pattern matching. The
|
21
|
-
caller of PCRE provides an external function by putting its entry point in the
|
22
|
-
global variable \fIpcre_callout\fP (\fIpcre16_callout\fP for the 16-bit
|
23
|
-
library, \fIpcre32_callout\fP for the 32-bit library). By default, this
|
24
|
-
variable contains NULL, which disables all calling out.
|
25
|
-
.P
|
26
|
-
Within a regular expression, (?C) indicates the points at which the external
|
27
|
-
function is to be called. Different callout points can be identified by putting
|
28
|
-
a number less than 256 after the letter C. The default value is zero.
|
29
|
-
For example, this pattern has two callout points:
|
30
|
-
.sp
|
31
|
-
(?C1)abc(?C2)def
|
32
|
-
.sp
|
33
|
-
If the PCRE_AUTO_CALLOUT option bit is set when a pattern is compiled, PCRE
|
34
|
-
automatically inserts callouts, all with number 255, before each item in the
|
35
|
-
pattern. For example, if PCRE_AUTO_CALLOUT is used with the pattern
|
36
|
-
.sp
|
37
|
-
A(\ed{2}|--)
|
38
|
-
.sp
|
39
|
-
it is processed as if it were
|
40
|
-
.sp
|
41
|
-
(?C255)A(?C255)((?C255)\ed{2}(?C255)|(?C255)-(?C255)-(?C255))(?C255)
|
42
|
-
.sp
|
43
|
-
Notice that there is a callout before and after each parenthesis and
|
44
|
-
alternation bar. Automatic callouts can be used for tracking the progress of
|
45
|
-
pattern matching. The
|
46
|
-
.\" HREF
|
47
|
-
\fBpcretest\fP
|
48
|
-
.\"
|
49
|
-
command has an option that sets automatic callouts; when it is used, the output
|
50
|
-
indicates how the pattern is matched. This is useful information when you are
|
51
|
-
trying to optimize the performance of a particular pattern.
|
52
|
-
.P
|
53
|
-
The use of callouts in a pattern makes it ineligible for optimization by the
|
54
|
-
just-in-time compiler. Studying such a pattern with the PCRE_STUDY_JIT_COMPILE
|
55
|
-
option always fails.
|
56
|
-
.
|
57
|
-
.
|
58
|
-
.SH "MISSING CALLOUTS"
|
59
|
-
.rs
|
60
|
-
.sp
|
61
|
-
You should be aware that, because of optimizations in the way PCRE matches
|
62
|
-
patterns by default, callouts sometimes do not happen. For example, if the
|
63
|
-
pattern is
|
64
|
-
.sp
|
65
|
-
ab(?C4)cd
|
66
|
-
.sp
|
67
|
-
PCRE knows that any matching string must contain the letter "d". If the subject
|
68
|
-
string is "abyz", the lack of "d" means that matching doesn't ever start, and
|
69
|
-
the callout is never reached. However, with "abyd", though the result is still
|
70
|
-
no match, the callout is obeyed.
|
71
|
-
.P
|
72
|
-
If the pattern is studied, PCRE knows the minimum length of a matching string,
|
73
|
-
and will immediately give a "no match" return without actually running a match
|
74
|
-
if the subject is not long enough, or, for unanchored patterns, if it has
|
75
|
-
been scanned far enough.
|
76
|
-
.P
|
77
|
-
You can disable these optimizations by passing the PCRE_NO_START_OPTIMIZE
|
78
|
-
option to the matching function, or by starting the pattern with
|
79
|
-
(*NO_START_OPT). This slows down the matching process, but does ensure that
|
80
|
-
callouts such as the example above are obeyed.
|
81
|
-
.
|
82
|
-
.
|
83
|
-
.SH "THE CALLOUT INTERFACE"
|
84
|
-
.rs
|
85
|
-
.sp
|
86
|
-
During matching, when PCRE reaches a callout point, the external function
|
87
|
-
defined by \fIpcre_callout\fP or \fIpcre[16|32]_callout\fP is called
|
88
|
-
(if it is set). This applies to both normal and DFA matching. The only
|
89
|
-
argument to the callout function is a pointer to a \fBpcre_callout\fP
|
90
|
-
or \fBpcre[16|32]_callout\fP block.
|
91
|
-
These structures contains the following fields:
|
92
|
-
.sp
|
93
|
-
int \fIversion\fP;
|
94
|
-
int \fIcallout_number\fP;
|
95
|
-
int *\fIoffset_vector\fP;
|
96
|
-
const char *\fIsubject\fP; (8-bit version)
|
97
|
-
PCRE_SPTR16 \fIsubject\fP; (16-bit version)
|
98
|
-
PCRE_SPTR32 \fIsubject\fP; (32-bit version)
|
99
|
-
int \fIsubject_length\fP;
|
100
|
-
int \fIstart_match\fP;
|
101
|
-
int \fIcurrent_position\fP;
|
102
|
-
int \fIcapture_top\fP;
|
103
|
-
int \fIcapture_last\fP;
|
104
|
-
void *\fIcallout_data\fP;
|
105
|
-
int \fIpattern_position\fP;
|
106
|
-
int \fInext_item_length\fP;
|
107
|
-
const unsigned char *\fImark\fP; (8-bit version)
|
108
|
-
const PCRE_UCHAR16 *\fImark\fP; (16-bit version)
|
109
|
-
const PCRE_UCHAR32 *\fImark\fP; (32-bit version)
|
110
|
-
.sp
|
111
|
-
The \fIversion\fP field is an integer containing the version number of the
|
112
|
-
block format. The initial version was 0; the current version is 2. The version
|
113
|
-
number will change again in future if additional fields are added, but the
|
114
|
-
intention is never to remove any of the existing fields.
|
115
|
-
.P
|
116
|
-
The \fIcallout_number\fP field contains the number of the callout, as compiled
|
117
|
-
into the pattern (that is, the number after ?C for manual callouts, and 255 for
|
118
|
-
automatically generated callouts).
|
119
|
-
.P
|
120
|
-
The \fIoffset_vector\fP field is a pointer to the vector of offsets that was
|
121
|
-
passed by the caller to the matching function. When \fBpcre_exec()\fP or
|
122
|
-
\fBpcre[16|32]_exec()\fP is used, the contents can be inspected, in order to extract
|
123
|
-
substrings that have been matched so far, in the same way as for extracting
|
124
|
-
substrings after a match has completed. For the DFA matching functions, this
|
125
|
-
field is not useful.
|
126
|
-
.P
|
127
|
-
The \fIsubject\fP and \fIsubject_length\fP fields contain copies of the values
|
128
|
-
that were passed to the matching function.
|
129
|
-
.P
|
130
|
-
The \fIstart_match\fP field normally contains the offset within the subject at
|
131
|
-
which the current match attempt started. However, if the escape sequence \eK
|
132
|
-
has been encountered, this value is changed to reflect the modified starting
|
133
|
-
point. If the pattern is not anchored, the callout function may be called
|
134
|
-
several times from the same point in the pattern for different starting points
|
135
|
-
in the subject.
|
136
|
-
.P
|
137
|
-
The \fIcurrent_position\fP field contains the offset within the subject of the
|
138
|
-
current match pointer.
|
139
|
-
.P
|
140
|
-
When the \fBpcre_exec()\fP or \fBpcre[16|32]_exec()\fP is used, the
|
141
|
-
\fIcapture_top\fP field contains one more than the number of the highest
|
142
|
-
numbered captured substring so far. If no substrings have been captured, the
|
143
|
-
value of \fIcapture_top\fP is one. This is always the case when the DFA
|
144
|
-
functions are used, because they do not support captured substrings.
|
145
|
-
.P
|
146
|
-
The \fIcapture_last\fP field contains the number of the most recently captured
|
147
|
-
substring. If no substrings have been captured, its value is -1. This is always
|
148
|
-
the case for the DFA matching functions.
|
149
|
-
.P
|
150
|
-
The \fIcallout_data\fP field contains a value that is passed to a matching
|
151
|
-
function specifically so that it can be passed back in callouts. It is passed
|
152
|
-
in the \fIcallout_data\fP field of a \fBpcre_extra\fP or \fBpcre[16|32]_extra\fP
|
153
|
-
data structure. If no such data was passed, the value of \fIcallout_data\fP in
|
154
|
-
a callout block is NULL. There is a description of the \fBpcre_extra\fP
|
155
|
-
structure in the
|
156
|
-
.\" HREF
|
157
|
-
\fBpcreapi\fP
|
158
|
-
.\"
|
159
|
-
documentation.
|
160
|
-
.P
|
161
|
-
The \fIpattern_position\fP field is present from version 1 of the callout
|
162
|
-
structure. It contains the offset to the next item to be matched in the pattern
|
163
|
-
string.
|
164
|
-
.P
|
165
|
-
The \fInext_item_length\fP field is present from version 1 of the callout
|
166
|
-
structure. It contains the length of the next item to be matched in the pattern
|
167
|
-
string. When the callout immediately precedes an alternation bar, a closing
|
168
|
-
parenthesis, or the end of the pattern, the length is zero. When the callout
|
169
|
-
precedes an opening parenthesis, the length is that of the entire subpattern.
|
170
|
-
.P
|
171
|
-
The \fIpattern_position\fP and \fInext_item_length\fP fields are intended to
|
172
|
-
help in distinguishing between different automatic callouts, which all have the
|
173
|
-
same callout number. However, they are set for all callouts.
|
174
|
-
.P
|
175
|
-
The \fImark\fP field is present from version 2 of the callout structure. In
|
176
|
-
callouts from \fBpcre_exec()\fP or \fBpcre[16|32]_exec()\fP it contains a pointer to
|
177
|
-
the zero-terminated name of the most recently passed (*MARK), (*PRUNE), or
|
178
|
-
(*THEN) item in the match, or NULL if no such items have been passed. Instances
|
179
|
-
of (*PRUNE) or (*THEN) without a name do not obliterate a previous (*MARK). In
|
180
|
-
callouts from the DFA matching functions this field always contains NULL.
|
181
|
-
.
|
182
|
-
.
|
183
|
-
.SH "RETURN VALUES"
|
184
|
-
.rs
|
185
|
-
.sp
|
186
|
-
The external callout function returns an integer to PCRE. If the value is zero,
|
187
|
-
matching proceeds as normal. If the value is greater than zero, matching fails
|
188
|
-
at the current point, but the testing of other matching possibilities goes
|
189
|
-
ahead, just as if a lookahead assertion had failed. If the value is less than
|
190
|
-
zero, the match is abandoned, the matching function returns the negative value.
|
191
|
-
.P
|
192
|
-
Negative values should normally be chosen from the set of PCRE_ERROR_xxx
|
193
|
-
values. In particular, PCRE_ERROR_NOMATCH forces a standard "no match" failure.
|
194
|
-
The error number PCRE_ERROR_CALLOUT is reserved for use by callout functions;
|
195
|
-
it will never be used by PCRE itself.
|
196
|
-
.
|
197
|
-
.
|
198
|
-
.SH AUTHOR
|
199
|
-
.rs
|
200
|
-
.sp
|
201
|
-
.nf
|
202
|
-
Philip Hazel
|
203
|
-
University Computing Service
|
204
|
-
Cambridge CB2 3QH, England.
|
205
|
-
.fi
|
206
|
-
.
|
207
|
-
.
|
208
|
-
.SH REVISION
|
209
|
-
.rs
|
210
|
-
.sp
|
211
|
-
.nf
|
212
|
-
Last updated: 24 June 2012
|
213
|
-
Copyright (c) 1997-2012 University of Cambridge.
|
214
|
-
.fi
|
@@ -1,185 +0,0 @@
|
|
1
|
-
.TH PCRECOMPAT 3 "24 June 2012" "PCRE 8.30"
|
2
|
-
.SH NAME
|
3
|
-
PCRE - Perl-compatible regular expressions
|
4
|
-
.SH "DIFFERENCES BETWEEN PCRE AND PERL"
|
5
|
-
.rs
|
6
|
-
.sp
|
7
|
-
This document describes the differences in the ways that PCRE and Perl handle
|
8
|
-
regular expressions. The differences described here are with respect to Perl
|
9
|
-
versions 5.10 and above.
|
10
|
-
.P
|
11
|
-
1. PCRE has only a subset of Perl's Unicode support. Details of what it does
|
12
|
-
have are given in the
|
13
|
-
.\" HREF
|
14
|
-
\fBpcreunicode\fP
|
15
|
-
.\"
|
16
|
-
page.
|
17
|
-
.P
|
18
|
-
2. PCRE allows repeat quantifiers only on parenthesized assertions, but they do
|
19
|
-
not mean what you might think. For example, (?!a){3} does not assert that the
|
20
|
-
next three characters are not "a". It just asserts that the next character is
|
21
|
-
not "a" three times (in principle: PCRE optimizes this to run the assertion
|
22
|
-
just once). Perl allows repeat quantifiers on other assertions such as \eb, but
|
23
|
-
these do not seem to have any use.
|
24
|
-
.P
|
25
|
-
3. Capturing subpatterns that occur inside negative lookahead assertions are
|
26
|
-
counted, but their entries in the offsets vector are never set. Perl sets its
|
27
|
-
numerical variables from any such patterns that are matched before the
|
28
|
-
assertion fails to match something (thereby succeeding), but only if the
|
29
|
-
negative lookahead assertion contains just one branch.
|
30
|
-
.P
|
31
|
-
4. Though binary zero characters are supported in the subject string, they are
|
32
|
-
not allowed in a pattern string because it is passed as a normal C string,
|
33
|
-
terminated by zero. The escape sequence \e0 can be used in the pattern to
|
34
|
-
represent a binary zero.
|
35
|
-
.P
|
36
|
-
5. The following Perl escape sequences are not supported: \el, \eu, \eL,
|
37
|
-
\eU, and \eN when followed by a character name or Unicode value. (\eN on its
|
38
|
-
own, matching a non-newline character, is supported.) In fact these are
|
39
|
-
implemented by Perl's general string-handling and are not part of its pattern
|
40
|
-
matching engine. If any of these are encountered by PCRE, an error is
|
41
|
-
generated by default. However, if the PCRE_JAVASCRIPT_COMPAT option is set,
|
42
|
-
\eU and \eu are interpreted as JavaScript interprets them.
|
43
|
-
.P
|
44
|
-
6. The Perl escape sequences \ep, \eP, and \eX are supported only if PCRE is
|
45
|
-
built with Unicode character property support. The properties that can be
|
46
|
-
tested with \ep and \eP are limited to the general category properties such as
|
47
|
-
Lu and Nd, script names such as Greek or Han, and the derived properties Any
|
48
|
-
and L&. PCRE does support the Cs (surrogate) property, which Perl does not; the
|
49
|
-
Perl documentation says "Because Perl hides the need for the user to understand
|
50
|
-
the internal representation of Unicode characters, there is no need to
|
51
|
-
implement the somewhat messy concept of surrogates."
|
52
|
-
.P
|
53
|
-
7. PCRE does support the \eQ...\eE escape for quoting substrings. Characters in
|
54
|
-
between are treated as literals. This is slightly different from Perl in that $
|
55
|
-
and @ are also handled as literals inside the quotes. In Perl, they cause
|
56
|
-
variable interpolation (but of course PCRE does not have variables). Note the
|
57
|
-
following examples:
|
58
|
-
.sp
|
59
|
-
Pattern PCRE matches Perl matches
|
60
|
-
.sp
|
61
|
-
.\" JOIN
|
62
|
-
\eQabc$xyz\eE abc$xyz abc followed by the
|
63
|
-
contents of $xyz
|
64
|
-
\eQabc\e$xyz\eE abc\e$xyz abc\e$xyz
|
65
|
-
\eQabc\eE\e$\eQxyz\eE abc$xyz abc$xyz
|
66
|
-
.sp
|
67
|
-
The \eQ...\eE sequence is recognized both inside and outside character classes.
|
68
|
-
.P
|
69
|
-
8. Fairly obviously, PCRE does not support the (?{code}) and (??{code})
|
70
|
-
constructions. However, there is support for recursive patterns. This is not
|
71
|
-
available in Perl 5.8, but it is in Perl 5.10. Also, the PCRE "callout"
|
72
|
-
feature allows an external function to be called during pattern matching. See
|
73
|
-
the
|
74
|
-
.\" HREF
|
75
|
-
\fBpcrecallout\fP
|
76
|
-
.\"
|
77
|
-
documentation for details.
|
78
|
-
.P
|
79
|
-
9. Subpatterns that are called as subroutines (whether or not recursively) are
|
80
|
-
always treated as atomic groups in PCRE. This is like Python, but unlike Perl.
|
81
|
-
Captured values that are set outside a subroutine call can be reference from
|
82
|
-
inside in PCRE, but not in Perl. There is a discussion that explains these
|
83
|
-
differences in more detail in the
|
84
|
-
.\" HTML <a href="pcrepattern.html#recursiondifference">
|
85
|
-
.\" </a>
|
86
|
-
section on recursion differences from Perl
|
87
|
-
.\"
|
88
|
-
in the
|
89
|
-
.\" HREF
|
90
|
-
\fBpcrepattern\fP
|
91
|
-
.\"
|
92
|
-
page.
|
93
|
-
.P
|
94
|
-
10. If any of the backtracking control verbs are used in an assertion or in a
|
95
|
-
subpattern that is called as a subroutine (whether or not recursively), their
|
96
|
-
effect is confined to that subpattern; it does not extend to the surrounding
|
97
|
-
pattern. This is not always the case in Perl. In particular, if (*THEN) is
|
98
|
-
present in a group that is called as a subroutine, its action is limited to
|
99
|
-
that group, even if the group does not contain any | characters. There is one
|
100
|
-
exception to this: the name from a *(MARK), (*PRUNE), or (*THEN) that is
|
101
|
-
encountered in a successful positive assertion \fIis\fP passed back when a
|
102
|
-
match succeeds (compare capturing parentheses in assertions). Note that such
|
103
|
-
subpatterns are processed as anchored at the point where they are tested.
|
104
|
-
.P
|
105
|
-
11. There are some differences that are concerned with the settings of captured
|
106
|
-
strings when part of a pattern is repeated. For example, matching "aba" against
|
107
|
-
the pattern /^(a(b)?)+$/ in Perl leaves $2 unset, but in PCRE it is set to "b".
|
108
|
-
.P
|
109
|
-
12. PCRE's handling of duplicate subpattern numbers and duplicate subpattern
|
110
|
-
names is not as general as Perl's. This is a consequence of the fact the PCRE
|
111
|
-
works internally just with numbers, using an external table to translate
|
112
|
-
between numbers and names. In particular, a pattern such as (?|(?<a>A)|(?<b)B),
|
113
|
-
where the two capturing parentheses have the same number but different names,
|
114
|
-
is not supported, and causes an error at compile time. If it were allowed, it
|
115
|
-
would not be possible to distinguish which parentheses matched, because both
|
116
|
-
names map to capturing subpattern number 1. To avoid this confusing situation,
|
117
|
-
an error is given at compile time.
|
118
|
-
.P
|
119
|
-
13. Perl recognizes comments in some places that PCRE does not, for example,
|
120
|
-
between the ( and ? at the start of a subpattern. If the /x modifier is set,
|
121
|
-
Perl allows white space between ( and ? but PCRE never does, even if the
|
122
|
-
PCRE_EXTENDED option is set.
|
123
|
-
.P
|
124
|
-
14. PCRE provides some extensions to the Perl regular expression facilities.
|
125
|
-
Perl 5.10 includes new features that are not in earlier versions of Perl, some
|
126
|
-
of which (such as named parentheses) have been in PCRE for some time. This list
|
127
|
-
is with respect to Perl 5.10:
|
128
|
-
.sp
|
129
|
-
(a) Although lookbehind assertions in PCRE must match fixed length strings,
|
130
|
-
each alternative branch of a lookbehind assertion can match a different length
|
131
|
-
of string. Perl requires them all to have the same length.
|
132
|
-
.sp
|
133
|
-
(b) If PCRE_DOLLAR_ENDONLY is set and PCRE_MULTILINE is not set, the $
|
134
|
-
meta-character matches only at the very end of the string.
|
135
|
-
.sp
|
136
|
-
(c) If PCRE_EXTRA is set, a backslash followed by a letter with no special
|
137
|
-
meaning is faulted. Otherwise, like Perl, the backslash is quietly ignored.
|
138
|
-
(Perl can be made to issue a warning.)
|
139
|
-
.sp
|
140
|
-
(d) If PCRE_UNGREEDY is set, the greediness of the repetition quantifiers is
|
141
|
-
inverted, that is, by default they are not greedy, but if followed by a
|
142
|
-
question mark they are.
|
143
|
-
.sp
|
144
|
-
(e) PCRE_ANCHORED can be used at matching time to force a pattern to be tried
|
145
|
-
only at the first matching position in the subject string.
|
146
|
-
.sp
|
147
|
-
(f) The PCRE_NOTBOL, PCRE_NOTEOL, PCRE_NOTEMPTY, PCRE_NOTEMPTY_ATSTART, and
|
148
|
-
PCRE_NO_AUTO_CAPTURE options for \fBpcre_exec()\fP have no Perl equivalents.
|
149
|
-
.sp
|
150
|
-
(g) The \eR escape sequence can be restricted to match only CR, LF, or CRLF
|
151
|
-
by the PCRE_BSR_ANYCRLF option.
|
152
|
-
.sp
|
153
|
-
(h) The callout facility is PCRE-specific.
|
154
|
-
.sp
|
155
|
-
(i) The partial matching facility is PCRE-specific.
|
156
|
-
.sp
|
157
|
-
(j) Patterns compiled by PCRE can be saved and re-used at a later time, even on
|
158
|
-
different hosts that have the other endianness. However, this does not apply to
|
159
|
-
optimized data created by the just-in-time compiler.
|
160
|
-
.sp
|
161
|
-
(k) The alternative matching functions (\fBpcre_dfa_exec()\fP,
|
162
|
-
\fBpcre16_dfa_exec()\fP and \fBpcre32_dfa_exec()\fP,) match in a different way
|
163
|
-
and are not Perl-compatible.
|
164
|
-
.sp
|
165
|
-
(l) PCRE recognizes some special sequences such as (*CR) at the start of
|
166
|
-
a pattern that set overall options that cannot be changed within the pattern.
|
167
|
-
.
|
168
|
-
.
|
169
|
-
.SH AUTHOR
|
170
|
-
.rs
|
171
|
-
.sp
|
172
|
-
.nf
|
173
|
-
Philip Hazel
|
174
|
-
University Computing Service
|
175
|
-
Cambridge CB2 3QH, England.
|
176
|
-
.fi
|
177
|
-
.
|
178
|
-
.
|
179
|
-
.SH REVISION
|
180
|
-
.rs
|
181
|
-
.sp
|
182
|
-
.nf
|
183
|
-
Last updated: 25 August 2012
|
184
|
-
Copyright (c) 1997-2012 University of Cambridge.
|
185
|
-
.fi
|
@@ -1,348 +0,0 @@
|
|
1
|
-
.TH PCRECPP 3 "08 January 2012" "PCRE 8.30"
|
2
|
-
.SH NAME
|
3
|
-
PCRE - Perl-compatible regular expressions.
|
4
|
-
.SH "SYNOPSIS OF C++ WRAPPER"
|
5
|
-
.rs
|
6
|
-
.sp
|
7
|
-
.B #include <pcrecpp.h>
|
8
|
-
.
|
9
|
-
.SH DESCRIPTION
|
10
|
-
.rs
|
11
|
-
.sp
|
12
|
-
The C++ wrapper for PCRE was provided by Google Inc. Some additional
|
13
|
-
functionality was added by Giuseppe Maxia. This brief man page was constructed
|
14
|
-
from the notes in the \fIpcrecpp.h\fP file, which should be consulted for
|
15
|
-
further details. Note that the C++ wrapper supports only the original 8-bit
|
16
|
-
PCRE library. There is no 16-bit or 32-bit support at present.
|
17
|
-
.
|
18
|
-
.
|
19
|
-
.SH "MATCHING INTERFACE"
|
20
|
-
.rs
|
21
|
-
.sp
|
22
|
-
The "FullMatch" operation checks that supplied text matches a supplied pattern
|
23
|
-
exactly. If pointer arguments are supplied, it copies matched sub-strings that
|
24
|
-
match sub-patterns into them.
|
25
|
-
.sp
|
26
|
-
Example: successful match
|
27
|
-
pcrecpp::RE re("h.*o");
|
28
|
-
re.FullMatch("hello");
|
29
|
-
.sp
|
30
|
-
Example: unsuccessful match (requires full match):
|
31
|
-
pcrecpp::RE re("e");
|
32
|
-
!re.FullMatch("hello");
|
33
|
-
.sp
|
34
|
-
Example: creating a temporary RE object:
|
35
|
-
pcrecpp::RE("h.*o").FullMatch("hello");
|
36
|
-
.sp
|
37
|
-
You can pass in a "const char*" or a "string" for "text". The examples below
|
38
|
-
tend to use a const char*. You can, as in the different examples above, store
|
39
|
-
the RE object explicitly in a variable or use a temporary RE object. The
|
40
|
-
examples below use one mode or the other arbitrarily. Either could correctly be
|
41
|
-
used for any of these examples.
|
42
|
-
.P
|
43
|
-
You must supply extra pointer arguments to extract matched subpieces.
|
44
|
-
.sp
|
45
|
-
Example: extracts "ruby" into "s" and 1234 into "i"
|
46
|
-
int i;
|
47
|
-
string s;
|
48
|
-
pcrecpp::RE re("(\e\ew+):(\e\ed+)");
|
49
|
-
re.FullMatch("ruby:1234", &s, &i);
|
50
|
-
.sp
|
51
|
-
Example: does not try to extract any extra sub-patterns
|
52
|
-
re.FullMatch("ruby:1234", &s);
|
53
|
-
.sp
|
54
|
-
Example: does not try to extract into NULL
|
55
|
-
re.FullMatch("ruby:1234", NULL, &i);
|
56
|
-
.sp
|
57
|
-
Example: integer overflow causes failure
|
58
|
-
!re.FullMatch("ruby:1234567891234", NULL, &i);
|
59
|
-
.sp
|
60
|
-
Example: fails because there aren't enough sub-patterns:
|
61
|
-
!pcrecpp::RE("\e\ew+:\e\ed+").FullMatch("ruby:1234", &s);
|
62
|
-
.sp
|
63
|
-
Example: fails because string cannot be stored in integer
|
64
|
-
!pcrecpp::RE("(.*)").FullMatch("ruby", &i);
|
65
|
-
.sp
|
66
|
-
The provided pointer arguments can be pointers to any scalar numeric
|
67
|
-
type, or one of:
|
68
|
-
.sp
|
69
|
-
string (matched piece is copied to string)
|
70
|
-
StringPiece (StringPiece is mutated to point to matched piece)
|
71
|
-
T (where "bool T::ParseFrom(const char*, int)" exists)
|
72
|
-
NULL (the corresponding matched sub-pattern is not copied)
|
73
|
-
.sp
|
74
|
-
The function returns true iff all of the following conditions are satisfied:
|
75
|
-
.sp
|
76
|
-
a. "text" matches "pattern" exactly;
|
77
|
-
.sp
|
78
|
-
b. The number of matched sub-patterns is >= number of supplied
|
79
|
-
pointers;
|
80
|
-
.sp
|
81
|
-
c. The "i"th argument has a suitable type for holding the
|
82
|
-
string captured as the "i"th sub-pattern. If you pass in
|
83
|
-
void * NULL for the "i"th argument, or a non-void * NULL
|
84
|
-
of the correct type, or pass fewer arguments than the
|
85
|
-
number of sub-patterns, "i"th captured sub-pattern is
|
86
|
-
ignored.
|
87
|
-
.sp
|
88
|
-
CAVEAT: An optional sub-pattern that does not exist in the matched
|
89
|
-
string is assigned the empty string. Therefore, the following will
|
90
|
-
return false (because the empty string is not a valid number):
|
91
|
-
.sp
|
92
|
-
int number;
|
93
|
-
pcrecpp::RE::FullMatch("abc", "[a-z]+(\e\ed+)?", &number);
|
94
|
-
.sp
|
95
|
-
The matching interface supports at most 16 arguments per call.
|
96
|
-
If you need more, consider using the more general interface
|
97
|
-
\fBpcrecpp::RE::DoMatch\fP. See \fBpcrecpp.h\fP for the signature for
|
98
|
-
\fBDoMatch\fP.
|
99
|
-
.P
|
100
|
-
NOTE: Do not use \fBno_arg\fP, which is used internally to mark the end of a
|
101
|
-
list of optional arguments, as a placeholder for missing arguments, as this can
|
102
|
-
lead to segfaults.
|
103
|
-
.
|
104
|
-
.
|
105
|
-
.SH "QUOTING METACHARACTERS"
|
106
|
-
.rs
|
107
|
-
.sp
|
108
|
-
You can use the "QuoteMeta" operation to insert backslashes before all
|
109
|
-
potentially meaningful characters in a string. The returned string, used as a
|
110
|
-
regular expression, will exactly match the original string.
|
111
|
-
.sp
|
112
|
-
Example:
|
113
|
-
string quoted = RE::QuoteMeta(unquoted);
|
114
|
-
.sp
|
115
|
-
Note that it's legal to escape a character even if it has no special meaning in
|
116
|
-
a regular expression -- so this function does that. (This also makes it
|
117
|
-
identical to the perl function of the same name; see "perldoc -f quotemeta".)
|
118
|
-
For example, "1.5-2.0?" becomes "1\e.5\e-2\e.0\e?".
|
119
|
-
.
|
120
|
-
.SH "PARTIAL MATCHES"
|
121
|
-
.rs
|
122
|
-
.sp
|
123
|
-
You can use the "PartialMatch" operation when you want the pattern
|
124
|
-
to match any substring of the text.
|
125
|
-
.sp
|
126
|
-
Example: simple search for a string:
|
127
|
-
pcrecpp::RE("ell").PartialMatch("hello");
|
128
|
-
.sp
|
129
|
-
Example: find first number in a string:
|
130
|
-
int number;
|
131
|
-
pcrecpp::RE re("(\e\ed+)");
|
132
|
-
re.PartialMatch("x*100 + 20", &number);
|
133
|
-
assert(number == 100);
|
134
|
-
.
|
135
|
-
.
|
136
|
-
.SH "UTF-8 AND THE MATCHING INTERFACE"
|
137
|
-
.rs
|
138
|
-
.sp
|
139
|
-
By default, pattern and text are plain text, one byte per character. The UTF8
|
140
|
-
flag, passed to the constructor, causes both pattern and string to be treated
|
141
|
-
as UTF-8 text, still a byte stream but potentially multiple bytes per
|
142
|
-
character. In practice, the text is likelier to be UTF-8 than the pattern, but
|
143
|
-
the match returned may depend on the UTF8 flag, so always use it when matching
|
144
|
-
UTF8 text. For example, "." will match one byte normally but with UTF8 set may
|
145
|
-
match up to three bytes of a multi-byte character.
|
146
|
-
.sp
|
147
|
-
Example:
|
148
|
-
pcrecpp::RE_Options options;
|
149
|
-
options.set_utf8();
|
150
|
-
pcrecpp::RE re(utf8_pattern, options);
|
151
|
-
re.FullMatch(utf8_string);
|
152
|
-
.sp
|
153
|
-
Example: using the convenience function UTF8():
|
154
|
-
pcrecpp::RE re(utf8_pattern, pcrecpp::UTF8());
|
155
|
-
re.FullMatch(utf8_string);
|
156
|
-
.sp
|
157
|
-
NOTE: The UTF8 flag is ignored if pcre was not configured with the
|
158
|
-
--enable-utf8 flag.
|
159
|
-
.
|
160
|
-
.
|
161
|
-
.SH "PASSING MODIFIERS TO THE REGULAR EXPRESSION ENGINE"
|
162
|
-
.rs
|
163
|
-
.sp
|
164
|
-
PCRE defines some modifiers to change the behavior of the regular expression
|
165
|
-
engine. The C++ wrapper defines an auxiliary class, RE_Options, as a vehicle to
|
166
|
-
pass such modifiers to a RE class. Currently, the following modifiers are
|
167
|
-
supported:
|
168
|
-
.sp
|
169
|
-
modifier description Perl corresponding
|
170
|
-
.sp
|
171
|
-
PCRE_CASELESS case insensitive match /i
|
172
|
-
PCRE_MULTILINE multiple lines match /m
|
173
|
-
PCRE_DOTALL dot matches newlines /s
|
174
|
-
PCRE_DOLLAR_ENDONLY $ matches only at end N/A
|
175
|
-
PCRE_EXTRA strict escape parsing N/A
|
176
|
-
PCRE_EXTENDED ignore white spaces /x
|
177
|
-
PCRE_UTF8 handles UTF8 chars built-in
|
178
|
-
PCRE_UNGREEDY reverses * and *? N/A
|
179
|
-
PCRE_NO_AUTO_CAPTURE disables capturing parens N/A (*)
|
180
|
-
.sp
|
181
|
-
(*) Both Perl and PCRE allow non capturing parentheses by means of the
|
182
|
-
"?:" modifier within the pattern itself. e.g. (?:ab|cd) does not
|
183
|
-
capture, while (ab|cd) does.
|
184
|
-
.P
|
185
|
-
For a full account on how each modifier works, please check the
|
186
|
-
PCRE API reference page.
|
187
|
-
.P
|
188
|
-
For each modifier, there are two member functions whose name is made
|
189
|
-
out of the modifier in lowercase, without the "PCRE_" prefix. For
|
190
|
-
instance, PCRE_CASELESS is handled by
|
191
|
-
.sp
|
192
|
-
bool caseless()
|
193
|
-
.sp
|
194
|
-
which returns true if the modifier is set, and
|
195
|
-
.sp
|
196
|
-
RE_Options & set_caseless(bool)
|
197
|
-
.sp
|
198
|
-
which sets or unsets the modifier. Moreover, PCRE_EXTRA_MATCH_LIMIT can be
|
199
|
-
accessed through the \fBset_match_limit()\fP and \fBmatch_limit()\fP member
|
200
|
-
functions. Setting \fImatch_limit\fP to a non-zero value will limit the
|
201
|
-
execution of pcre to keep it from doing bad things like blowing the stack or
|
202
|
-
taking an eternity to return a result. A value of 5000 is good enough to stop
|
203
|
-
stack blowup in a 2MB thread stack. Setting \fImatch_limit\fP to zero disables
|
204
|
-
match limiting. Alternatively, you can call \fBmatch_limit_recursion()\fP
|
205
|
-
which uses PCRE_EXTRA_MATCH_LIMIT_RECURSION to limit how much PCRE
|
206
|
-
recurses. \fBmatch_limit()\fP limits the number of matches PCRE does;
|
207
|
-
\fBmatch_limit_recursion()\fP limits the depth of internal recursion, and
|
208
|
-
therefore the amount of stack that is used.
|
209
|
-
.P
|
210
|
-
Normally, to pass one or more modifiers to a RE class, you declare
|
211
|
-
a \fIRE_Options\fP object, set the appropriate options, and pass this
|
212
|
-
object to a RE constructor. Example:
|
213
|
-
.sp
|
214
|
-
RE_Options opt;
|
215
|
-
opt.set_caseless(true);
|
216
|
-
if (RE("HELLO", opt).PartialMatch("hello world")) ...
|
217
|
-
.sp
|
218
|
-
RE_options has two constructors. The default constructor takes no arguments and
|
219
|
-
creates a set of flags that are off by default. The optional parameter
|
220
|
-
\fIoption_flags\fP is to facilitate transfer of legacy code from C programs.
|
221
|
-
This lets you do
|
222
|
-
.sp
|
223
|
-
RE(pattern,
|
224
|
-
RE_Options(PCRE_CASELESS|PCRE_MULTILINE)).PartialMatch(str);
|
225
|
-
.sp
|
226
|
-
However, new code is better off doing
|
227
|
-
.sp
|
228
|
-
RE(pattern,
|
229
|
-
RE_Options().set_caseless(true).set_multiline(true))
|
230
|
-
.PartialMatch(str);
|
231
|
-
.sp
|
232
|
-
If you are going to pass one of the most used modifiers, there are some
|
233
|
-
convenience functions that return a RE_Options class with the
|
234
|
-
appropriate modifier already set: \fBCASELESS()\fP, \fBUTF8()\fP,
|
235
|
-
\fBMULTILINE()\fP, \fBDOTALL\fP(), and \fBEXTENDED()\fP.
|
236
|
-
.P
|
237
|
-
If you need to set several options at once, and you don't want to go through
|
238
|
-
the pains of declaring a RE_Options object and setting several options, there
|
239
|
-
is a parallel method that give you such ability on the fly. You can concatenate
|
240
|
-
several \fBset_xxxxx()\fP member functions, since each of them returns a
|
241
|
-
reference to its class object. For example, to pass PCRE_CASELESS,
|
242
|
-
PCRE_EXTENDED, and PCRE_MULTILINE to a RE with one statement, you may write:
|
243
|
-
.sp
|
244
|
-
RE(" ^ xyz \e\es+ .* blah$",
|
245
|
-
RE_Options()
|
246
|
-
.set_caseless(true)
|
247
|
-
.set_extended(true)
|
248
|
-
.set_multiline(true)).PartialMatch(sometext);
|
249
|
-
.sp
|
250
|
-
.
|
251
|
-
.
|
252
|
-
.SH "SCANNING TEXT INCREMENTALLY"
|
253
|
-
.rs
|
254
|
-
.sp
|
255
|
-
The "Consume" operation may be useful if you want to repeatedly
|
256
|
-
match regular expressions at the front of a string and skip over
|
257
|
-
them as they match. This requires use of the "StringPiece" type,
|
258
|
-
which represents a sub-range of a real string. Like RE, StringPiece
|
259
|
-
is defined in the pcrecpp namespace.
|
260
|
-
.sp
|
261
|
-
Example: read lines of the form "var = value" from a string.
|
262
|
-
string contents = ...; // Fill string somehow
|
263
|
-
pcrecpp::StringPiece input(contents); // Wrap in a StringPiece
|
264
|
-
.sp
|
265
|
-
string var;
|
266
|
-
int value;
|
267
|
-
pcrecpp::RE re("(\e\ew+) = (\e\ed+)\en");
|
268
|
-
while (re.Consume(&input, &var, &value)) {
|
269
|
-
...;
|
270
|
-
}
|
271
|
-
.sp
|
272
|
-
Each successful call to "Consume" will set "var/value", and also
|
273
|
-
advance "input" so it points past the matched text.
|
274
|
-
.P
|
275
|
-
The "FindAndConsume" operation is similar to "Consume" but does not
|
276
|
-
anchor your match at the beginning of the string. For example, you
|
277
|
-
could extract all words from a string by repeatedly calling
|
278
|
-
.sp
|
279
|
-
pcrecpp::RE("(\e\ew+)").FindAndConsume(&input, &word)
|
280
|
-
.
|
281
|
-
.
|
282
|
-
.SH "PARSING HEX/OCTAL/C-RADIX NUMBERS"
|
283
|
-
.rs
|
284
|
-
.sp
|
285
|
-
By default, if you pass a pointer to a numeric value, the
|
286
|
-
corresponding text is interpreted as a base-10 number. You can
|
287
|
-
instead wrap the pointer with a call to one of the operators Hex(),
|
288
|
-
Octal(), or CRadix() to interpret the text in another base. The
|
289
|
-
CRadix operator interprets C-style "0" (base-8) and "0x" (base-16)
|
290
|
-
prefixes, but defaults to base-10.
|
291
|
-
.sp
|
292
|
-
Example:
|
293
|
-
int a, b, c, d;
|
294
|
-
pcrecpp::RE re("(.*) (.*) (.*) (.*)");
|
295
|
-
re.FullMatch("100 40 0100 0x40",
|
296
|
-
pcrecpp::Octal(&a), pcrecpp::Hex(&b),
|
297
|
-
pcrecpp::CRadix(&c), pcrecpp::CRadix(&d));
|
298
|
-
.sp
|
299
|
-
will leave 64 in a, b, c, and d.
|
300
|
-
.
|
301
|
-
.
|
302
|
-
.SH "REPLACING PARTS OF STRINGS"
|
303
|
-
.rs
|
304
|
-
.sp
|
305
|
-
You can replace the first match of "pattern" in "str" with "rewrite".
|
306
|
-
Within "rewrite", backslash-escaped digits (\e1 to \e9) can be
|
307
|
-
used to insert text matching corresponding parenthesized group
|
308
|
-
from the pattern. \e0 in "rewrite" refers to the entire matching
|
309
|
-
text. For example:
|
310
|
-
.sp
|
311
|
-
string s = "yabba dabba doo";
|
312
|
-
pcrecpp::RE("b+").Replace("d", &s);
|
313
|
-
.sp
|
314
|
-
will leave "s" containing "yada dabba doo". The result is true if the pattern
|
315
|
-
matches and a replacement occurs, false otherwise.
|
316
|
-
.P
|
317
|
-
\fBGlobalReplace\fP is like \fBReplace\fP except that it replaces all
|
318
|
-
occurrences of the pattern in the string with the rewrite. Replacements are
|
319
|
-
not subject to re-matching. For example:
|
320
|
-
.sp
|
321
|
-
string s = "yabba dabba doo";
|
322
|
-
pcrecpp::RE("b+").GlobalReplace("d", &s);
|
323
|
-
.sp
|
324
|
-
will leave "s" containing "yada dada doo". It returns the number of
|
325
|
-
replacements made.
|
326
|
-
.P
|
327
|
-
\fBExtract\fP is like \fBReplace\fP, except that if the pattern matches,
|
328
|
-
"rewrite" is copied into "out" (an additional argument) with substitutions.
|
329
|
-
The non-matching portions of "text" are ignored. Returns true iff a match
|
330
|
-
occurred and the extraction happened successfully; if no match occurs, the
|
331
|
-
string is left unaffected.
|
332
|
-
.
|
333
|
-
.
|
334
|
-
.SH AUTHOR
|
335
|
-
.rs
|
336
|
-
.sp
|
337
|
-
.nf
|
338
|
-
The C++ wrapper was contributed by Google Inc.
|
339
|
-
Copyright (c) 2007 Google Inc.
|
340
|
-
.fi
|
341
|
-
.
|
342
|
-
.
|
343
|
-
.SH REVISION
|
344
|
-
.rs
|
345
|
-
.sp
|
346
|
-
.nf
|
347
|
-
Last updated: 08 January 2012
|
348
|
-
.fi
|