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.
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.