每个结构都可以转换为另一个语义上相似的具有不同布局的结构，但只有相同的布局时才能进行重新解释。因此，实现了几个特质。

• *NominalInterface - 接口，暴露转换和访问元素的功能。
• *BasicInterface - 接口，扩展 X2NominalInterface 并暴露创建此类新实例的功能。
• *CanonicalInterface - 接口，扩展 X2BasicInterface 并暴露重新解释的功能。

关系：Canonical > Basic > Nominal。

示例 :: 元素

向量的元素数量编码在类型名称中，长度为 X2 的向量，长度为 2 的 X3 的向量，以此类推。每个结构都实现了构造函数 make()，make_nan() 和 make_default()，以构造该类型的新实例。要访问元素，请使用方法 x()，y()，z() 或 _0()，_1()，_2()。

#[ cfg( feature = "use_std" ) ]
{
  use math_adapter::prelude::*;
  use math_adapter::X2;

  // vector of length 2 and its elements
  let src1 = X2::make( 1, 3 );
  assert_eq!( src1.x(), 1 );
  assert_eq!( src1.y(), 3 );
  assert_eq!( src1._0(), 1 );
  assert_eq!( src1._1(), 3 );
}

示例 :: 运算符

选择一个功能 *_ops 以重用选择数学库的运算符和函数。

#[ cfg( feature = "use_std" ) ]
{
  use math_adapter::prelude::*;
  use math_adapter::X2;

  // if back-end math lib is chosen then operators and functions are available
  #[ cfg( feature = "cgmath_ops" ) ]
  {
    let src1 = X2::make( 1, 2 );
    let src2 = X2::make( 3, 4 );
    let got = src1 + src2;
    let exp = X2::make( 4, 6 );
    assert_eq!( got, exp );
    println!( "src1 + src2 : {:?}", got );
  }

  // enable feature *_ops to get access to functions
  #[ cfg( feature = "cgmath_ops" ) ]
  {
    let src = X2::make( 1, 2 );
    assert_eq!( src.sum(), 3 ); /* sum comes from `cgmath` */
    println!( "src.sum() : {:?}", src.sum() );
  }
}

示例 :: 互操作性

功能 *_ops 意味着请求使用选择数学库的运算符和函数。但不是选择单个后端数学库，您可以使用多个。使用方法 as_*_clone()，as_*，as_*_mut 将原始数学对象转换或重新解释为所选后端的对等物。您不必在每个调用中使用相同的后端，您可以针对特定调用选择数学库，并结合每个数学库的最佳之处。

#[ cfg( feature = "use_std" ) ]
{
  use math_adapter::prelude::*;
  use math_adapter::X2;

  // ! compile-time error, because if no `*_ops` feature was chosen
  // {
  //   let src = X2::make( 1, 3 ); /* make a canonical 2D vector */
  //   println!( "src.sum() : {:?}", src.sum() ); /* use `sum()` of chosen math lib back-end */
  // }

  // enable feature *_ops should be enabled to get access to functions
  #[ cfg( all( feature = "cgmath", feature = "nalgebra" ) ) ]
  {
    let src = X2::make( 1, 3 ); /* make a canonical 2D vector */
    println!( "src.as_cgmath().sum() : {:?}", src.as_cgmath().sum() ); /* use `sum()` of `cgmath` */
    println!( "src.as_nalgebra().sum() : {:?}", src.as_nalgebra().sum() ); /* use `sum()` of `nalgebra` */
  }

  // you can convert / reinterpret any vector.
  // for example you can create `cgmath::Vector2`, but apply a function of `nalgebra::Vector2`
  #[ cfg( all( feature = "cgmath", feature = "nalgebra" ) ) ]
  {
    let src = math_adapter::cgmath::Vector2::< i32 >::make( 1, 3 ); /* make a `cgmath` 2D vector */
    println!( "src.as_nalgebra().sum() : {:?}", src.as_nalgebra().sum() ); /* use `sum()` of `nalgebra` */
  }
}

添加到您的项目

cargo add math_adapter

从存储库尝试

git clone https://github.com/Wandalen/wMath
cd wMath
cd module/math_adapter/sample/rust/math_adapter_trivial_sample
cargo run