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.