JSON→cJSON構造体変換

JSONサンプルからcJSON向けのCコードへ

このページでは、貼り付けたJSONをもとにデータの形を推定し、cJSON向けのCコードを生成します。初期設定では型定義のみを出力します。詳細設定で型定義のみの設定を切り替えると、JSONを読み取るためのコードも生成対象になります。入力の書式を整える操作、サンプルの読み込み、結果のコピーやダウンロードも行えます。

JSONは、オブジェクトや配列の中に文字列・数値・真偽値・nullなどを含められるデータ形式です。生成器は入力されたサンプルに現れた値を手掛かりに型を推定します。出力の型や構造は、サンプルにない値や実際のAPI仕様を自動で保証するものではありません。

推定結果を読むときのポイント

たとえば {"sensor":{"id":7,"active":true}} のようなJSONでは、オブジェクトの入れ子と、数値・真偽値のフィールドが手掛かりになります。配列も要素の例から形を推定するため、サンプル内に一種類しか要素がない場合、実データで異なる値が来る可能性までは読み取れません。

JSONの数値表記だけでは、その値が業務上の整数なのか、小数を含む量なのか、許容範囲がいくつなのかは決まりません。フィールド名の命名規則、必須か任意か、nullを許すかも、実際の通信仕様やデータ契約と照らして判断してください。JSONの構文上の値の種類は RFC 8259 を参照できます。

入力からCコードを取り出す

1. 完全なJSONサンプルを入力欄に貼り付けます。コメントや末尾の余分なカンマを含めず、文字列を二重引用符で囲んでください。

2. 必要に応じて整形ボタンでインデントを整え、型名欄に生成結果のルート型名を入力します。

3. 初期状態では型定義のみが選ばれています。読み取りコードも必要な場合は詳細設定を開き、型定義のみの設定を確認して切り替えます。

4. 出力を確認し、コピーまたはダウンロードします。生成コードをプロジェクトに加える前に、利用するcJSONの版、既存の型定義、コンパイラ設定に合わせて見直してください。

入力例: {"device":{"id":7,"online":true}}。この1件から分かるのは、deviceの下に数値らしいidと真偽値onlineがあることです。欠落フィールドや別の配列要素を扱うには、追加の実データ例も確認します。

つまずきやすい点

採用前に確認すること

生成結果は、入力サンプルから作るコードの出発点です。実際のデータ契約、フィールドの必須性、nullの扱い、配列の全パターン、数値の範囲を自動で確定するものではありません。生成コードを対象プロジェクトでレビューし、想定する入力例と異常系を使って検証してください。

解析コードを利用するときは、返された値の型や存在確認、解析失敗時の処理、確保したオブジェクトの解放などをアプリケーション側で適切に実装する必要があります。コード生成と、製品環境での安全性・正しさの検証は別の作業です。