jsConClose

Removes one or all extender JSON container handles from the extender's handle table.

Syntax:

jsConClose ( [Container-handle] )

Parameters:

(s) container-handle: [optional] extender container handle to release.

Returns:

1 on success.

JsConClose accepts an extender JSON object or array container handle and removes the handle from the internal container handle table. The function also attempts to release all system resources associated with the handle. Once a handle is released it can no longer be used in extender functions.

Container-Handle

The unique identifier returned from a call to the jsParse, jsConNew, jsValueGet functions, or by accessing WIL map element returned by the jsConMap function. If this parameter is not supplied to the function the function will remove all open JSON container handles from the extender internal handle table.

Example:

  AddExtender('ilcjs44i.dll', 0, 'ilcjs64i.dll')
  ; JSON object text.
  strJson = $"{"pi":: 3.141,"happy":: true,"name":: "WIL JSON Extender",
    "nothing":: null,"answer":: {"everything":: 42},"list":: [1, 0, 2],
    "object":: {"currency":: "USD","value":: 42.99,"nested object":: {
    "value":: "bird egg"}},"value":: "Top level value"}$"
  
  Object1 = jsParse(strJson)
  ; Close one object.
  jsConClose(Object1)
  ; or you can close all open objects.
  jsConClose()
  

See Also:

jsParse, jsConNew, jsValueGet, jsConMap