From: Grant M. <gr...@us...> - 2002-12-08 02:35:09
|
Update of /cvsroot/perl-xml/xml-simple/lib/XML In directory sc8-pr-cvs1:/tmp/cvs-serv27849/lib/XML Modified Files: Simple.pm Log Message: - POD updates (documented suppressempty for XMLout) Index: Simple.pm =================================================================== RCS file: /cvsroot/perl-xml/xml-simple/lib/XML/Simple.pm,v retrieving revision 1.4 retrieving revision 1.5 diff -u -d -r1.4 -r1.5 --- Simple.pm 17 Oct 2002 08:56:18 -0000 1.4 +++ Simple.pm 8 Dec 2002 02:35:05 -0000 1.5 @@ -24,11 +24,13 @@ my $xml = $xs->XMLout($hashref [, <options>]); -Or to catch common errors: +(or see L<"SAX SUPPORT"> for 'the SAX way'). + +To catch common errors: use XML::Simple qw(:strict); -(or see L<"SAX SUPPORT"> for 'the SAX way'). +(see L<"STRICT MODE"> for more details). =cut @@ -1951,7 +1953,7 @@ will contain only the directory in which the script itself is located. Otherwise the default searchpath will be empty. -=item suppressempty => 1 | '' | undef (B<in>) (B<handy>) +=item suppressempty => 1 | '' | undef (B<in> + B<out>) (B<handy>) This option controls what C<XMLin()> should do with empty elements (no attributes and no content). The default behaviour is to represent them as @@ -1960,6 +1962,10 @@ string will cause empty elements to be represented as the undefined value or the empty string respectively. The latter two alternatives are a little easier to test for in your code than a hash with no keys. + +The option also controls what C<XMLout()> does with undefined values. +Setting the option to undef causes undefined values to be output as +empty elements (rather than empty attributes). =item xmldecl => 1 or xmldecl => 'string' (B<out>) (B<handy>) |