盒装数字切片:Box<[u8]>Box<[i8]>Box<[u16]>Box<[i16]>Box<[u32]>Box<[i32]>Box<[u64]>Box<[i64]>Box<[f32]>Box<[f64]>Box<[MaybeUninit<u8>]>Box<[MaybeUninit<i8>]>Box<[MaybeUninit<u16>]>Box<[MaybeUninit<i16>]>Box<[MaybeUninit<u32>]>Box<[MaybeUninit<i32>]>Box<[MaybeUninit<u64>]>Box<[MaybeUninit<i64>]>Box<[MaybeUninit<f32>]>Box<[MaybeUninit<f64>]>

T 参数 &T 参数 &mut T 参数 T 返回值 Option<T> 参数 Option<T> 返回值JavaScript 表示
相应类型的 JavaScript TypedArrayInt32ArrayUint8Array 等...)

注意: 当将盒装切片返回给 JavaScript 时,切片的内容会从 Wasm 线性内存复制到 JavaScript TypedArray 中,反之亦然,当在 Rust 中接收 JavaScript TypedArray 作为盒装切片时也是如此。

注意: 数字类型的 MaybeUninit<T> 在从 Rust 传输到 JS 以及从 JS 传输到 Rust 时,始终可以假定已初始化。但是,来自 Rust 的未初始化值可能包含未指定的值。

Rust 用法示例


# #![allow(unused_variables)]
#fn main() {
use wasm_bindgen::prelude::*;

#[wasm_bindgen]
pub fn take_boxed_number_slice_by_value(x: Box<[f64]>) {}

#[wasm_bindgen]
pub fn return_boxed_number_slice() -> Box<[u32]> {
    (0..42).collect::<Vec<u32>>().into_boxed_slice()
}

#[wasm_bindgen]
pub fn take_option_boxed_number_slice(x: Option<Box<[u8]>>) {}

#[wasm_bindgen]
pub fn return_option_boxed_number_slice() -> Option<Box<[i32]>> {
    None
}

#}

JavaScript 用法示例

import {
  take_boxed_number_slice_by_value,
  return_boxed_number_slice,
  take_option_boxed_number_slice,
  return_option_boxed_number_slice,
} from './guide_supported_types_examples';

take_boxed_number_slice_by_value(new Uint8Array(100));

let x = return_boxed_number_slice();
console.log(x instanceof Uint32Array); // true

take_option_boxed_number_slice(null);
take_option_boxed_number_slice(undefined);
take_option_boxed_number_slice(new Int16Array(256));

let y = return_option_boxed_number_slice();
if (y == null) {
  // ...
} else {
  console.log(x instanceof Int32Array); // true
}