Positions a music event iterator at the next event on a music track.
- iOS 5.0+
- macOS 10.0+
- Mac Catalyst 13.0+
- tvOS 9.0+
The music event iterator to reposition.
A result code.
Use this function to increment the position of a music event iterator forward through a music track’s events.
If an iterator is at the final event of a track when you call this function, the iterator then moves beyond the final event. You can detect if the iterator is beyond the final event by calling the
The following code snippet illustrates how to use a music event iterator to proceed forward along a music track, from the start: