NAME

NexTrieve::Docseq - handling a NexTrieve Document Sequence

SYNOPSIS

use NexTrieve;
$ntv = NexTrieve->new( | {method => value} );
$docseq = $ntv->Docseq( | file | xml | {method => value} );

# non-streaming mode, XML built in memory
$docseq->add( data );
$docseq->add( moredata );
$docseq->add( stillmoredata );
$docseq->write_file( filename );

#streaming-mode, XML sent to stream immediately
$docseq->stream( handle | filename );
$docseq->add( data );
$docseq->add( moredata );
$docseq->add( stillmoredata );
$docseq->done; # or let $docseq go out of scope

DESCRIPTION

The Docseq object of the Perl support for NexTrieve. Do not create directly, but through the Docseq method of the NexTrieve object.

METHODS

The following methods are available to the NexTrieve::Docseq object, apart from the ones inherited from the NexTrieve module.

stream

open( $handle,">filename" );
$docseq->stream( $handle );

$docseq->stream( filename );

add

$docseq->add( $data | \$data | [$data] | {container => $data} | $document );

done

$docseq->done # not really needed, DESTROY on object does same

AUTHOR

Elizabeth Mattijsen, <liz@nextrieve.com>.

Please report bugs to <perlbugs@nextrieve.com>.

COPYRIGHT

Copyright (c) 1995-2002 Elizabeth Mattijsen <liz@nextrieve.com>. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

http://www.nextrieve.com, the NexTrieve.pm and the other NexTrieve::xxx modules.