Iterator.next

Get the next item from the iterator in elem.

Only when this function returns gst.types.IteratorResult.Ok, elem will contain a valid value. elem must have been initialized to the type of the iterator or initialized to zeroes with gobject.value.Value.unset. The caller is responsible for unsetting or resetting elem with gobject.value.Value.unset or gobject.value.Value.reset after usage.

When this function returns gst.types.IteratorResult.Done, no more elements can be retrieved from it.

A return value of gst.types.IteratorResult.Resync indicates that the element list was concurrently updated. The user of it should call gst.iterator.Iterator.resync to get the newly updated list.

A return value of gst.types.IteratorResult.Error indicates an unrecoverable fatal error.

Parameters

elem gobject.value.Value

pointer to hold next element

Return Value

Type: gst.types.IteratorResult

The result of the iteration. Unset elem after usage.

MT safe.