SYNOPSIS

foreach ($bin -> iterate_elements()) {
  do_something($_);
}

my $iter = $bin -> iterate_elements();
while ($_ = $iter -> next()) {
  do_something($_);
}

DESCRIPTION

There are two ways to use a GStreamer::Iterator. The first is to use normal Perl looping stuff:

foreach ($bin -> iterate_elements()) {
  do_something($_);
}

This is very elegant and Perl-ish, but may also be a bit slower.

The alternative is to use the next method:

my $iter = $bin -> iterate_elements();
while ($_ = $iter -> next()) {
  do_something($_);
}

This is hardly beautiful but avoids looping over the elements unnecessarily and is thus faster.