NAME

Net::Gnip::BaseStream - represent a list of Gnip objects

SYNOPIS

    # Create a new stream    
    my $stream = Net::Gnip::BaseStream->new();

    # ... or parse from XML
    my $stream = Net::Gnip::BaseStream->parse($xml);

    # assume that the subclass of BaseStream 
    # has children named foo

    # set the foos
    $stream->foos(@foos);
    
    # get the filters 
    my @foos = $stream->foos;

    # or use an iterator
    while (my $foo = $stream->next) {
        print $foo->name;
    }

    $stream->reset;

    # ... now you can use it again
    while (my $foo = $stream->foo) {
        print $foo->name;
    }

METHODS

new

Create a new, empty stream

children [child[ren]]

Get or set the children

parse <xml>

Takes a string of XML, parses it and returns a new, potentially populated FilterStream

next

Returns the next Child object

reset

Resets the iterator

as_xml

Return this stream as xml