[][src]Function flac_sys::FLAC__metadata_object_vorbiscomment_set_vendor_string

pub unsafe extern "C" fn FLAC__metadata_object_vorbiscomment_set_vendor_string(
    object: *mut FLAC__StreamMetadata,
    entry: FLAC__StreamMetadata_VorbisComment_Entry,
    copy: FLAC__bool
) -> FLAC__bool

Sets the vendor string 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 entry The entry to set the vendor string to. \param copy See above. \assert \code object != NULL \endcode \code object->type == FLAC__METADATA_TYPE_VORBIS_COMMENT \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.