manpagez: man pages & more
man json_write(n)
Home | html | info | man
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 genera-
       tion 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 set-
              ting.

       ::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 gener-
              ated 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  val-
              ues  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  for-
              matted  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://source-
       forge.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)

Mac OS X 10.8 - Generated Sun Sep 9 13:25:29 CDT 2012
© manpagez.com 2000-2025
Individual documents may contain additional copyright information.