#array #fixed-length #array-index #vec #index

vec-x

Provides a structure VecX to manage fixed-length arrays, supporting numeric operations and assignment operations between VecX and scalar values

9 releases (breaking)

0.8.0 Jun 27, 2024
0.7.0 May 18, 2024
0.6.0 May 17, 2024
0.5.0 May 17, 2024
0.1.1 May 9, 2024

#977 in Data structures

Download history 13/week @ 2024-08-23 9/week @ 2024-08-30 7/week @ 2024-09-13 45/week @ 2024-09-20 43/week @ 2024-09-27 13/week @ 2024-10-04 67/week @ 2024-10-11 61/week @ 2024-10-18

739 downloads per month
Used in 3 crates (2 directly)

MIT/Apache

34KB
415 lines

vec-x-rs

固定長の配列を管理するための構造体VecXを提供し、VecX同士やスカラー値との数値演算や代入演算をサポートします。

Provides a structure VecX to manage fixed-length arrays, supporting numeric operations and assignment operations between VecX and scalar values.

その他、要素の一括キャストなど、便利なメソッドも提供します。

Other useful methods, such as batch casting of elements, are also provided.

また、一意な配列にインデックスを持たせて管理する方法も提供します。

It also provides a way to manage unique arrays with indices.

使い方 (Usage)

use vec_x::{VecX, IndexedVecXs};

fn main() {

    // i32型の要素を3つ持つ配列を作成
    // Create an array with three elements of type i32
    let vec: VecX<i32, 3> = VecX::new([1, 2, 3]);
    let vec: VecX<i32, 3> = VecX::from([1, 2, 3]);
    let vec: VecX<i32, 3> = VecX::from([1; 3]);
    let vec: VecX<i32, 3> = VecX::from(1);


    // 型エイリアスを使用してインスタンスを作成
    // Create an instance using a type alias
    type XYZ = VecX<f64, 3>;
    type RGBA = VecX<u8, 4>;

    let point = XYZ::new([1., 2., 3.]);
    let red = RGBA::new([255, 0, 0, 255]);


    // 配列の要素にアクセス
    // Accessing elements of an array
    let vec = VecX::new([1, 2, 3]);

    assert_eq!(vec[0], 1);
    assert_eq!(vec[1], 2);
    assert_eq!(vec[2], 3);


    // 数値演算(+, -, *, /, %)
    // Numeric operations (+, -, *, /, %)
    let a = VecX::new([1, 2, 3]);
    let b = VecX::new([4, 5, 6]);

    assert_eq!(a + b, VecX::new([5, 7, 9]));

    // スカラーとの演算(+, -, *, /, %)
    // Operations with scalars (+, -, *, /, %)
    let a = VecX::new([1, 2, 3]);

    assert_eq!(a + 1, VecX::new([2, 3, 4]));


    // 代入演算(+, -, *, /, %)
    // Assignment operations (+, -, *, /, %)
    let mut a = VecX::new([1, 2, 3]);

    a += VecX::new([4, 5, 6]);

    assert_eq!(a, VecX::new([5, 7, 9]));

    // スカラーとの代入演算(+, -, *, /, %)
    // Assignment operations with scalars (+, -, *, /, %)
    let mut a = VecX::new([1, 2, 3]);

    a += 1;

    assert_eq!(a, VecX::new([2, 3, 4]));

    // 比較
    // Comparison
    let vec1 = VecX::new([1, 2, 3]);
    let vec2 = VecX::new([1, 2, 3]);
    assert_eq!(vec1, vec2);
    assert!(vec1 <= vec2);
    assert!(vec1 >= vec2);

    let vec1 = VecX::new([1, 2, 3]);
    let vec2 = VecX::new([4, 5, 6]);
    assert!(vec1 < vec2);

    let vec1 = VecX::new([1, 2, 3]);
    let vec2 = VecX::new([1, 2, 2]);
    assert_ne!(vec1, vec2);
    assert!(vec1 > vec2);

    // 要素のキャスト
    // Element casting
    let vec = VecX::new([1, 2, 3]);
    let vec_f64: VecX<f64, 3> = vec.as_();


    // インデックスでの管理
    // Management by index
    type RGB = VecX<u8, 3>;

    let unique_colors = vec![
        RGB::new([255, 0, 0]),
        RGB::new([0, 255, 0]),
        RGB::new([0, 0, 255]),
    ];

    let colors = vec![
        unique_colors[0], // VecX: [255, 0, 0]
        unique_colors[1], // VecX: [0, 255, 0]
        unique_colors[1], // VecX: [0, 255, 0]
        unique_colors[0], // VecX: [255, 0, 0]
        unique_colors[2], // VecX: [0, 0, 255]
        unique_colors[2], // VecX: [0, 0, 255]
    ];

    let indexed_colors = IndexedVecXs::from_vec(colors);

    let IndexedVecXs { values, indices } = indexed_colors;


    // 元データの一意な要素の出現順にインデックスされる
    // Indexed in the order of appearance of unique elements in the original data
    assert_eq!(values[0], unique_colors[0]);
    assert_eq!(values[1], unique_colors[1]);
    assert_eq!(values[2], unique_colors[2]);

    assert_eq!(indices, vec![0, 1, 1, 0, 2, 2]);
}

ライセンス (License)

Licensed under either of

at your option.

(The English in the README and comments in the source code were translated by DeepL.)

Dependencies

~1.5MB
~26K SLoC