String(3) User Contributed Perl Documentation String(3)NAMEXML::Writer::String - Capture output from XML::Writer.
SYNOPSIS
use XML::Writer;
use XML::Writer::String;
my $s = XML::Writer::String->new();
my $writer = new XML::Writer( OUTPUT => $s );
$writer->xmlDecl();
$writer->startTag('root');
$writer->endTag();
$writer->end();
print $s->value();
DESCRIPTION
This module implements a bare-bones class specifically for the purpose
of capturing data from the XML::Writer module. XML::Writer expects an
IO::Handle object and writes XML data to the specified object (or STD-
OUT) via it's print() method. This module simulates such an object for
the specific purpose of providing the required print() method.
It is recommended that $writer->end() is called prior to calling
$s->value() to check for well-formedness.
METHODSXML::Writer::String provides three methods, "new()", "print()" and
"value()":
"$s = XML::Writer::String-"new([list]);>
new() returns a new String handle.
"$count = $s-"print([list]);>
print() appends concatenated list data and returns number of items
in list.
"$val = $s-"value([list]);>
value() returns the current content of the object as a scalar. It
can also be used to initialize/overwrite the current content with
concatenated list data.
NOTES
This module is designed for the specific purpose of capturing the out-
put of XML::Writer objects, as described in this document. It does not
inherit form IO::Handle. For an alternative solution look at
IO::Scalar, IO::Lines, IO::String or Tie::Handle::Scalar.
AUTHOR
Simon Oliver <simon.oliver@umist.ac.uk>
COPYRIGHT
Copyright (C) 2002 Simon Oliver
This library is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
SEE ALSO
XML::Writer, IO::Handle, IO::Scalar
perl v5.8.8 2002-03-06 String(3)
