API リファレンス
本セクションでは github.com/cybergodev/json ライブラリの完全な API リファレンスを提供します。
モジュール索引
| モジュール | 説明 |
|---|---|
| パッケージ関数 | パッケージレベル関数リファレンス（パスクエリ、型取得、エンコード・デコードなど） |
| Processor | プロセッサメソッドと設定 |
| Config | 設定オプション詳細 |
| 型定義 | コア型定義（Encoder/Decoder 含む） |
| ジェネリクス操作 | ジェネリック API リファレンス |
| インターフェース定義 | 拡張インターフェース定義 |
| ストリーミング処理 | ストリーミングプロセッサリファレンス |
| NDJSON 処理 | JSONL/NDJSON プロセッサ |
| イテレータ | 反復走査 API |
| ヘルパー関数 | 型変換とユーティリティ関数 |
| フォーマット出力 | フォーマットと整形出力 |
| セキュリティ検証 | セキュリティ関連 API |
| バリデータ | Schema バリデータ |
| フックシステム | 操作インターセプトフック |
| カスタムエンコーダ | カスタムエンコーダ |
| 定数とエラー | 定数とエラー型 |
クイック検索
機能別分類
パスクエリ
| 関数 | 説明 |
|---|---|
Get, GetString, GetInt, GetFloat, GetBool, GetArray, GetObject | 型安全な取得 |
GetTyped[T] | ジェネリック取得 |
SafeGet | 安全な取得 AccessResult |
GetMultiple | 一括取得 |
変更操作
| 関数 | 説明 |
|---|---|
Set, SetMultiple | 値の設定 |
SetCreate, SetMultipleCreate | 値の設定とパス自動作成 |
Delete, DeleteClean | 値の削除 |
ProcessBatch | 一括操作 |
エンコード・デコード
| 関数 | 説明 |
|---|---|
Marshal, Unmarshal | 標準エンコード・デコード |
MarshalIndent | フォーマットエンコード |
Encode, EncodeWithConfig | 文字列へのエンコード |
NewEncoder, NewDecoder | ストリーミングエンコード・デコード |
Parse | JSON のパース |
フォーマット
| 関数 | 説明 |
|---|---|
Prettify | JSON のフォーマット |
Compact | JSON の圧縮 |
ファイル操作
| 関数 | 説明 |
|---|---|
LoadFromFile, SaveToFile | ファイル読み書き |
LoadFromReader | Reader からの読み込み |
MarshalToFile, UnmarshalFromFile | ファイルエンコード・デコード |
ストリーミング処理
| 型/メソッド | 説明 |
|---|---|
ForeachFile | ファイルストリーミング処理 |
NDJSONProcessor | NDJSON/JSONL プロセッサ |
JSONLWriter | JSONL ライター |
バリデーション
| 関数 | 説明 |
|---|---|
Valid | JSON バリデーション |
ValidateSchema | Schema バリデーション（Schema 型と併用） |
命名規約
ライブラリは以下の命名規約に従います：
| パターン | 説明 | 例 |
|---|---|---|
Get{Type} | 指定型の取得（defaultValue 対応） | GetString, GetInt |
GetTyped[T] | ジェネリック取得、T を返す | GetTyped[User] |
New{Type} | インスタンスの作成 | New （*Processor を返す）、NewEncoder |
Default{Type} | デフォルト設定 | DefaultConfig |
{Type}Config | 設定プリセット | SecurityConfig, PrettyConfig |