Annotation of embedaddon/php/ext/mbstring/oniguruma/README.ja, revision 1.1.1.1

1.1       misho       1: README.ja  2007/06/18
                      2: 
                      3: 鬼車  ----   (C) K.Kosako <sndgk393 AT ybb DOT ne DOT jp>
                      4: 
                      5: http://www.geocities.jp/kosako3/oniguruma/
                      6: http://www.freebsd.org/cgi/cvsweb.cgi/ports/devel/oniguruma/
                      7: 
                      8: 鬼車は正規表現ライブラリである。
                      9: このライブラリの特長は、それぞれの正規表現オブジェクトごとに
                     10: 文字エンコーディングを指定できることである。
                     11: 
                     12: サポートしている文字エンコーディング:
                     13: 
                     14:   ASCII, UTF-8, UTF-16BE, UTF-16LE, UTF-32BE, UTF-32LE,
                     15:   EUC-JP, EUC-TW, EUC-KR, EUC-CN,
                     16:   Shift_JIS, Big5, GB 18030, KOI8-R, KOI8,
                     17:   ISO-8859-1, ISO-8859-2, ISO-8859-3, ISO-8859-4, ISO-8859-5,
                     18:   ISO-8859-6, ISO-8859-7, ISO-8859-8, ISO-8859-9, ISO-8859-10,
                     19:   ISO-8859-11, ISO-8859-13, ISO-8859-14, ISO-8859-15, ISO-8859-16
                     20: 
                     21: * GB 18030: 久保健洋氏提供
                     22: * KOI8はデフォルトのセットアップではライブラリの中に含まれない。
                     23:   (必要であればMakefileを編集すること)
                     24: ------------------------------------------------------------
                     25: 
                     26: インストール
                     27: 
                     28:  ケース1: UnixとCygwin環境
                     29: 
                     30:    1. ./configure
                     31:    2. make
                     32:    3. make install
                     33: 
                     34:    アンインストール
                     35: 
                     36:      make uninstall
                     37: 
                     38:    動作テスト (ASCII/EUC-JP)
                     39: 
                     40:      make atest
                     41: 
                     42: 
                     43:    構成確認
                     44: 
                     45:      onig-config --cflags
                     46:      onig-config --libs
                     47:      onig-config --prefix
                     48:      onig-config --exec-prefix
                     49: 
                     50: 
                     51: 
                     52:  ケース2: Win32(VC++)環境
                     53: 
                     54:    1. copy win32\Makefile Makefile
                     55:    2. copy win32\config.h config.h
                     56:    3. nmake
                     57: 
                     58:       onig_s.lib:  static link library
                     59:       onig.dll:    dynamic link library
                     60: 
                     61:   * 動作テスト (ASCII/Shift_JIS)
                     62:    4. copy win32\testc.c testc.c
                     63:    5. nmake ctest
                     64: 
                     65: 
                     66: ライセンス
                     67: 
                     68:   このソフトウェアがRubyと一緒に使用または配布される場合には、
                     69:   Rubyのライセンスに従う。
                     70:   それ以外の場合には、BSDライセンスに従う。
                     71: 
                     72: 
                     73: 正規表現
                     74: 
                     75:   doc/RE.jaを参照
                     76: 
                     77: 
                     78: 使用方法
                     79: 
                     80:   使用するプログラムで、oniguruma.hをインクルードする(Oniguruma APIの場合)。
                     81:   Oniguruma APIについては、doc/API.jaを参照。
                     82: 
                     83:   oniguruma.hで定義されている型名UChar(== unsigned char)を無効にしたい場合
                     84:   には、ONIG_ESCAPE_UCHAR_COLLISIONをdefineしてからoniguruma.hをインクルード
                     85:   すること。このときにはUCharは定義されず、OnigUCharという名前の定義のみが
                     86:   有効になる。
                     87: 
                     88:   oniguruma.hで定義されている型名regex_tを無効にしたい場合には、
                     89:   ONIG_ESCAPE_REGEX_T_COLLISIONをdefineしてからoniguruma.hをインクルード
                     90:   すること。このときにはregex_tは定義されず、OnigRegexType, OnigRegexという
                     91:   名前の定義のみが有効になる。
                     92: 
                     93:   Unix/Cygwin上でコンパイル、リンクする場合の例:
                     94:   (prefixが/usr/localのとき)
                     95:   cc sample.c -L/usr/local/lib -lonig
                     96: 
                     97:   GNU libtoolを使用しているので、プラットフォームが共有ライブラリをサポートして
                     98:   いれば、使用できるようになっている。
                     99:   静的ライブラリと共有ライブラリのどちらを使用するかを指定する方法、実行時点での
                    100:   環境設定方法につては、自分で調べて下さい。
                    101: 
                    102: 
                    103:   Win32でスタティックリンクライブラリ(onig_s.lib)をリンクする場合には、
                    104:   コンパイルするときに -DONIG_EXTERN=extern をコンパイル引数に追加すること。
                    105: 
                    106: 
                    107: 使用例プログラム
                    108: 
                    109:   sample/simple.c    最小例 (Oniguruma API)
                    110:   sample/names.c     名前付きグループコールバック使用例
                    111:   sample/encode.c    幾つかの文字エンコーディング使用例
                    112:   sample/listcap.c   捕獲履歴機能の使用例
                    113:   sample/posix.c     POSIX API使用例
                    114:   sample/sql.c       可変メタ文字機能使用例 (SQL-like パターン)
                    115:   sample/syntax.c    Perl、Java、ASIS文法のテスト
                    116: 
                    117: 
                    118: ソースファイル
                    119: 
                    120:   oniguruma.h        鬼車APIヘッダ (公開)
                    121:   onig-config.in     onig-configプログラム テンプレート
                    122: 
                    123:   regenc.h           文字エンコーディング枠組みヘッダ
                    124:   regint.h           内部宣言
                    125:   regparse.h         regparse.cとregcomp.cのための内部宣言
                    126:   regcomp.c          コンパイル、最適化関数
                    127:   regenc.c           文字エンコーディング枠組み
                    128:   regerror.c         エラーメッセージ関数
                    129:   regext.c           拡張API関数
                    130:   regexec.c          検索、照合関数
                    131:   regparse.c         正規表現パターン解析関数
                    132:   regsyntax.c        正規表現パターン文法関数、組込み文法定義
                    133:   regtrav.c          捕獲履歴木巡回関数
                    134:   regversion.c       版情報関数
                    135:   st.h               ハッシュテーブル関数宣言
                    136:   st.c               ハッシュテーブル関数
                    137: 
                    138:   oniggnu.h          GNU regex APIヘッダ (公開)
                    139:   reggnu.c           GNU regex API関数
                    140: 
                    141:   onigposix.h        POSIX APIヘッダ (公開)
                    142:   regposerr.c        POSIX APIエラーメッセージ関数
                    143:   regposix.c         POSIX API関数
                    144: 
                    145:   enc/mktable.c      文字タイプテーブル生成プログラム
                    146:   enc/ascii.c        ASCII エンコーディング
                    147:   enc/euc_jp.c       EUC-JP エンコーディング
                    148:   enc/euc_tw.c       EUC-TW エンコーディング
                    149:   enc/euc_kr.c       EUC-KR, EUC-CN エンコーディング
                    150:   enc/sjis.c         Shift_JIS エンコーディング
                    151:   enc/big5.c         Big5 エンコーディング
                    152:   enc/gb18030.c      GB 18030 エンコーディング (久保健洋氏 提供)
                    153:   enc/koi8.c         KOI8 エンコーディング
                    154:   enc/koi8_r.c       KOI8-R エンコーディング
                    155:   enc/iso8859_1.c    ISO-8859-1  (Latin-1)
                    156:   enc/iso8859_2.c    ISO-8859-2  (Latin-2)
                    157:   enc/iso8859_3.c    ISO-8859-3  (Latin-3)
                    158:   enc/iso8859_4.c    ISO-8859-4  (Latin-4)
                    159:   enc/iso8859_5.c    ISO-8859-5  (Cyrillic)
                    160:   enc/iso8859_6.c    ISO-8859-6  (Arabic)
                    161:   enc/iso8859_7.c    ISO-8859-7  (Greek)
                    162:   enc/iso8859_8.c    ISO-8859-8  (Hebrew)
                    163:   enc/iso8859_9.c    ISO-8859-9  (Latin-5 または Turkish)
                    164:   enc/iso8859_10.c   ISO-8859-10 (Latin-6 または Nordic)
                    165:   enc/iso8859_11.c   ISO-8859-11 (Thai)
                    166:   enc/iso8859_13.c   ISO-8859-13 (Latin-7 または Baltic Rim)
                    167:   enc/iso8859_14.c   ISO-8859-14 (Latin-8 または Celtic)
                    168:   enc/iso8859_15.c   ISO-8859-15 (Latin-9 または West European with Euro)
                    169:   enc/iso8859_16.c   ISO-8859-16
                    170:                      (Latin-10 または South-Eastern European with Euro)
                    171:   enc/utf8.c         UTF-8    エンコーディング
                    172:   enc/utf16_be.c     UTF-16BE エンコーディング
                    173:   enc/utf16_le.c     UTF-16LE エンコーディング
                    174:   enc/utf32_be.c     UTF-32BE エンコーディング
                    175:   enc/utf32_le.c     UTF-32LE エンコーディング
                    176:   enc/unicode.c      Unicode情報
                    177: 
                    178:   win32/Makefile     Win32用 Makefile (for VC++)
                    179:   win32/config.h     Win32用 config.h
                    180: 
                    181: 
                    182: 
                    183: Ruby 1.8/1.6の日本語化GNU regexとのAPIの違い
                    184: 
                    185:    + re_compile_fastmap()   は削除された。
                    186:    + re_alloc_pattern()     が追加された。
                    187: 
                    188: 
                    189: I'm thankful to Akinori MUSHA.
                    190: 
                    191: 
                    192: アドレス: K.Kosako <sndgk393 AT ybb DOT ne DOT jp>

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>