Trait symphonia_core::io::MediaSource

pub trait MediaSource:
    Read
    + Seek
    + Send
    + Sync {
    // Required methods
    fn is_seekable(&self) -> bool;
    fn byte_len(&self) -> Option<u64>;
}

MediaSource is a composite trait of std::io::Read and std::io::Seek. A source must implement this trait to be used by MediaSourceStream.

Despite requiring the std::io::Seek trait, seeking is an optional capability that can be queried at runtime.

Required Methods

fn is_seekable(&self) -> bool

Returns if the source is seekable. This may be an expensive operation.

fn byte_len(&self) -> Option<u64>

Returns the length in bytes, if available. This may be an expensive operation.

Implementations on Foreign Types

impl MediaSource for File

fn is_seekable(&self) -> bool

Returns if the std::io::File backing the MediaSource is seekable.

Note: This operation involves querying the underlying file descriptor for information and may be moderately expensive. Therefore it is recommended to cache this value if used often.

fn byte_len(&self) -> Option<u64>

Returns the length in bytes of the std::io::File backing the MediaSource.

Note: This operation involves querying the underlying file descriptor for information and may be moderately expensive. Therefore it is recommended to cache this value if used often.

impl<T: AsRef<[u8]> + Send + Sync> MediaSource for Cursor<T>

fn is_seekable(&self) -> bool

Always returns true since a io::Cursor<u8> is always seekable.

fn byte_len(&self) -> Option<u64>

Returns the length in bytes of the io::Cursor<u8> backing the MediaSource.

Implementors

impl MediaSource for MediaSourceStream

impl<R: Read + Send + Sync> MediaSource for ReadOnlySource<R>