7.9.1 MultiFile オブジェクト

7.9.1 MultiFile オブジェクト

MultiFile インスタンスには以下のメソッドがあります:

readline( str): 一行データを読みます。その行が (セクション分割子や終了マーカや本物の EOF でない) データの場合、行データを返します。その行がもっとも最近スタックにプッシュされた境界パターンにマッチした場合、'' を返し、マッチした内容が終了マーカかそうでないかによって self.last を 1 か 0 に設定します。行がその他のスタックされている境界パターンにマッチした場合、エラーが送出されます。背後のストリームオブジェクトにおけるファイルの終端に到達した場合、全ての境界がスタックから除去されていない限りこのメソッドは Error を送出します。

readlines( str): このパートの残りの全ての行を文字列のリストとして返します。

read( ): 次のセクションまでの全ての行を読みます。読んだ内容を単一の (複数行にわたる) 文字列として返します。このメソッドには size 引数をとらないので注意してください！

seek( pos[, whence]): ファイルを seek します。seek する際のインデクスは現在のセクションの開始位置からの相対位置になります。pis および whence 引数はファイルの seek における引数と同じように解釈されます。

tell( ): 現在のセクションの先頭に対して相対的なファイル位置を返します。

next( ): 次のセクションまで行を読み飛ばします (すなわち、セクション分割子または終了マーカが消費されるまで行データを読みます)。次のセクションがあった場合には真を、終了マーカが発見された場合には偽を返します。最も最近スタックにプッシュされた境界パターンを最有効化します。

is_data( str): str がデータの場合に真を返し、セクション分割子の可能性がある場合には偽を返します。このメソッドは行の先頭が (全ての MIME 境界が持っている) '--' 以外になっているかを調べるように実装されていますが、導出クラスで上書きできるように宣言されています。
このテストは実際の境界テストにおいて高速性を保つために使われているので注意してください; このテストが常に false を返す場合、テストが失敗するのではなく、単に処理が遅くなるだけです。

push( str): 境界文字列をスタックにプッシュします。この境界文字列の修飾されたバージョンが入力行に見つかった場合、セクション分割子または終了マーカであると解釈されます(どちらであるかは修飾に依存します。 RFC 2045を参照してください)。それ以降の全てのデータ読み出しは、pop() を呼んで境界文字列を除去するか、next() を呼んで境界文字列を再有効化しないかぎり、ファイル終端を示す空文字列を返します。
一つ以上の境界をプッシュすることは可能です。もっとも最近プッシュされた境界に遭遇すると EOF が返ります; その他の境界に遭遇するとエラーが送出されます。

pop( ): セクション境界をポップします。この境界はもはや EOF として解釈されません。

section_divider( str): 境界をセクション分割子にします。標準では、このメソッドは (全ての MIME 境界が持っている) '--' を境界文字列の先頭に追加しますが、これは導出クラスで上書きできるように宣言されています。末尾の空白は無視されることから考えて、このメソッドでは LF や CR-LF を追加する必要はありません。

end_marker( str): 境界文字列を終了マーカ行にします。標準では、このメソッドは (MIME マルチパートデータのメッセージ終了マーカのように) '--' を境界文字列の先頭に追加し、かつ '--' を境界文字列の末尾に追加しますが、これは導出クラスで上書きできるように宣言されています。末尾の空白は無視されることから考えて、このメソッドでは LF や CR-LF を追加する必要はありません。

最後に、MultiFile インスタンスは二つの公開されたインスタンス変数を持っています:

level: 現在のパートにおける入れ子の深さです。

last: 最後に見つかったファイル終了イベントがメッセージ終了マーカであった場合に真となります。

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。