4 <title>libvorbis - function - vorbis_comment_query</title>
5 <link rel=stylesheet href="style.css" type="text/css">
8 <body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff">
9 <table border=0 width=100%>
11 <td><p class=tiny>libvorbis documentation</p></td>
12 <td align=right><p class=tiny>libvorbis version 1.3.2 - 20101101</p></td>
16 <h1>vorbis_comment_query</h1>
18 <p><i>declared in "vorbis/codec.h";</i></p>
20 <p>This function retrieves a comment string for a given tag in a
21 <a href="vorbis_comment.html">vorbis_comment</a> structure.</p>
23 <table border=0 color=black cellspacing=0 cellpadding=7>
27 extern char *vorbis_comment_query(vorbis_comment *vc, const char *tag, int count);
36 <dd>Pointer to the vorbis_comment structure.</dd>
38 <dd>Pointer to a null-terminated string of the comment tag to look
39 for. Tags are compared case-insensitively.</dd>
41 <dd>The index of the comment string to retrieve. A value of 0 indicates
42 the first comment whose tag matches <i>tag</i>. Use
43 <a href="vorbis_comment_query_count.html">vorbis_comment_query_count</a>
44 to determine the number of matching comments.</dd>
48 <h3>Return Values</h3>
50 <li>A pointer to the comment string. The underlying buffer is owned by
51 the vorbis_comment structure.</li>
52 <li>NULL on a nonexistent tag or if <i>count</i> is greater than or
53 equal to the number of matching comments.</li>
59 <table border=0 width=100%>
61 <td><p class=tiny>copyright © 2010 Xiph.Org</p></td>
62 <td align=right><p class=tiny><a href="https://xiph.org/vorbis/">Ogg Vorbis</a></p></td>
64 <td><p class=tiny>libvorbis documentation</p></td>
65 <td align=right><p class=tiny>libvorbis version 1.3.2 - 20101101</p></td>