json_write(n) [mojave man page]

json::write(n)							       JSON							    json::write(n)

__________________________________________________________________________________________________________________________________________________

NAME

       json::write - JSON generation

SYNOPSIS

       package require Tcl  8.5

       package require json::write  ?1?

       ::json::write indented

       ::json::write indented flag

       ::json::write aligned

       ::json::write aligned flag

       ::json::write string s

       ::json::write array arg...

       ::json::write object key value...

_________________________________________________________________

DESCRIPTION

       The  json::write package provides a simple Tcl-only library for generation of text in the JSON http://www.json.org/ data exchange format as
       specified in RFC 4627 http://www.ietf.org/rfc/rfc4627.txt.

COMMANDS

       ::json::write indented
	      This method returns the current state of the indentation setting.

       ::json::write indented flag
	      This and the method aligned configure the layout of the JSON generated by the package.

	      If this flag is set (default) the package will break the generated JSON code across lines and  indent  it  according  to	its  inner
	      structure, with each key of an object on a separate line.

	      If this flag is not set, the whole JSON object will be written on a single line, with minimum spacing between all elements.

       ::json::write aligned
	      This method returns the current state of the alignment setting.

       ::json::write aligned flag
	      This and the method indented configure the layout of the JSON generated by the package.

	      If  this flag is set (default) the package ensures that the values for the keys in an object are vertically aligned with each other,
	      for a nice table effect. To make this work this also implies that indented is set as well.

	      If this flag is not set, the output is formatted as per the value of indented, without trying to align the values for object keys.

       ::json::write string s
	      This method takes the string s and returns it properly quoted for JSON as its result.

       ::json::write array arg...
	      This method takes a series of JSON formatted arguments and returns them as a properly formatted JSON array as its result.

       ::json::write object key value...
	      This method takes a series of key/value arguments, the values already formatted for JSON, and returns them as a  properly  formatted
	      JSON object as its result, with the keys formatted as JSON strings.

BUGS, IDEAS, FEEDBACK
       This  document, and the package it describes, will undoubtedly contain bugs and other problems.	Please report such in the category json of
       the Tcllib SF Trackers [http://sourceforge.net/tracker/?group_id=12883].  Please also report any ideas for enhancements you  may  have  for
       either package and/or documentation.

KEYWORDS

       data exchange, exchange format, javascript, json

CATEGORY

       CGI programming

COPYRIGHT

       Copyright (c) 2009 Andreas Kupries <andreas_kupries@sourceforge.net>

json									1.0							    json::write(n)

Check Out this Related Man Page

json(n) 							    JSON parser 							   json(n)

__________________________________________________________________________________________________________________________________________________

NAME

       json - JSON parser

SYNOPSIS

       package require Tcl  8.4

       package require json  ?1.0?

       ::json::json2dict txt

_________________________________________________________________

DESCRIPTION

       The json package provides a simple Tcl-only library for parsing the JSON http://www.json.org/ data exchange format as specified in RFC 4627
       http://www.ietf.org/rfc/rfc4627.txt.  There is some ambiguity in parsing JSON because JSON has type information that is not  maintained	by
       the Tcl conversion.  The json package returns data as a Tcl dict.  Either the dict package or Tcl 8.5 is required for use.

COMMANDS

       ::json::json2dict txt
	      Parse JSON formatted text txt into a Tcl dict and return the value.

EXAMPLES

       An example of a JSON array converted to Tcl.  A JSON array is returned as a single item with multiple elements.

       [
	   {
	      "precision": "zip",
	      "Latitude":  37.7668,
	      "Longitude": -122.3959,
	      "Address":   "",
	      "City":	   "SAN FRANCISCO",
	      "State":	   "CA",
	      "Zip":	   "94107",
	      "Country":   "US"
	   },
	   {
	      "precision": "zip",
	      "Latitude":  37.371991,
	      "Longitude": -122.026020,
	      "Address":   "",
	      "City":	   "SUNNYVALE",
	      "State":	   "CA",
	      "Zip":	   "94085",
	      "Country":   "US"
	   }
       ]
       =>
       {Country US Latitude 37.7668 precision zip State CA City {SAN FRANCISCO} Address {} Zip 94107 Longitude -122.3959} {Country US Latitude 37.371991 precision zip State CA City SUNNYVALE Address {} Zip 94085 Longitude -122.026020}

       An example of a JSON object converted to Tcl.  A JSON object is returned as a multi-element list (a dict).

       {
	   "Image": {
	       "Width":  800,
	       "Height": 600,
	       "Title":  "View from 15th Floor",
	       "Thumbnail": {
		   "Url":    "http://www.example.com/image/481989943",
		   "Height": 125,
		   "Width":  "100"
	       },
	       "IDs": [116, 943, 234, 38793]
	   }
       }
       =>
       Image {IDs {116 943 234 38793} Thumbnail {Width 100 Height 125 Url http://www.example.com/image/481989943} Width 800 Height 600 Title {View from 15th Floor}}

BUGS, IDEAS, FEEDBACK
       This  document, and the package it describes, will undoubtedly contain bugs and other problems.	Please report such in the category json of
       the Tcllib SF Trackers [http://sourceforge.net/tracker/?group_id=12883].  Please also report any ideas for enhancements you  may  have  for
       either package and/or documentation.

KEYWORDS

       data exchange, exchange format, javascript, json

COPYRIGHT

       Copyright (c) 2006 ActiveState Software Inc.

json									1.0								   json(n)

Linux and UNIX Man Pages

json_write(n) [mojave man page]

Check Out this Related Man Page