Serialization
Juliaオブジェクトのシリアライズ機能を提供します。
Serialization.serialize — Function
serialize(stream::IO, value)任意の値を不透明な形式でストリームに書き込み、deserializeで読み戻せるようにします。読み戻した値は元の値と可能な限り同一になりますが、Ptrの値はすべてゼロのビットパターンとしてシリアライズされる点に注意してください(NULL)。
まず、識別用の8バイトのヘッダーがストリームに書き込まれます。ヘッダーを書き込まないようにするには、Serializerを作成し、それをserializeの第1引数として使用してください。Serialization.writeheaderも参照してください。
データ形式はJuliaのマイナーリリース(1.x)間で変更されることがありますが、以前の1.xバージョンで書き込まれたファイルは引き続き読み込めます。主な例外は、外部パッケージ内の型定義が変更された場合です。その場合、環境内で該当パッケージの互換性のあるバージョンを明示的に指定する必要が生じることがあります。また、パッケージ内の関数(非公開関数も含む)の名前を変更すると、既存のファイルとの互換性が失われることがあります。無名関数には特に注意が必要です。名前が自動生成されるため、コードを少し変更しただけでも名前が変わることがあります。長期保存を目的とするファイルでは、無名関数のシリアライズは避けてください。
場合によっては、読み込み側と書き込み側のマシンでワードサイズ(32ビットまたは64ビット)を一致させる必要があります。さらにまれなケースでは、OSやアーキテクチャも一致させる必要があります。たとえば、プラットフォーム依存のコードを含むパッケージを使用する場合が該当します。
serialize(filename::AbstractString, value)ファイルを開き、指定した値をシリアライズして書き込みます。
Serialization.deserialize — Function
deserialize(stream)serializeで書き込まれた値を読み取ります。deserializeは、streamから読み取ったバイナリデータが正しく、serializeの互換実装によってシリアライズされていることを前提とします。deserializeはシンプルさとパフォーマンスを重視して設計されているため、読み取ったデータの検証は行いません。不正なデータによってプロセスが終了する可能性があります。呼び出し元は、streamから読み取るデータの完全性と正しさを保証する必要があります。
Serialization.writeheader — Function
Serialization.writeheader(s::AbstractSerializer)指定したシリアライザーに識別用ヘッダーを書き込みます。ヘッダーは次の8バイトで構成されます。
| オフセット | 説明 |
|---|---|
| 0 | タグバイト(0x37) |
| 1-2 | シグネチャバイト「JL」 |
| 3 | プロトコルバージョン |
| 4 | ビット0-1:エンディアン:0 = リトル、1 = ビッグ |
| 4 | ビット2-3:プラットフォーム:0 = 32ビット、1 = 64ビット |
| 5-7 | 予約済み |
Recommended File Extension
Serializationモジュールでは特定のファイル拡張子を定めていませんが、Juliaコミュニティでは、シリアライズされたJuliaファイルに.jls拡張子を使うのが一般的です。
例:
open("model.jls", "w") do io
serialize(io, my_model)
end