TJSONObject.Create

Create a new instance of JSON object data.

Declaration

Source position: fpjson.pp line 527

Arguments

Description

Create creates a new JSON object instance, and initializes the data with Elements. Elements is an array containing an even number of items, alternating a name and a value. The names must be strings, and the values are converted to various TJSONData instances. If a value is an instance of TJSONData, it is added to the object array as-is.

The data type of the inserted objects is determined from the type of data passed to it, with a natural mapping. A Nil pointer will be inserted as a TJSONNull value. The following gives an example:

Var
  O : TJSONObject;
    
begin
  O:=TJSONObject.Create(['Age',44,
                        'Firstname','Michael',
                        'Lastname','Van Canneyt']);
                                                        

Errors

An EConvertError exception is raised in one of the following cases:

1. If an odd number of arguments is passed
2. an item where a name is expected does not contain a string
3. A value contains an invalid class
4. A value of a not recognized data type (pointer) is inserted in the elements

See also