Annotation of embedaddon/php/ext/mbstring/oniguruma/README.ja, revision 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>