NAME

BW::XML::Out - Simple XML output

SYNOPSIS

use BW::XML::Out;
my $errstr;

my $x = BW::XML::Out->new;
error($errstr) if (($errstr = $x->error));

METHODS

new

Constructs a new object . . .

element( element, content, options )

Returns an XML element. Can be a start-tag, an end-tag, an empty tag, or a container with or without content.

Returns a string with the XML element. Sets the error string (and returns FAILURE) if there's a problem.

Possible options include:

startTag -- A start-tag, has no content.

endTag -- An end-tag, has no content;

xmlContent -- Do not escape the content;

emptyTag -- An empty tag, has not content, formatted like:

<element />

attribs -- An array ref of hash refs, like this:

$out = $x->('element', undef, {
  startTag => TRUE,
  attribs => [
   { Att1 => 'one' },
   { Att2 => 'two }
  ]
} );

... will return this:

<element Att1="one" Att2="two">

indent_mul

Setter-getter for the indent_mul property.

indent_level

Setter-getter for the indent_level property.

error

Returns and clears the object error message.

AUTHOR

Written by Bill Weinman <http://bw.org/>.

COPYRIGHT

Copyright (c) 1995-2010 The BearHeart Group, LLC

HISTORY

2010-03-11 bw 1.6.0 -- released to CPAN as part of BW-Lib
2009-11-04 bw 1.5   -- documentation update - option xmlContent
2008-04-23 bw 1.4   -- added noNewline option
2008-03-30 bw 1.3   -- added some options to element
2008-03-26 bw 1.2   -- miscellaneous cleanup
2007-08-13 bw 1.1   -- fixed a zero-vs-defined bug
2007-07-20 bw 1.0   -- initial release as a BW::* module