xml::writer::string(3pm) [debian man page]

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)

TAP::Parser::YAMLish::Writer(3pm)			 Perl Programmers Reference Guide			 TAP::Parser::YAMLish::Writer(3pm)

NAME

       TAP::Parser::YAMLish::Writer - Write YAMLish data

VERSION

       Version 3.26

SYNOPSIS

	   use TAP::Parser::YAMLish::Writer;

	   my $data = {
	       one => 1,
	       two => 2,
	       three => [ 1, 2, 3 ],
	   };

	   my $yw = TAP::Parser::YAMLish::Writer->new;

	   # Write to an array...
	   $yw->write( $data, @some_array );

	   # ...an open file handle...
	   $yw->write( $data, $some_file_handle );

	   # ...a string ...
	   $yw->write( $data, $some_string );

	   # ...or a closure
	   $yw->write( $data, sub {
	       my $line = shift;
	       print "$line
";
	   } );

DESCRIPTION

       Encodes a scalar, hash reference or array reference as YAMLish.

METHODS

   Class Methods
       "new"

	my $writer = TAP::Parser::YAMLish::Writer->new;

       The constructor "new" creates and returns an empty "TAP::Parser::YAMLish::Writer" object.

   Instance Methods
       "write"

	$writer->write($obj, $output );

       Encode a scalar, hash reference or array reference as YAML.

	   my $writer = sub {
	       my $line = shift;
	       print SOMEFILE "$line
";
	   };

	   my $data = {
	       one => 1,
	       two => 2,
	       three => [ 1, 2, 3 ],
	   };

	   my $yw = TAP::Parser::YAMLish::Writer->new;
	   $yw->write( $data, $writer );

       The  $output  argument may be:

       o   a reference to a scalar to append YAML to

       o   the handle of an open file

       o   a reference to an array into which YAML will be pushed

       o   a code reference

       If you supply a code reference the subroutine will be called once for each line of output with the line as its only argument. Passed lines
       will have no trailing newline.

AUTHOR

       Andy Armstrong, <andy@hexten.net>

SEE ALSO

       YAML::Tiny, YAML, YAML::Syck, Config::Tiny, CSS::Tiny, <http://use.perl.org/~Alias/journal/29427>

COPYRIGHT

       Copyright 2007-2011 Andy Armstrong.

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

       The full text of the license can be found in the LICENSE file included with this module.

perl v5.18.2							    2014-01-06					 TAP::Parser::YAMLish::Writer(3pm)