GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  JIFTY::JSON (3)

.ds Aq ’

NAME

Jifty::JSON -- Wrapper around JSON

CONTENTS

SYNOPSIS



  use Jifty::JSON qw/decode_json encode_json/;

  my $obj  = decode_json(q! { "x": "1", "y": "2", "z": "3" } !);
  my $json = encode_json($obj);



DESCRIPTION

Provides a thin wrapper around the JSON 2.xx library, which provides a frontend for JSON::XS and JSON::PP.

This module used to wrap JSON::Syck and JSON 1.xx with special-casing for outputting JSON with single quoted values. Single quotes make it easy to simply plop JSON into HTML attributes but are in violation of the JSON spec which mandates only double quoted strings.

The old behavior is now unsupported and it is recommended that you simply HTML escape your entire blob of JSON if you are sticking it in an HTML attribute. You can use Jifty->web->escape() to properly escape problematic characters for HTML.

FUNCTIONS

    decode_json JSON, [ARGUMENT HASHREF]

    encode_json JSON, [ARGUMENT HASHREF]

These functions are just like JSON’s, except that you can pass options to them like you can with JSON’s from_json and to_json functions.

By default they encode/decode using UTF8 (like JSON’s functions of the same name), but you can turn that off by passing utf8 => 0 in the options. The allow_nonref flag is also enabled for backwards compatibility with earlier versions of this module. It allows encoding/decoding of values that are not references.

JSON is imported with the -support_by_pp flag in order to support all options that JSON::PP provides when using JSON::XS as the backend. If you are concerned with speed, be careful what options you specify as it may cause the pure Perl backend to be used. Read JSON::PP SUPPORT METHODS in JSON for more information.

DEPRECATED FUNCTIONS

    jsonToObj JSON, [ARGUMENTS]

    objToJson JSON, [ARGUMENTS]

These functions are deprecated and provided for backwards compatibility. They wrap the appropriate function above, but croak in Carp if you try to set the singlequote option.

LICENSE

Jifty is Copyright 2005-2010 Best Practical Solutions, LLC. Jifty is distributed under the same terms as Perl itself.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 JIFTY::JSON (3) 2010-12-08

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.