<html> <head> <title>libvorbis - function - vorbis_comment_add_tag</title> <link rel=stylesheet href="style.css" type="text/css"> </head> <body bgcolor=white text=black link="#5555ff" alink="#5555ff" vlink="#5555ff"> <table border=0 width=100%> <tr> <td><p class=tiny>libvorbis documentation</p></td> <td align=right><p class=tiny>libvorbis version 1.3.2 - 20101101</p></td> </tr> </table> <h1>vorbis_comment_add_tag</h1> <p><i>declared in "vorbis/codec.h";</i></p> <p>This function adds a tag-comment pair to a <a href="vorbis_comment.html">vorbis_comment</a> structure. There can be more than one comment value for the same tag; if a comment with the same tag already exists, another comment with the same tag is added.</p> <p>If you already have a string in the form "KEY=value", see <a href="vorbis_comment_add.html">vorbis_comment_add</a> instead.</p> <table border=0 color=black cellspacing=0 cellpadding=7> <tr bgcolor=#cccccc> <td> <pre><b> extern void vorbis_comment_add_tag(vorbis_comment *vc, const char *tag, const char *contents); </b></pre> </td> </tr> </table> <h3>Parameters</h3> <dl> <dt><i>vc</i></dt> <dd>Pointer to a vorbis_comment structure to add the comment to.</dd> <dt><i>tag</i></dt> <dd>Pointer to the null-terminated tag string. The string will be copied, so it can be freed or modified after this function returns without affecting the vorbis_comment structure's contents.</dd> <dt><i>contents</i></dt> <dd>Pointer to the null-terminated comment contents string. This will also be copied.</dd> </dl> <h3>Return Values</h3> <blockquote> <li>None.</li> </blockquote> <p> <br><br> <hr noshade> <table border=0 width=100%> <tr valign=top> <td><p class=tiny>copyright © 2010 Xiph.Org</p></td> <td align=right><p class=tiny><a href="http://www.xiph.org/ogg/vorbis/index.html">Ogg Vorbis</a></p></td> </tr><tr> <td><p class=tiny>libvorbis documentation</p></td> <td align=right><p class=tiny>libvorbis version 1.3.2 - 20101101</p></td> </tr> </table> </body> </html>