For convenience, a trailing NUL is added to the entry if it doesn't have
one already.
If \a copy is \c true, a copy of the entry is stored; otherwise, the object
takes ownership of the \c entry.entry pointer.
\note If this function returns \c false, the caller still owns the
pointer.
\param object A pointer to an existing VORBIS_COMMENT object.
\param comment_num Index into comment array to set.
\param entry The entry to set the comment to.
\param copy See above.
\assert
\code object != NULL \endcode
\code object->type == FLAC__METADATA_TYPE_VORBIS_COMMENT \endcode
\code comment_num < object->data.vorbis_comment.num_comments \endcode
\code (entry.entry != NULL && entry.length > 0) ||
(entry.entry == NULL && entry.length == 0) \endcode
\retval FLAC__bool
\c false if memory allocation fails or \a entry does not comply with the
Vorbis comment specification, else \c true.
Sets a comment in a VORBIS_COMMENT block.
For convenience, a trailing NUL is added to the entry if it doesn't have one already.
If \a copy is \c true, a copy of the entry is stored; otherwise, the object takes ownership of the \c entry.entry pointer.
\note If this function returns \c false, the caller still owns the pointer.
\param object A pointer to an existing VORBIS_COMMENT object. \param comment_num Index into comment array to set. \param entry The entry to set the comment to. \param copy See above. \assert \code object != NULL \endcode \code object->type == FLAC__METADATA_TYPE_VORBIS_COMMENT \endcode \code comment_num < object->data.vorbis_comment.num_comments \endcode \code (entry.entry != NULL && entry.length > 0) || (entry.entry == NULL && entry.length == 0) \endcode \retval FLAC__bool \c false if memory allocation fails or \a entry does not comply with the Vorbis comment specification, else \c true.