json_pointer_tuplejson_pointer_tupleJsonPointerTuplejson_pointer_tupleJsonPointerTupleJsonPointerTuple (Operator)

Name

json_pointer_tuplejson_pointer_tupleJsonPointerTuplejson_pointer_tupleJsonPointerTupleJsonPointerTuple — Uses a JSON Pointer to parse a value or an array of values from a JSON string.

Signature

Description

json_pointer_tuplejson_pointer_tupleJsonPointerTuplejson_pointer_tupleJsonPointerTupleJsonPointerTuple uses a JSON Pointer to parse a value or an array of values from a JSON string. The operator can be used as shortcut for the combination of the operators json_pointerjson_pointerJsonPointerjson_pointerJsonPointerJsonPointer and json_get_tuplejson_get_tupleJsonGetTuplejson_get_tupleJsonGetTupleJsonGetTuple.

Directly supported data types are:

• Integers

  Integers will be returned as integers (LONG_PAR / H_TYPE_INT) in the HALCON tuple.

• Floating point numbers

  Floating point numbers will be returned as Real numbers (DOUBLE_PAR / H_TYPE_REAL) in the HALCON tuple.

• Strings

  Strings will be returned as strings (STRING_PAR / H_TYPE_STRING) in the HALCON tuple.

• Boolean Values

  Boolean values will be returned as integers (LONG_PAR / H_TYPE_INT) in the HALCON tuple. true will be mapped to 1, false will be mapped to 0.

• Null

  Null will be returned as integer (LONG_PAR / H_TYPE_INT) with value 0 in the HALCON tuple.

If the JSON representation of the target of the pointer is a JSON object, the error 13003 (json_err_type_error) will be returned. In this case a combination of json_pointerjson_pointerJsonPointerjson_pointerJsonPointerJsonPointer, json_object_keysjson_object_keysJsonObjectKeysjson_object_keysJsonObjectKeysJsonObjectKeys, and json_atjson_atJsonAtjson_atJsonAtJsonAt should be used to iterate over the JSON object.

If the JSON representation of the target of the pointer is a JSON array, a multi-value tuple will be returned. In an entry of the array is structured, i.e. the entry represents a JSON array or JSON object, the error 13003 (json_err_type_error) will be returned. In this case a combination of json_pointerjson_pointerJsonPointerjson_pointerJsonPointerJsonPointer, json_array_sizejson_array_sizeJsonArraySizejson_array_sizeJsonArraySizeJsonArraySize, and json_atjson_atJsonAtjson_atJsonAtJsonAt should be used to iterate over the JSON array.

Find more information about the JSON extension package in the introduction to this chapter.

Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Module

Foundation