Function flac_sys::FLAC__metadata_object_vorbiscomment_entry_from_name_value_pair

pub unsafe extern "C" fn FLAC__metadata_object_vorbiscomment_entry_from_name_value_pair(
    entry: *mut FLAC__StreamMetadata_VorbisComment_Entry, 
    field_name: *const c_char, 
    field_value: *const c_char
) -> FLAC__bool

Creates a Vorbis comment entry from NUL-terminated name and value strings.

On return, the filled-in \a entry->entry pointer will point to malloc()ed memory and shall be owned by the caller. For convenience the entry will have a terminating NUL.

\param entry A pointer to a Vorbis comment entry. The entry's \c entry pointer should not point to allocated memory as it will be overwritten. \param field_name The field name in ASCII, \c NUL terminated. \param field_value The field value in UTF-8, \c NUL terminated. \assert \code entry != NULL \endcode \code field_name != NULL \endcode \code field_value != NULL \endcode \retval FLAC__bool \c false if malloc() fails, or if \a field_name or \a field_value does not comply with the Vorbis comment specification, else \c true.