.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "JSON::Types 3pm"
.TH JSON::Types 3pm "2012-10-17" "perl v5.14.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
JSON::Types \- variable type utility for JSON encoding
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 3
\&    # Export type functions by default
\&    use JSON;
\&    use JSON::Types;
\&    
\&    print encode_json({
\&        number => number "123",
\&        string => string 123,
\&        bool   => bool "True value",
\&    });
\&    # => {"number":123,"string":"123","bool":true}
\&    
\&    
\&    # Non export interface
\&    use JSON::Types ();
\&    
\&    print encode_json({
\&        number => JSON::Types::number "123",
\&        string => JSON::Types::string 123,
\&        bool   => JSON::Types::bool "True value",
\&    });
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
The type mappings between \s-1JSON\s0 and Perl is annoying things. For example,
.PP
.Vb 1
\&    use JSON;
\&    
\&    my $number = 123;
\&    
\&    warn "[DEBUG] number:$number\en" if $ENV{DEBUG};
\&    
\&    print encode_json([ $number ]);
.Ve
.PP
Output of this code depends on whether \s-1DEBUG\s0 environment is set or not.
If set, result is \f(CW\*(C`[123]\*(C'\fR. If not to set, result is \f(CW\*(C`["123"]\*(C'\fR.
This is normal behaviour on Perl though, it sometimes causes unexpected \s-1JSON\s0 results.
.PP
There is a solution about this:
.PP
.Vb 1
\&    print encode_json([ $number + 0 ]);
.Ve
.PP
This code always outputs \f(CW\*(C`[123]\*(C'\fR.
But the code is a bit ugly and not readable at all.
.PP
This module provides some functions to fix this variable types issue:
.PP
.Vb 3
\&    number $foo;  # is always number
\&    string $foo;  # is always string
\&    bool   $foo;  # is always bool
.Ve
.PP
You can fix above code by using this module like this:
.PP
.Vb 2
\&    use JSON;
\&    use JSON::Types;
\&    
\&    my $number = 123;
\&    
\&    warn "[DEBUG] number:$number\en" if $ENV{DEBUG};
\&    
\&    print encode_json([ number $number ]);
.Ve
.SH "FUNCTIONS"
.IX Header "FUNCTIONS"
There is three functions and all functions is exported by default.
.PP
If you don't want this exported functions, pass empty list to use line:
.PP
.Vb 1
\&    use JSON::Types ();
.Ve
.PP
You should specify full function name when this case, like \f(CW\*(C`JSON::Types::number $foo\*(C'\fR or etc.
.SS "string"
.IX Subsection "string"
.SS "number"
.IX Subsection "number"
.SS "bool"
.IX Subsection "bool"
.SH "BEHAVIOURS ON UNEXPECTED ARGS"
.IX Header "BEHAVIOURS ON UNEXPECTED ARGS"
.SS "string(undef), number(undef) returns undef, bool(undef) returns false."
.IX Subsection "string(undef), number(undef) returns undef, bool(undef) returns false."
Passing undefined variable to string and number function is returns undef. If you doesn't prefer this, have to treat this like following:
.PP
.Vb 1
\&    number $undef_possible_value // 0
.Ve
.PP
This code returns 0 if variable is undef.
.SS "number($string)"
.IX Subsection "number($string)"
Passing not numeric variable to number function is returns 0, but a warning will be occurred.
.SH "AUTHOR"
.IX Header "AUTHOR"
Daisuke Murase <typester@cpan.org>
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
Copyright (c) 2012 Daisuke Murase. All rights reserved.
.PP
This program is free software; you can redistribute
it and/or modify it under the same terms as Perl itself.
.PP
The full text of the license can be found in the
\&\s-1LICENSE\s0 file included with this module.