Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

json(n) [mojave man page]

json(n) 							       JSON								   json(n)

__________________________________________________________________________________________________________________________________________________

NAME

       json - JSON parser

SYNOPSIS

       package require Tcl  8.4

       package require json  ?1.1?

       ::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

CATEGORY

       CGI programming

COPYRIGHT

       Copyright (c) 2006 ActiveState Software Inc., 2009 Thomas Maeder, Glue Software Engineering AG

json									1.1								   json(n)

Check Out this Related Man Page

JSON_XS(1p)						User Contributed Perl Documentation					       JSON_XS(1p)

NAME

       json_xs - JSON::XS commandline utility

SYNOPSIS

	  json_xs [-v] [-f inputformat] [-t outputformat]

DESCRIPTION

       json_xs converts between some input and output formats (one of them is JSON).

       The default input format is "json" and the default output format is "json-pretty".

OPTIONS

       -v  Be slightly more verbose.

       -f fromformat
	   Read a file in the given format from STDIN.

	   "fromformat" can be one of:

	   json - a json text encoded, either utf-8, utf16-be/le, utf32-be/le
	   storable - a Storable frozen value
	   storable-file - a Storable file (Storable has two incompatible formats)
	   clzf - Compress::LZF format (requires that module to be installed)
	   yaml - YAML (avoid at all costs, requires the YAML module :)
	   eval - evaluate the given code as (non-utf-8) Perl, basically the reverse of "-t dump"
       -t toformat
	   Write the file in the given format to STDOUT.

	   "toformat" can be one of:

	   json, json-utf-8 - json, utf-8 encoded
	   json-pretty - as above, but pretty-printed
	   json-utf-16le, json-utf-16be - little endian/big endian utf-16
	   json-utf-32le, json-utf-32be - little endian/big endian utf-32
	   storable - a Storable frozen value in network format
	   storable-file - a Storable file in network format (Storable has two incompatible formats)
	   clzf - Compress::LZF format
	   yaml - YAML
	   dump - Data::Dump
	   dumper - Data::Dumper
	       Note that Data::Dumper doesn't handle self-referential data structures correctly - use "dump" instead.

EXAMPLES

	  json_xs -t null <isitreally.json

       "JSON Lint" - tries to parse the file isitreally.json as JSON - if it is valid JSON, the command outputs nothing, otherwise it will print
       an error message and exit with non-zero exit status.

	  <src.json json_xs >pretty.json

       Prettify the JSON file src.json to dst.json.

	  json_xs -f storable-file <file

       Read the serialised Storable file file and print a human-readable JSON version of it to STDOUT.

	  json_xs -f storable-file -t yaml <file

       Same as above, but write YAML instead (not using JSON at all :)

	  lwp-request http://cpantesters.perl.org/show/JSON-XS.json | json_xs

       Fetch the cpan-testers result summary "JSON::XS" and pretty-print it.

AUTHOR

       Copyright (C) 2008 Marc Lehmann <json@schmorp.de>

perl v5.14.2							    2010-08-17							       JSON_XS(1p)
Man Page