Return to FAQ.ja CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / php / ext / mbstring / oniguruma / doc

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

1.1       misho       1: FAQ    2006/10/30
                      2: 
                      3: 1. 最長マッチ
                      4: 
                      5:    onig_new()の中で、ONIG_OPTION_FIND_LONGESTオプション
                      6:    を使用すれば最長マッチになる。
                      7: 
                      8: 
                      9: 2. スレッドセーフ
                     10: 
                     11:    スレッドセーフにするには、以下の(A)と(B)のどちらかを行なえば
                     12:    よい。
                     13: 
                     14:    (A) Oniguruma Layer
                     15: 
                     16:        oniguruma/regint.hの中のNOT_RUBYの部分の以下のマクロを定義する。
                     17: 
                     18:        USE_MULTI_THREAD_SYSTEM
                     19:        THREAD_ATOMIC_START
                     20:        THREAD_ATOMIC_END
                     21:        THREAD_PASS
                     22: 
                     23:        何らかの初期化/終了処理が必要であれば、以下のマクロに定義する。
                     24:        THREAD_SYSTEM_INIT
                     25:        THREAD_SYSTEM_END
                     26: 
                     27: 
                     28:    (B) Application Layer
                     29: 
                     30:        同時に複数のスレッドが、正規表現オブジェクトを作成する、
                     31:        または解放する、ことを行なってはならない。
                     32:        それらのオブジェクトが全く別のものであっても。
                     33: 
                     34:    もう少し詳しい説明は、このドキュメントの中の
                     35:    "スレッドセーフに関する補足"に書いておいた。
                     36: 
                     37: 
                     38: 3. メーリングリスト
                     39: 
                     40:    鬼車に関するメーリングリストは存在しない。
                     41: 
                     42: //END
                     43: 
                     44: 
                     45: 
                     46: スレッドセーフに関する補足
                     47: 
                     48: スレッドセーフにするには、個別のアプリケーションの中で行うか、
                     49: Onigurumaライブラリの中で行うか、どちらかを選ぶことができます。
                     50: (Onigurumaを使用する側で対処するか、Onigurumaに対処させるか
                     51: どちらか片方で行う必要があるということです。)
                     52: 
                     53: これらの方法について、以下(A)と(B)で説明します。
                     54: 
                     55: マルチスレッドAPIは、それぞれのプラットフォームによっても
                     56: 異なりますので、以下の説明の中で具体的に何を呼ぶのかを
                     57: 書くことは無理です。実際に使用されるマルチスレッドAPIで、
                     58: 対応する機能のものを指定してください。
                     59: 
                     60: (A) Onigurumaの中で対応する場合
                     61: 
                     62: oniguruma/regint.hの中のNOT_RUBYで囲まれている部分の中で
                     63: 以下のマクロを定義して再コンパイルしてください。
                     64: 
                     65: USE_MULTI_THREAD_SYSTEM
                     66: 
                     67:   単に有効にすればよいです。
                     68: 
                     69: THREAD_ATOMIC_START
                     70: THREAD_ATOMIC_END
                     71: 
                     72:   THREAD_ATOMIC_STARTからTHREAD_ATOMIC_ENDで囲まれた
                     73:   プログラムのコード部分をあるスレッドが実行中に、他の
                     74:   スレッドに実行権が移動しないことを保障するものに定義
                     75:   してください。
                     76:   (名前の通り、囲まれたコード部分をスレッドアトミックに
                     77:    するという意味)
                     78: 
                     79: THREAD_PASS
                     80: 
                     81:   これを実行したスレッドから、他のスレッドに実行権を委譲
                     82:   するものに定義をしてください。(再スケジュールを呼び出す
                     83:   という意味)
                     84:   対応する機能が全くなければ、空定義にしてください。
                     85: 
                     86: (参考例)
                     87: Rubyの場合を例にすると、
                     88: Rubyは自分自身で独自のスレッド機能を実装しています。
                     89: その機能を使用すると、以下のように定義すればよいことに
                     90: なります。
                     91: 
                     92: #define USE_MULTI_THREAD_SYSTEM
                     93: #define THREAD_SYSTEM_INIT
                     94: #define THREAD_SYSTEM_END
                     95: #define THREAD_ATOMIC_START       DEFER_INTS
                     96: #define THREAD_ATOMIC_END         ENABLE_INTS
                     97: #define THREAD_PASS               rb_thread_schedule()
                     98: 
                     99: Rubyの場合、タイマ割り込みを使用して、スレッドの切り替えを
                    100: 行っています。DEFER_INTSは割り込みハンドラの実行を一時的に
                    101: 止めるためのマクロです。ENABLE_INTSマクロで割り込みハンドラ
                    102: の実行を許可します。
                    103: これによって、THREAD_ATOMIC_STARTからTHREAD_ATOMIC_END
                    104: で囲まれた部分の実行中に、他のスレッドに実行権が移動しません。
                    105: 
                    106: 
                    107: (B) アプリケーションの中で対応する場合
                    108: 
                    109: 以下を保障するように、スレッドの実行を制御してください。
                    110: 
                    111: 同時に複数のスレッドが、正規表現オブジェクトを作成する、または解放する、ことを
                    112: 行なってはならない。それらのオブジェクトが全く別のものであっても。
                    113: 
                    114: onig_new(), onig_new_deluxe(), onig_free()のどれかの呼び出しを、
                    115: 複数のスレッドが同時に実行することを避けてください。同時でなければ別にかまいません。
                    116: 
                    117: これは何故必要なのかというと、正規表現オブジェクトを作成する
                    118: 過程で、内部で共通に参照するテーブルがあります。
                    119: このテーブルに対してのデータ登録処理が複数のスレッドで衝突して
                    120: 異常な状態にならないために必要です。
                    121: 
                    122: // END