bidivec

提供二维数组、向量和切片的库，包含电池。该库力求尽可能通用，然后进行合理的优化。

特性

该库通过宏、迭代器和索引的组合，以简单易用的方式支持二维容器。

例如

use bidivec::*;

// Create a new BidiVec<i32> using a macro
let mut bvec = bidivec!{
    [1, 2, 3],
    [4, 5, 6],
    [7, 8, 9],
};

// Overwrite cell (1,1) - the 5 - with 7+8
bvec[(1, 1)] = bvec[(0, 2)] + bvec[(1, 2)];

assert_eq!(bvec, bidivec!{
    [1, 2, 3],
    [4, 15, 6],
    [7, 8, 9]
});

// Using iterators, collect the items in a vec
let v = bvec.iter().copied().collect::<Vec<i32>>();

// Assert the result is the expected one
assert_eq!(v, vec![1, 2, 3, 4, 15, 6, 7, 8, 9]);

// Change the sign of all items in the 2x2 rect located at (1,1)
for item in bvec
    .iter_mut()
    .on_rect(&BidiRect::new(1, 1, 2, 2,))
{
    *item = -(*item);
}

assert_eq!(bvec, bidivec!{
    [1, 2, 3],
    [4, -15, -6],
    [7, -8, -9]
});

数据结构

所有数据结构都提供（如果适用）迭代器支持、快速随机访问任何特定二维位置、插入和删除列和行、旋转、转置和裁剪。

支持的数据结构包括

• BidiVec：在 Vec<T> 上实现的二维包装器，以保持线性布局以实现与本地代码的最佳互操作性。可以使用 bidivec! 宏构建。
• BidiArray：在 Box<[T]> 上实现的二维包装器，也保持线性布局以实现与本地代码的最佳互操作性，并且保持固定长度（但宽度和高度可能变化）。可以使用 bidiarray! 宏构建。
• BidiGrowVec：在 Vec<Vec<T>> 上实现的二维包装器，牺牲内存布局和局部性以在集合中间插入时提供更好的性能。可以使用 bidigrowvec! 宏构建。
• BidiMutSlice：在 &mut [T] 切片上实现的二维包装器，牺牲一些功能以支持外部提供的数据存储，包括就地转换。
• BidiSlice：在&[T]切片上实现的双向包装器，具有与之前相同的注意事项，但不可变。