Name
json_at_tuplejson_at_tupleJsonAtTuplejson_at_tupleJsonAtTupleJsonAtTuple — Parst einen Wert oder ein Array von Werten an einer gegebenen Position aus einem JSON-Objekt oder JSON-Array.
Herror json_at_tuple(const char* Json, const char* Key, char* Value)
Herror T_json_at_tuple(const Htuple Json, const Htuple Key, Htuple* Value)
Herror json_at_tuple(const HTuple& Json, const HTuple& Key, char* Value)
Herror json_at_tuple(const HTuple& Json, const HTuple& Key, HTuple* Value)
void JsonAtTuple(const HTuple& Json, const HTuple& Key, HTuple* Value)
json_at_tuplejson_at_tupleJsonAtTuplejson_at_tupleJsonAtTupleJsonAtTuple parst einen Wert oder ein Array von Werten an einer gegebenen Position aus einem JSON-Objekt oder JSON-Array.
Der Operator kann als Abkürzung zur Kombination der Operatoren json_atjson_atJsonAtjson_atJsonAtJsonAt und json_get_tuplejson_get_tupleJsonGetTuplejson_get_tupleJsonGetTupleJsonGetTuple verwendet werden.
Für JSON-Objekte wird die Position über einen String als Schlüssel in KeyKeyKeyKeyKeykey übergeben.
Für JSON-Arrays wird die Position über eine Ganzzahl als Index in KeyKeyKeyKeyKeykey übergeben.
Wenn die JSON-Repräsentation an der Position KeyKeyKeyKeyKeykey ein JSON-Objekt darstellt wird der Fehler 13003 (json_err_type_error) zurückgegeben. In diesem Fall muss statt
json_at_tuplejson_at_tupleJsonAtTuplejson_at_tupleJsonAtTupleJsonAtTuple eine Kombination aus json_atjson_atJsonAtjson_atJsonAtJsonAt, json_object_keysjson_object_keysJsonObjectKeysjson_object_keysJsonObjectKeysJsonObjectKeys und json_at_tuplejson_at_tupleJsonAtTuplejson_at_tupleJsonAtTupleJsonAtTuple verwendet werden um über das Ergebnis-JSON-Objekt zu iterieren.
Wenn die JSON-Repräsentation an der Position KeyKeyKeyKeyKeykey 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_at_tuplejson_at_tupleJsonAtTuplejson_at_tupleJsonAtTupleJsonAtTuple eine Kombination aus json_atjson_atJsonAtjson_atJsonAtJsonAt, json_array_sizejson_array_sizeJsonArraySizejson_array_sizeJsonArraySizeJsonArraySize und json_at_tuplejson_at_tupleJsonAtTuplejson_at_tupleJsonAtTupleJsonAtTuple verwendet werden um über das JSON-Array zu iterieren.
Mehr Informationen über das JSON Extension Package gibt es in der Einleitung zu diesem Kapitel.
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
JsonJsonJsonJsonJsonjson (input_control) string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)
JSON string
KeyKeyKeyKeyKeykey (input_control) string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)
key or zero-based index
ValueValueValueValueValuevalue (output_control) string(-array) → HTupleHTupleHTupleVARIANTHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double) (BSTR / Hlong / double) (char* / Hlong / double)
value
json_atjson_atJsonAtjson_atJsonAtJsonAt
Foundation