====================
Unicon Class Library
====================

.. Modified: 2019-02-02/12:48-0500 btiffin
.. Copyright 2016 Brian Tiffin
.. This file is part of the Unicon Programming document
.. GPL 3.0+ :ref:`license`

.. image:: images/unicon.png
   :align: center

.. only:: html

    :ref:`genindex`
    :floatright:`<a href="http://unicon.sourceforge.net/">Unicon</a>`

.. index:: UCL

.. _UCL:

UCL
===

The Unicon Class Library.  A collection of Unicon programs, procedures,
classes, methods, and supporting data.  Includes the Unicon GUI classes by
Robert Parlett, JSON support by Gigi Young, development tools, and many more
useful extensions to core Unicon.

The library is also very useful for learning Unicon, with lots of well written
Unicon source code.

The UCL source code included with the Unicon distribution is licensed under
the Lesser GNU General Public License.

Like the :ref:`IPL`, knowing how to best leverage the Unicon Class Library can
take some time. There are hundreds of supporting classes to take advantage of.

Find all the sources in the uni/lib directory of the Unicon source tree. Most
of these are precompiled with an installation, easily included in applications
with a simple :ref:`link` expression.


.. index:: JSON

JSON
----

A contribution by Gigi Young and :ref:`Clint`, provides access to JSON
handling.

Use ``link json`` to include the features. There are high level (thread safe)
functions of ``jtou()`` and ``utoj()``.  These convert JSON to Unicon and
Unicon to JSON data structures, respectively.

A technical report for Unicon JSON, UTR20, is hosted at
http://unicon.org/utr/utr20.pdf

Quick sample, from the technical report:

.. literalinclude:: examples/json-trial.icn
   :language: unicon
   :start-after: ##+

.. only:: html

    .. rst-class:: rightalign

        :download:`examples/json-trial.icn`

.. command-output:: unicon -s json-trial.icn -x
   :cwd: examples


.. only:: html

    ..

    --------

    :ref:`genindex` | Previous: :doc:`ipl` | Next: :doc:`scenarios`

    |