[][src]Function flac_sys::FLAC__metadata_object_new

pub unsafe extern "C" fn FLAC__metadata_object_new(
    type_: FLAC__MetadataType
) -> *mut FLAC__StreamMetadata

Create a new metadata object instance of the given type.

The object will be "empty"; i.e. values and data pointers will be \c 0, with the exception of FLAC__METADATA_TYPE_VORBIS_COMMENT, which will have the vendor string set (but zero comments).

Do not pass in a value greater than or equal to \a FLAC__METADATA_TYPE_UNDEFINED unless you really know what you're doing.

\param type Type of object to create \retval FLAC__StreamMetadata* \c NULL if there was an error allocating memory or the type code is greater than FLAC__MAX_METADATA_TYPE_CODE, else the new instance.