cmsNextTagIteration(3)

NAME
     cmsNextTagIteration - get the next tag in a tag iteration

SYNOPSIS
     #include <cms.h>

     int32 cmsNextTagIteration (ctxt, iterator, name, type, size, data);
     CMSContext ctxt;
     CMSTagIterator iterator;
     CMSIdentifier *name;
     CMSIdentifier *type;
     uint32 *size;
     void **data;

DESCRIPTION
     cmsNextTagIteration returns the data from the next tag in a tag
     iteration. iterator is a structure used by the color management system
     (CMS) to keep track of the current iteration position.  Its contents are
     private to the CMS.  It is initialized by cmsStartTagIteration, which
     must be called prior to any calls to cmsNextTagIteration.  During the
     iteration, cmsNextTagIteration updates name, type, size, and data with
     the values from the next tag in the iteration.  cmsNextTagIteration sets
     name to NULL and returns CMS_NO_MORE_TAGS when the iteration is complete.
     Free the data by calling cmsFreeTagValue.

ERRORS
     CMS_OUT_OF_MEMORY
               There is not enough memory to retrieve the next tag.

     CMS_NO_MORE_TAGS
               There are no more tags in the profile.

SEE ALSO
     cmsStartTagIteration, cmsEndTagIteration, cmsFreeTagValue