Function flac_sys::FLAC__metadata_simple_iterator_insert_block_after

pub unsafe extern "C" fn FLAC__metadata_simple_iterator_insert_block_after(
    iterator: *mut FLAC__Metadata_SimpleIterator, 
    block: *mut FLAC__StreamMetadata, 
    use_padding: FLAC__bool
) -> FLAC__bool

This is similar to FLAC__metadata_simple_iterator_set_block() except that instead of writing over an existing block, it appends a block after the existing block. \a use_padding is again used to tell the function to try an expand into following padding in an attempt to avoid rewriting the entire file.

This function will fail and return \c false if given a STREAMINFO block.

After writing the block, the iterator will be pointing to the new block.

\param iterator A pointer to an existing initialized iterator. \param block The block to set. \param use_padding See above. \assert \code iterator != NULL \endcode \a iterator has been successfully initialized with FLAC__metadata_simple_iterator_init() \code block != NULL \endcode \retval FLAC__bool \c true if successful, else \c false.