tags


NAME

tags - tag creation and navigation routines


SYNOPSIS

Tag Creation

.

Tag Navigation

.


NIFFIOTagCreate

Start a new tag in a NIFF file.

RIFFIOSuccess NIFFIOTagCreate(NIFFIOFile *pnf, NIFFIOTag *ptag)

ENTRY

.

EXIT

.

OBLIGATIONS

NIFFIOTagFinalize() must eventually be called with <*ptag> to finish writing the tag. If NIFFIOTagFinalize() determines that <ptag->tagsizeData> is correct then it will not seek back in the file to correct it.


NIFFIOTagFinalize

Finish writing a tag to a NIFFIOFile.

RIFFIOSuccess NIFFIOTagFinalize(NIFFIOFile *pnf, NIFFIOTag *ptag)

ENTRY

T <*ptag> must be the result of a call to NIFFIOTagCreate.

EXIT

.

ERRORS

On failure, the file position is undefined.


NIFFIOTagDescend

Read a tag header from a RIFF file.

RIFFIOSuccess NIFFIOTagDescend(NIFFIOFile *pnf, NIFFIOTag *ptag)

ENTRY

The file must be positioned at the start of a tag.

EXIT

.


NIFFIOTagAscend

Position a NIFFIOFile after a specified tag.

RIFFIOSuccess NIFFIOTagAscend(NIFFIOFile *pnf, NIFFIOTag *ptag)

ENTRY

T <*ptag> was returned by NIFFIOTagDescend.

EXIT

T <*pnf> is postioned at the end of <*ptag>

ERRORS

On failure, the file position is undefined.