cmsNextTagIteration(3) CMS 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
Page 1
