[][src]Function flac_sys::FLAC__metadata_chain_write_with_callbacks

pub unsafe extern "C" fn FLAC__metadata_chain_write_with_callbacks(
    chain: *mut FLAC__Metadata_Chain,
    use_padding: FLAC__bool,
    handle: FLAC__IOHandle,
    callbacks: FLAC__IOCallbacks
) -> FLAC__bool

Write all metadata out to a FLAC stream via callbacks.

(See FLAC__metadata_chain_write() for the details on how padding is used to write metadata in place if possible.)

The \a handle must be open for updating and be seekable. The equivalent minimum stdio fopen() file mode is \c "r+" (or \c "r+b" for Windows).

For this write function to be used, the chain must have been read with FLAC__metadata_chain_read_with_callbacks()/FLAC__metadata_chain_read_ogg_with_callbacks(), not FLAC__metadata_chain_read()/FLAC__metadata_chain_read_ogg(). Also, FLAC__metadata_chain_check_if_tempfile_needed() must have returned \c false.

\param chain A pointer to an existing chain. \param use_padding See FLAC__metadata_chain_write() \param handle The I/O handle of the FLAC stream to write. The handle will NOT be closed after the metadata is written; that is the duty of the caller. \param callbacks A set of callbacks to use for I/O. The mandatory callbacks are \a write and \a seek. \assert \code chain != NULL \endcode \retval FLAC__bool \c true if the write succeeded, else \c false. On failure, check the status with FLAC__metadata_chain_status().