mirror of
https://github.com/ruby/ruby.git
synced 2022-11-09 12:17:21 -05:00
48 lines
1.6 KiB
Text
48 lines
1.6 KiB
Text
.\" marshal.doc - -*- Indented-Text -*- created at: Tue May 16 12:18:08 JST 1995
|
||
|
||
** Marshal(モジュール)
|
||
|
||
rubyオブジェクトをファイルに書き出したり，読みも度したりする機能を提供
|
||
するモジュール．大部分のクラスのインスタンスを書き出す事ができるが，ファ
|
||
イルへの不可能なクラスも存在し(例:IO)，そのようなクラスを書き出そうと
|
||
すると例外を発生させる．
|
||
|
||
Methods:
|
||
Single Methods:
|
||
|
||
dump(obj, port[, limit])
|
||
|
||
objを再帰的にファイルに書き出す．ファイルに書き出せないクラスのイ
|
||
ンスタンスをファイルに書き出そうとすると例外を発生させる．ファイル
|
||
に書き出せないクラスは以下の通り．
|
||
|
||
Class, Module, Data
|
||
|
||
また，これらのクラスを間接的に指すクラス(例えばIOのサブクラス)など
|
||
も書き出せない．portはIO(またはそのサブクラス)のインスタンスを指定
|
||
する．
|
||
|
||
出力するオブジェクトがメソッド`_dump_to'を定義している場合には，ファ
|
||
イル出力はそのメソッドを使って行われる．メソッド`_dump_to'は引数と
|
||
して出力先のファイルオブジェクトを受け取る．インスタンスがメソッド
|
||
`_dump_to'を持つクラスは必ず同じフォーマットを読み戻す特異メソッド
|
||
`_load_from'を定義する必要がある．
|
||
|
||
limitを指定した場合，limit段以上深くリンクしたオブジェクトをダンプ
|
||
できない(デフォルトは100レベル)。負のlimitを指定すると深さチェック
|
||
を行わない。
|
||
|
||
dumps(obj)
|
||
|
||
dump()がファイルに書き出すのと同じ内容を含む文字列を返す．
|
||
|
||
load(port)
|
||
|
||
portからオブジェクトを読み込んで来て，元のオブジェクトと同じ状態を
|
||
もつオブジェクトを生成する．portは文字列かIO(またはそのサブクラス)
|
||
のインスタンスである．
|
||
|
||
-------------------------------------------------------
|
||
Local variables:
|
||
fill-column: 70
|
||
end:
|