JsonInsertNull

value JsonInsertNull ( value json, value Index, string strName );

Rückgabewert

Rückgabewert

Beschreibung

TRUE / true / 1

Das Element strName wurde erfolgreich eingefügt.

FALSE / false / 0

Der Element strName konnte nicht eingefügt werden.

Parameter

json

Das gültige JSON-Objekt, in dem das Element strName mit dem Wert null eingefügt werden soll.

Index

Die Position im JSON-Objekt json an der das Element strName mit dem Wert null eingefügt werden soll. Für das erste JSON-Element gilt: Index = 0.

strName

Der Name des Elements, das eingefügt werden soll. Der Name darf keine Pfadangabe sein.

Bemerkungen

Fügt das Element strName mit dem Wert null an der Position Index in das JSON-Objekt json ein. Der Schlüsselwert null zeigt an, dass dem Element kein Wert zugewiesen wurde, also auch nicht 0 bzw. ein Leerstring "" ist. Der Name strName des Elements darf keine Pfadangabe, wie bei JsonUpdateNull, enthalten.

Beispiel

//Inhalt von "data.json":
//{
//  "Boolean": true,
//  "Number": 3.14,
//  "WithoutContent": null,
//  "String": "xyz",
//  "Array": [
//    1,
//    true,
//    null,
//    "abc"
//  ]
//}
value json;
if (!JsonCreateFromFile(json, "data.json"))
    return (false);
end
value jsonArray;
jsonArray = JsonInsertArray(json, 1, "Values");
for (value i = 1; i <= 4; i ++) 
    JsonArrayAddNumber(jsonArray, i);
end
JsonInsertBool(json, 2, "Boolean Value", false);

JsonInsertNull(json, 3, "Empty");

JsonInsertString(json, 4, "Text", "abc");

value jsonObject;
jsonObject = JsonInsertObject(json, 5, "Numbers");
JsonAddNumber(jsonObject, "Pi", pi);
JsonAddNumber(jsonObject, "Euler number", e);

string strJson;
strJson = JsonToString(json);
//Inhalt von strJson:
//{
//  "Boolean": true,
//  "Values": [
//    1,
//    2,
//    3,
//    4
//  ],
//  "Boolean Value": false,
//  "Empty": null,
//  "Text": "abc",
//  "Numbers": {
//    "Pi": 3.141593,
//    "Euler number": 2.718282
//  },
//  "Number": 3.14,
//  "WithoutContent": null,
//  "String": "xyz",
//  "Array": [
//    1,
//    true,
//    null,
//    "abc"
//  ]
//}
JsonClose(json);
 

Die Json-Funktionen

Siehe auch  JsonInsertArray, JsonInsertBool, JsonInsertNumber, JsonInsertObject, JsonInsertString