@code = jsdump('my_array', $array_ref); # Return array for formatting
$code = jsdump('my_object', $hash_ref); # Return convenient string
$html = hjsdump('my_stuff', $reference); # Convenience wrapper
Other useful values might be 0, "null", or "NaN".
EXPORTIn addition, althought the module no longer uses Exporter, it heeds its import conventions; "qw(:all"), "()", etc.
- jsdump('name', \$reference, [$undef]);
The second argument is required, a hashref or arrayref. Structures can be nested, circular referrencing is supported (experimentally).
The third argument is optional, a scalar whose value is to be used en lieu of undefined values when dumping a structure.
When called in list context, the function returns a list of lines. In scalar context, it returns a string.
- hjsdump('name', \$reference, [$undef]);
- hjsdump is identical to jsdump except that it wraps the content in script tags.
- This function escapes non-printable and Unicode characters (where possible) to promote playing nice with others.
CAVEATSPreviously, the module eval'd any data it received that looked like a number; read: real, hexadecimal, octal, or engineering notations. It now passes all non-decimal values through as strings. You will need to "eval" on the client or server side if you wish to use other notations as numbers. This is meant to protect people who store ZIP codes with leading 0's.
- Thou shalt not claim ownership of unmodified materials.
- Thou shalt not claim whole ownership of modified materials.
- Thou shalt grant the indemnity of the provider of materials.
- Thou shalt use and dispense freely without other restrictions.
Or if you truly insist, you may use and distribute this under ther terms of Perl itself (GPL and/or Artistic License).
AUTHORMaintained by Jerrad Pierce <[email protected]>