glib:variant-iter-copy (iter)

iter -- a g:variant-iter instance

The new heap-allocated g:variant-iter instance.

Creates a new heap-allocated g:variant-iter instance to iterate over the container that was being iterated over by iter. Iteration begins on the new iterator from the current position of the old iterator but the two copies are independent past that point.

Use the g:variant-iter-free function to free the return value when you no longer need it.

A reference is taken to the container that iter is iterating over and will be released only when the g:variant-iter-free function is called.