debian man page for xml::writer::string

String(3pm)						User Contributed Perl Documentation					       String(3pm)

NAME
       XML::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 STDOUT) 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.

METHODS
       XML::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 output 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.14.2							    2002-03-06							       String(3pm)