=cut
###----------------------------------------------------------------###
-# Copyright 2006 - Paul Seamons #
+# Copyright 2007 - Paul Seamons #
# Distributed under the Perl Artistic License without warranty #
###----------------------------------------------------------------###
use base qw(Exporter);
BEGIN {
- $VERSION = '2.04';
+ $VERSION = '2.08';
@EXPORT = qw(JSONDump);
@EXPORT_OK = @EXPORT;
return 'null' if ! defined $str;
### allow things that look like numbers to show up as numbers (and those that aren't quite to not)
- return $str if $str =~ /^ -? (?: \d{0,13} \. \d* [1-9] | \d{1,13}) $/x;
+ return $str if $str =~ /^ -? (?: [1-9][0-9]{0,12} | 0) (?: \. \d* [1-9])? $/x;
my $quote = $self->{'single_quote'} ? "'" : '"';
$str =~ s/\\/\\\\/g;
- $str =~ s/\r/\\\r/g;
- $str =~ s/\t/\\\t/g;
+ $str =~ s/\r/\\r/g;
+ $str =~ s/\t/\\t/g;
$self->{'single_quote'} ? $str =~ s/\'/\\\'/g : $str =~ s/\"/\\\"/g;
### allow for really odd chars
utf8::decode($str) if $self->{'utf8'} && &utf8::decode;
### escape <html> and </html> tags in the text
- $str =~ s{(</? (?: htm | scrip | !-))}{$1$quote+$quote}gx;
+ $str =~ s{(</? (?: htm | scrip | !-) | --(?=>) )}{$1$quote+$quote}gx
+ if ! $self->{'no_tag_splitting'};
### add nice newlines (unless pretty is off)
if ($self->{'str_nl'} && length($str) > 80) {
{
"a" : [
1,
- 2,
+ 2
]
}
with single quotes. Otherwise values are quoted with double quotes.
JSONDump("a", {single_quote => 0});
- JSONDump('a', {single_quote => 0});
+ JSONDump("a", {single_quote => 1});
Would print
0 or 1. Default 1 (true)
-If true, then key/value pairs of hashrefs will be sorted will be output in sorted order.
+If true, then key/value pairs of hashrefs will be output in sorted order.
=item play_coderefs
=item skip_keys
-Should contain an arrayref of keys or a hashref whose keys are the keys to skip. Default
-is unset. Any keys of hashrefs that are in the skip_keys item will not be included in
-the javascript output.
+Should contain an arrayref of keys or a hashref whose keys are the
+keys to skip. Default is unset. Any keys of hashrefs (including
+nested hashrefs) that are listed in the skip_keys item will not be included
+in the javascript output.
JSONDump({a => 1, b => 1}, {skip_keys => ['a'], pretty => 0});
=item skip_keys_qr
-Similar to skip_keys but should contain a regex. Any keys of hashrefs that match the
-skip_keys_qr regex will not be included in the javascript output.
+Similar to skip_keys but should contain a regex. Any keys of hashrefs
+(including nested hashrefs) that match the skip_keys_qr regex will not
+be included in the javascript output.
JSONDump({a => 1, _b => 1}, {skip_keys_qr => qr/^_/, pretty => 0});
=item indent
-The level to indent each nested data structure level if pretty is true. Default is " ".
+The level to indent each nested data structure level if pretty is true. Default is " " (two spaces).
=item hash_nl
=item str_nl
The whitespace to add in between newline separated strings if pretty is true or the output line is
-greater than 80 characters. Default is "\n".
+greater than 80 characters. Default is "\n" (if pretty is true).
JSONDump("This is a long string\n"
."with plenty of embedded newlines\n"
- ."and is greater than 80 characters.\n", {pretty => 1, str_nl => "\n"});
+ ."and is greater than 80 characters.\n", {pretty => 1});
Would print
+"with plenty of embedded newlines\n"
+"and is greater than 80 characters.\n"
-If the string is less than 80 characters, or if str_nl is set to '', then the escaped
-string will be contained on a single line.
+ JSONDump("This is a long string\n"
+ ."with plenty of embedded newlines\n"
+ ."and is greater than 80 characters.\n", {pretty => 1, str_nl => ""});
+
+ Would print
+
+ "This is a long string\nwith plenty of embedded newlines\nand is greater than 80 characters.\n"
+
+If the string is less than 80 characters, or if str_nl is set to "", then the escaped
+string will be contained on a single line. Setting pretty to 0 effectively sets str_nl equal to "".
+
+=item no_tag_splitting
+
+Default off. If JSON is embedded in an HTML document and the JSON contains C<< <html> >>,
+C<< </html> >>, C<< <script> >>, C<< </script> >>, C<< <!-- >>, or , C<< --> >> tags, they are
+split apart with a quote, a +, and a quote. This allows the embedded tags to not affect
+the currently playing JavaScript.
+
+However, if the JSON that is output is intended for deserialization by another non-javascript-engine
+JSON parser, this splitting behavior may cause errors when the JSON is imported. To avoid the splitting
+behavior in these cases you can use the no_tag_splitting flag to turn off the behavior.
+
+ JSONDump("<html><!-- comment --><script></script></html>");
+
+ Would print
+
+ "<htm"+"l><!-"+"- comment --"+"><scrip"+"t></scrip"+"t></htm"+"l>"
+
+ With the flag
+
+ JSONDump("<html><!-- comment --><script></script></html>", {no_tag_splitting => 1});
+
+ Would print
+
+ "<html><!-- comment --><script></script></html>"
=back