JSONから非平坦化関数

LabVIEWの拡張を有効化?は、NaNおよび倍精度の浮動小数のInf値をサポートするために、LabVIEW JSON拡張を有効にします。すべてのJSONパーサーでこれらの拡張をサポートされるわけではありません。

パスは、JSON文字列の特定項目を識別します。JSON文字列に複数の項目が含まれており、特定の項目を抽出したい場合は、パスを使用します。パスは、項目を特定するために、配列内の各要素がクラスタ要素名または配列の整数指標を参照する文字列配列を使用します。

パスを使用して項目を指定する場合、項目指定のデータタイプに対応するデータタイプをタイプとデフォルトに配線する必要があります。

たとえば、{"0":"abc","1":false,"2":[9,8,7]}というJSON文字列を例に考えてみます。以下に、さまざまなパスに必要なタイプとデフォルト入力と、その場合の値出力を示します。

パス	タイプとデフォルト	値	コメント
—		文字列abc、ブールFALSE、配列[9,8,7]を含むクラスタ	パスが空の場合、タイプとデフォルトはJSON文字列の各要素に対応する必要があります。例のJSON文字列の場合、文字列、ブール、配列を含むクラスタをタイプとデフォルトに配線する必要があります。
		文字列abc	この例では、パスは0という名前のクラスタ要素、または文字列abcを指します。よって、タイプとデフォルトに文字列を配線する必要があります。
		DBLの値 9	この例では、パスは2という名前のクラスタ要素 (配列)、およびその配列の指標0の要素を指します。この要素は浮動小数点数なので、タイプとデフォルトにDBL数値を配線する必要があります。

JSON文字列は、非平坦化したいUTF-8文字列です。この文字列を生成するには、「JSONに平坦化」関数を使用します。

タイプとデフォルトは、JSON文字列を非平坦化した後のデータタイプとデフォルト値を指定します。この入力は、ブール、整数、浮動小数点数、文字列、およびこれらのデータタイプの配列またはクラスタを受け入れます。クラスタ要素にはラベルを付けることも、付けないことも可能ですが、両方を混在させることはできません。クラスタ内の要素にラベルを付ける場合は、クラスタ内で固有の名前を付ける必要があります。サポートされていないデータタイプを配線すると、VIは壊れます。

JSON文字列の要素にラベルが付いている場合、タイプとデフォルトに配線されている要素にも同じラベルを付ける必要があります。たとえば、JSON文字列が{"firstelement":"a","secondelement":"b"}の場合、firstelementというラベルの付いた文字列とsecondelementというラベルの付いた文字列の入ったクラスタを配線する必要があります。さらに、JSON文字列内の特定項目のパスを指定する場合は、タイプとデフォルトに配線するデータタイプは、パスが示す項目のデータタイプと一致している必要があります。

エラー入力は、このノードを実行する前に発生したエラーの状態を示します。この入力は、標準エラー入力として機能します。

デフォルトのNULL要素?は、LabVIEWがJSON内のNULL値に入力クラスタからのデフォルト値を使用するかどうかを指定します。デフォルトのNULL要素がFALSEの場合、LabVIEWはNULL値に対してエラーを返します。

厳密な検証?により、JSONオブジェクトに入力クラスタで定義されていない項目が含まれている場合にエラーが返されるかどうかが決まります。厳密な検証?がFALSEの場合、JSONオブジェクトには、クラスタ内で定義されていない項目が含まれている可能性があります。

値は、タイプとデフォルトと同じデータタイプおよび構造の非平坦化データとしてJSON文字列を返します。

エラー出力には、エラー情報が含まれます。この出力は、標準エラー出力として機能します。