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>