/usr/share/perl5/JSON/Types.pm is in libjson-types-perl 0.05-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 | package JSON::Types;
use strict;
use warnings;
use parent 'Exporter';
our $VERSION = '0.05';
our @EXPORT = qw/number string bool/;
sub number($) {
return undef unless defined $_[0];
$_[0] + 0;
}
sub string($) {
return undef unless defined $_[0];
$_[0] . '';
}
sub bool($) {
$_[0] ? \1 : \0;
}
1;
__END__
=head1 NAME
JSON::Types - variable type utility for JSON encoding
=head1 SYNOPSIS
# 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",
});
=head1 DESCRIPTION
The type mappings between JSON and Perl is annoying things. For example,
use JSON;
my $number = 123;
warn "[DEBUG] number:$number\n" if $ENV{DEBUG};
print encode_json([ $number ]);
Output of this code depends on whether DEBUG environment is set or not.
If set, result is C<[123]>. If not to set, result is C<["123"]>.
This is normal behaviour on Perl though, it sometimes causes unexpected JSON results.
There is a solution about this:
print encode_json([ $number + 0 ]);
This code always outputs C<[123]>.
But the code is a bit ugly and not readable at all.
This module provides some functions to fix this variable types issue:
number $foo; # is always number
string $foo; # is always string
bool $foo; # is always bool
You can fix above code by using this module like this:
use JSON;
use JSON::Types;
my $number = 123;
warn "[DEBUG] number:$number\n" if $ENV{DEBUG};
print encode_json([ number $number ]);
=head1 FUNCTIONS
There is three functions and all functions is exported by default.
If you don't want this exported functions, pass empty list to use line:
use JSON::Types ();
You should specify full function name when this case, like C<JSON::Types::number $foo> or etc.
=head2 string
=head2 number
=head2 bool
=head1 BEHAVIOURS ON UNEXPECTED ARGS
=head2 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:
number $undef_possible_value // 0
This code returns 0 if variable is undef.
=head2 number($string)
Passing not numeric variable to number function is returns 0, but a warning will be occurred.
=head1 AUTHOR
Daisuke Murase <typester@cpan.org>
=head1 COPYRIGHT AND LICENSE
Copyright (c) 2012 Daisuke Murase. All rights reserved.
This program is free software; you can redistribute
it and/or modify it under the same terms as Perl itself.
The full text of the license can be found in the
LICENSE file included with this module.
=cut
|