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やアーキテクチャも一致させる必要があります。たとえば、プラットフォーム依存のコードを含むパッケージを使用する場合が該当します。

source
serialize(filename::AbstractString, value)

ファイルを開き、指定した値をシリアライズして書き込みます。

Julia 1.1

このメソッドは Julia 1.1 以降で利用できます。

source
Serialization.deserialize — Function
deserialize(stream)

serializeで書き込まれた値を読み取ります。deserializeは、streamから読み取ったバイナリデータが正しく、serializeの互換実装によってシリアライズされていることを前提とします。deserializeはシンプルさとパフォーマンスを重視して設計されているため、読み取ったデータの検証は行いません。不正なデータによってプロセスが終了する可能性があります。呼び出し元は、streamから読み取るデータの完全性と正しさを保証する必要があります。

source
deserialize(filename::AbstractString)

ファイルを開き、その内容をデシリアライズします。

Julia 1.1

このメソッドは Julia 1.1 以降で利用できます。

source
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予約済み
source

Serializationモジュールでは特定のファイル拡張子を定めていませんが、Juliaコミュニティでは、シリアライズされたJuliaファイルに.jls拡張子を使うのが一般的です。

例:

open("model.jls", "w") do io
    serialize(io, my_model)
end