Chris@1: Chris@1: Chris@1: Chris@1: libvorbis - function - vorbis_comment_query Chris@1: Chris@1: Chris@1: Chris@1: Chris@1: Chris@1: Chris@1: Chris@1: Chris@1: Chris@1:

libvorbis documentation

libvorbis version 1.3.2 - 20101101

Chris@1: Chris@1:

vorbis_comment_query

Chris@1: Chris@1:

declared in "vorbis/codec.h";

Chris@1: Chris@1:

This function retrieves a comment string for a given tag in a Chris@1: vorbis_comment structure.

Chris@1: Chris@1: Chris@1: Chris@1: Chris@1: Chris@1:
Chris@1: 

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

Parameters

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

Return Values

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

    Chris@1: Chris@1:

    Chris@1:

    Chris@1: Chris@1: Chris@1: Chris@1: Chris@1: Chris@1: Chris@1: Chris@1: Chris@1:

    copyright © 2010 Xiph.Org

    Ogg Vorbis

    libvorbis documentation

    libvorbis version 1.3.2 - 20101101

    Chris@1: Chris@1: Chris@1: Chris@1: Chris@1: