cannam@86: cannam@86: cannam@86: cannam@86: libvorbis - function - vorbis_comment_query cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86:

libvorbis documentation

libvorbis version 1.3.2 - 20101101

cannam@86: cannam@86:

vorbis_comment_query

cannam@86: cannam@86:

declared in "vorbis/codec.h";

cannam@86: cannam@86:

This function retrieves a comment string for a given tag in a cannam@86: vorbis_comment structure.

cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86:
cannam@86: 

cannam@86: extern char    *vorbis_comment_query(vorbis_comment *vc, const char *tag, int count);
cannam@86:
cannam@86:
cannam@86: cannam@86:

Parameters

cannam@86:
cannam@86:
vc
cannam@86:
Pointer to the vorbis_comment structure.
cannam@86:
tag
cannam@86:
Pointer to a null-terminated string of the comment tag to look cannam@86: for. Tags are compared case-insensitively.
cannam@86:
count
cannam@86:
The index of the comment string to retrieve. A value of 0 indicates cannam@86: the first comment whose tag matches tag. Use cannam@86: vorbis_comment_query_count cannam@86: to determine the number of matching comments.
cannam@86:
cannam@86: cannam@86: cannam@86:

Return Values

cannam@86:
cannam@86:
  • A pointer to the comment string. The underlying buffer is owned by cannam@86: the vorbis_comment structure.
    • cannam@86:
  • NULL on a nonexistent tag or if count is greater than or cannam@86: equal to the number of matching comments.
    • cannam@86:
    cannam@86:

    cannam@86: cannam@86:

    cannam@86:

    cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: cannam@86:

    copyright © 2010 Xiph.Org

    Ogg Vorbis

    libvorbis documentation

    libvorbis version 1.3.2 - 20101101

    cannam@86: cannam@86: cannam@86: cannam@86: cannam@86: