[][src]Function flac_sys::FLAC__metadata_object_vorbiscomment_resize_comments

pub unsafe extern "C" fn FLAC__metadata_object_vorbiscomment_resize_comments(
    object: *mut FLAC__StreamMetadata,
    new_num_comments: c_uint
) -> FLAC__bool

Resize the comment array.

If the size shrinks, elements will truncated; if it grows, new empty fields will be added to the end.

\param object A pointer to an existing VORBIS_COMMENT object. \param new_num_comments The desired length of the array; may be \c 0. \assert \code object != NULL \endcode \code object->type == FLAC__METADATA_TYPE_VORBIS_COMMENT \endcode \code (object->data.vorbis_comment.comments == NULL && object->data.vorbis_comment.num_comments == 0) || (object->data.vorbis_comment.comments != NULL && object->data.vorbis_comment.num_comments > 0) \endcode \retval FLAC__bool \c false if memory allocation fails, else \c true.