Function read_float_array_from

src/functions/array.rs:117–145

Reads a named array from pd to a mutable slice of `f32`. Reads values as much as `source_read_amount` from the array which is specified with the `source_name` argument starting from `source_read_offset` and writes them to `destination`. # Example ```no_run use libpd_rs::functions::array::read_float_array_from; let mut destination = [0.0_f32; 64]; read_float_array_from("my_array", 32, 32, &mut d

(
    source_name: T,
    source_read_offset: i32,
    source_read_amount: i32,
    destination: &mut [f32],
)

/// - [`FailedToFindArray`](crate::error::ArrayError::FailedToFindArray)
/// - [`StringConversion`](crate::error::ArrayError::StringConversion)
pub fn read_float_array_from<T: AsRef<str>>(
    source_name: T,
    source_read_offset: i32,
    source_read_amount: i32,
    destination: &mut [f32],
) -> Result<(), ArrayError> {
    unsafe {
        let name = CString::new(source_name.as_ref()).map_err(StringConversionError::from)?;
        // Returns 0 on success or a negative error code if the array is non-existent
        // or offset + n exceeds range of array

        if source_read_offset + source_read_amount
            > array_size(source_name.as_ref()).map_err(|_| ArrayError::FailedToFindArray)?
            || source_read_amount < 0
        {
            return Err(ArrayError::OutOfBounds);
        }

        match libpd_sys::libpd_read_array(
            destination.as_mut_ptr(),
            name.as_ptr(),
            source_read_offset,
            source_read_amount,
        ) {
            0 => Ok(()),
            _ => Err(ArrayError::FailedToFindArray),
        }
    }
}

/// Writes a slice of `f32` to a pd named array.
///