1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

/// A trait describing a buffer that is interleaved.
///
/// This allows for accessing the raw underlying interleaved buffer.
pub trait InterleavedBuf {
    /// The type of a single sample.
    type Sample;

    /// Access the underlying raw interleaved buffer.
    ///
    /// # Examples
    ///
    /// ```
    /// use audio::InterleavedBuf;
    ///
    /// fn test(buf: impl InterleavedBuf<Sample = i16>) {
    ///     assert_eq!(buf.as_interleaved(), &[1, 1, 2, 2, 3, 3, 4, 4]);
    /// }
    ///
    /// test(audio::interleaved![[1, 2, 3, 4]; 2]);
    /// ```
    fn as_interleaved(&self) -> &[Self::Sample];
}

impl<B> InterleavedBuf for &B
where
    B: ?Sized + InterleavedBuf,
{
    type Sample = B::Sample;

    #[inline]
    fn as_interleaved(&self) -> &[Self::Sample] {
        (**self).as_interleaved()
    }
}

impl<B> InterleavedBuf for &mut B
where
    B: ?Sized + InterleavedBuf,
{
    type Sample = B::Sample;

    #[inline]
    fn as_interleaved(&self) -> &[Self::Sample] {
        (**self).as_interleaved()
    }
}