ファイル I/O メソッド

Processor はファイル、io.Reader、io.Writer の 3 種類のデータソースを扱う JSON ファイル読み書きおよびストリーミング読み込みメソッドを提供します。

ファイル読み込み

LoadFromFile

シグネチャ：func (p *Processor) LoadFromFile(filePath string, cfg ...Config) (string, error)

ファイルから JSON データを読み込み、元の文字列を返します。

data, err := p.LoadFromFile("config.json")
if err != nil {
    panic(err)
}
fmt.Println(data) // 元の JSON 文字列

LoadFromFileAsData（非公開化）

API 変更のお知らせ

LoadFromFileAsData は内部メソッド（loadFromFileAsData）に移行され、公開 API としてエクスポートされなくなりました。LoadFromFile + Parse の組み合わせを代替として使用してください：

jsonStr, err := p.LoadFromFile("data.json")
if err != nil {
    panic(err)
}
var data any
err = p.Parse(jsonStr, &data)
// data の型は map[string]any または []any
if obj, ok := data.(map[string]any); ok {
    fmt.Println(obj["name"])
}

Reader 読み込み

LoadFromReader

シグネチャ：func (p *Processor) LoadFromReader(reader io.Reader, cfg ...Config) (string, error)

Reader から JSON データを読み込み、元の文字列を返します。

file, _ := os.Open("data.json")
defer file.Close()

data, err := p.LoadFromReader(file)
if err != nil {
    panic(err)
}

LoadFromReaderAsData（非公開化）

API 変更のお知らせ

LoadFromReaderAsData は内部メソッド（loadFromReaderAsData）に移行され、公開 API としてエクスポートされなくなりました。LoadFromReader + Parse の組み合わせを代替として使用してください：

file, _ := os.Open("data.json")
defer file.Close()

jsonStr, err := p.LoadFromReader(file)
if err != nil {
    panic(err)
}
var data any
err = p.Parse(jsonStr, &data)

ファイル書き込み

SaveToFile

シグネチャ：func (p *Processor) SaveToFile(filePath string, data any, cfg ...Config) error

データを JSON ファイルとして保存します。親ディレクトリを自動的に作成します。

err := p.SaveToFile("data.json", map[string]any{"name": "CyberGo"})

// PrettyConfig でフォーマット出力を保存
err = p.SaveToFile("data.json", data, json.PrettyConfig())

MarshalToFile

シグネチャ：func (p *Processor) MarshalToFile(path string, data any, cfg ...Config) error

データを JSON にエンコードしてファイルに書き込みます。親ディレクトリを自動的に作成します。

err := p.MarshalToFile("output.json", data)

// フォーマットして保存
err = p.MarshalToFile("output.json", data, json.PrettyConfig())

UnmarshalFromFile

シグネチャ：func (p *Processor) UnmarshalFromFile(path string, v any, cfg ...Config) error

ファイルから JSON を読み込み、ターゲット変数にデコードします。

var config Config
err := p.UnmarshalFromFile("config.json", &config)
if err != nil {
    panic(err)
}

SaveToWriter

シグネチャ：func (p *Processor) SaveToWriter(writer io.Writer, data any, cfg ...Config) error

データを JSON にエンコードして io.Writer に書き込みます。

var buf bytes.Buffer
err := p.SaveToWriter(&buf, data, json.PrettyConfig())

メソッドの選択

シナリオ	推奨メソッド
元の文字列が必要な場合	LoadFromFile / LoadFromReader
解析後のデータが必要な場合	LoadFromFile + Parse / LoadFromReader + Parse
データをファイルに保存	SaveToFile / MarshalToFile
Writer への書き込み	SaveToWriter
ファイルからの読み込みとデコード	UnmarshalFromFile

関連

• パースと検証 - Parse/Valid 解析メソッド
• ファイル I/O 関数 - パッケージレベルファイル関数