summaryrefslogtreecommitdiff
path: root/ext/marshal/marshal.doc
diff options
context:
space:
mode:
Diffstat (limited to 'ext/marshal/marshal.doc')
-rw-r--r--ext/marshal/marshal.doc45
1 files changed, 45 insertions, 0 deletions
diff --git a/ext/marshal/marshal.doc b/ext/marshal/marshal.doc
new file mode 100644
index 0000000000..8c3b63072e
--- /dev/null
+++ b/ext/marshal/marshal.doc
@@ -0,0 +1,45 @@
+.\" marshal.doc - -*- Indented-Text -*- created at: Tue May 16 12:18:08 JST 1995
+
+** Marshal(モジュール)
+
+rubyオブジェクトをファイルに書き出したり,読みも度したりする機能を提供
+するモジュール.大部分のクラスのインスタンスを書き出す事ができるが,ファ
+イルへの不可能なクラスも存在し(例:IO),そのようなクラスを書き出そうと
+すると例外を発生させる.
+
+Methods:
+Single Methods:
+
+ dump(obj, port)
+
+ objを再帰的にファイルに書き出す.ファイルに書き出せないクラスのイ
+ ンスタンスをファイルに書き出そうとすると例外を発生させる.ファイル
+ に書き出せないクラスは以下の通り.
+
+ Class, Module, Data
+
+ また,これらのクラスを間接的に指すクラス(例えばIOのサブクラス)など
+ も書き出せない.portはIO(またはそのサブクラス)のインスタンスを指定
+ する.
+
+ 出力するオブジェクトがメソッド`_dump_to'を定義している場合には,ファ
+ イル出力はそのメソッドを使って行われる.メソッド`_dump_to'は引数と
+ して出力先のファイルオブジェクトを受け取る.インスタンスがメソッド
+ `_dump_to'を持つクラスは必ず同じフォーマットを読み戻す特異メソッド
+ `_load_from'を定義する必要がある.
+
+
+ dumps(obj)
+
+ dump()がファイルに書き出すのと同じ内容を含む文字列を返す.
+
+ load(port)
+
+ portからオブジェクトを読み込んで来て,元のオブジェクトと同じ状態を
+ もつオブジェクトを生成する.portは文字列かIO(またはそのサブクラス)
+ のインスタンスである.
+
+-------------------------------------------------------
+Local variables:
+fill-column: 70
+end: