json_pointer_tuplejson_pointer_tupleJsonPointerTuplejson_pointer_tupleJsonPointerTupleJsonPointerTuple (Operator)

Name

json_pointer_tuplejson_pointer_tupleJsonPointerTuplejson_pointer_tupleJsonPointerTupleJsonPointerTuple — Parst einen Wert oder ein Array von Werten aus einem JSON-String mittels JSON Pointer.

Signatur

Beschreibung

json_pointer_tuplejson_pointer_tupleJsonPointerTuplejson_pointer_tupleJsonPointerTupleJsonPointerTuple parst einen Wert oder ein Array von Werten aus einem JSON-String mittels JSON Pointer. Der Operator kann als Abkürzung zur Kombination der Operatoren json_pointerjson_pointerJsonPointerjson_pointerJsonPointerJsonPointer und json_get_tuplejson_get_tupleJsonGetTuplejson_get_tupleJsonGetTupleJsonGetTuple verwendet werden.

Durch diesen Operator direkt unterstützte Datentypen sind:

• Ganzzahlen

  Ganzzahlen werden im HALCON-Tupel als Ganzzahlen (LONG_PAR / H_TYPE_INT) zurückgegeben.

• Gleitkommazahlen

  Gleitkommazahlen werden im HALCON-Tupel als Real-Zahlen (DOUBLE_PAR / H_TYPE_REAL) zurückgegeben.

• Strings

  Strings/Zeichenketten werden im HALCON-Tupel als Strings (STRING_PAR / H_TYPE_STRING) zurückgegeben.

• boolsche Werte

  Boolsche Werte werden im HALCON-Tupel als Ganzzahlen (LONG_PAR / H_TYPE_INT) zurückgegeben. true wird auf den Wert 1, false auf den Wert 0 abgebildet.

• null

  Null wird im HALCON-Tupel als Ganzzahl mit Wert 0 zurückgegeben.

Wenn die JSON-Repräsentation des Ziels des Pointers ein JSON-Objekt darstellt wird der Fehler 13003 (json_err_type_error) zurückgegeben. In diesem Fall muss statt json_pointer_tuplejson_pointer_tupleJsonPointerTuplejson_pointer_tupleJsonPointerTupleJsonPointerTuple eine Kombination aus json_pointerjson_pointerJsonPointerjson_pointerJsonPointerJsonPointer, json_object_keysjson_object_keysJsonObjectKeysjson_object_keysJsonObjectKeysJsonObjectKeys und json_atjson_atJsonAtjson_atJsonAtJsonAt verwendet werden um über das Ergebnis-JSON-Objekt zu iterieren.

Wenn die JSON-Repräsentation des Ziels des Pointers ein JSON-Array darstellt wird entsprechend ein mehrelementiges Tuple zurückgegeben. Falls ein Eintrag des Arrays allerdings strukturiert ist, der Eintrag also ein JSON-Array oder ein JSON-Objekt darstellt, wird der Fehler 13003 (json_err_type_error) zurückgegeben. In diesem Fall muss statt json_pointer_tuplejson_pointer_tupleJsonPointerTuplejson_pointer_tupleJsonPointerTupleJsonPointerTuple eine Kombination aus json_pointerjson_pointerJsonPointerjson_pointerJsonPointerJsonPointer, json_array_sizejson_array_sizeJsonArraySizejson_array_sizeJsonArraySizeJsonArraySize und json_atjson_atJsonAtjson_atJsonAtJsonAt verwendet werden um über das JSON-Array zu iterieren.

Mehr Informationen über das JSON Extension Package gibt es in der Einleitung zu diesem Kapitel.

Parallelisierung

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Wird ohne Parallelisierung verarbeitet.

Parameter

Modul

Foundation