Page History
...
| Code Block |
|---|
SRP_JsonX_Begin(Name, StartingTokenInit) |
Returns
Nothing. SRP_JsonX_Begin always succeeds, but it can produce a warning if you don't pass "{" or "[" as the starting token. See SRP_JsonX_Error.
...
| Parameter | Description | ||
|---|---|---|---|
| Name | The name of the new document, used for debugging purposes only | ||
| Init | Initial partial json. Must at lest | StartingToken | Determines if the new document's root is an object or an array. Can be "{" or "[". , but can be more hardcoded json to start. Optional.Default is "{" |
Remarks
SRP_JsonX_Begin creates a new document. If there was already an active document, that one is placed on the stack and this one becomes the active document. New documents must be initialized as a json object or json array, which is done via the StartingToken parameter. Set that parameter to
The Init parameter allows you to initialize the new document. At the very least, you should pass "{" to make start the root element document with an object as the root or "[" to make it an array.start the document with an array. However, you can pass as much json as you like to initalize the new document. The only thing you can't do is pass complete json since this routine is for starting a document you plan to build, not parse json. If, for example, you had a bunch of hardcoded json members you plan to return in a package, it is faster to pass json than to make a bunch of calls to SRP_JsonX to do the same thing. In the following example, we create a response initialized with some hardcoded members.
| Code Block |
|---|
SRP_JsonX_Begin('ErrorResponse', '{"status":200,"phrase":"OK","method":"GET","URL":"https:\\www.examples.com"')
If Len(Errors) then
SRP_JsonX('errors', '[')
For Each Error in Errors using @FM
SRP_JsonX(Error)
Next Error
SRP_JsonX(']')
end
ErrorResponse = SRP_JsonX_End('Pretty') |
The Name parameter can be anything you want as it is only used for debugging purposes. The name will appear when calling SRP_JsonX_State or SRP_JsonX_Trace.
...
