TypedArray

Struct TypedArray 

Source
pub struct TypedArray<T> { /* private fields */ }
Expand description

Parameterised wrapper around a JavaScript array object. No concrete JS type, but needed for WebIDL

Implementations§

Source§

impl<T> TypedArray<T>

Source

pub fn new_from_slice(slice: &[T]) -> Self
where T: Clone + Into<Val>,

Construct a new JS array from a Rust slice. Uses a single array build operation instead of repeated push calls.

Source

pub fn len(&self) -> usize

Number of elements (array.length).

Source

pub fn is_empty(&self) -> bool

True when len() == 0.

Source

pub fn push(&mut self, value: T)
where T: Into<Val>,

Push a single element to the end of the array.

Source

pub fn get(&self, idx: usize) -> Option<T>
where T: FromVal,

Return a copy of the element at idx converted to T.

Source

pub fn has(&self, val: T) -> bool
where Val: From<T>,

Returns whether a value exists in the TypedArray.

Source

pub fn set(&self, idx: usize, val: T)
where T: FromVal, Val: From<T>,

Source

pub fn to_vec(&self) -> Vec<T>
where T: FromVal,

Returns a Rust Vec from a TypedArray

Source

pub fn to_string(&self) -> JsString

Source

pub fn to_locale_string(&self) -> JsString

Source

pub fn pop(&self) -> Option<T>
where T: FromVal,

Source

pub fn concat(&self, items: &Self) -> Self

Source

pub fn join(&self, separator: &JsString) -> JsString

Source

pub fn reverse(&self) -> Self

Source

pub fn shift(&self) -> Option<T>
where T: FromVal,

Source

pub fn sort(&self, compare_fn: &Function) -> Self

Source

pub fn splice(&self, start: usize, delete_count: usize, items: &Self) -> Self

Source

pub fn unshift(&self, items: &Self) -> usize

Source

pub fn index_of(&self, search_element: &Any, from_index: Option<usize>) -> isize

Source

pub fn last_index_of( &self, search_element: &Any, from_index: Option<usize>, ) -> isize

Source

pub fn every(&self, predicate: &Function, this_arg: Option<&Any>) -> bool

Source

pub fn some(&self, predicate: &Function, this_arg: Option<&Any>) -> bool

Source

pub fn for_each(&self, callbackfn: &Function, this_arg: Option<&Any>)

Source

pub fn map( &self, callbackfn: &Function, this_arg: Option<&Any>, ) -> TypedArray<Any>

Source

pub fn filter(&self, predicate: &Function, this_arg: Option<&Any>) -> Self

Source

pub fn reduce(&self, callbackfn: &Function, initial_value: Option<&T>) -> T
where T: FromVal + Into<Val> + Clone + Default,

Source

pub fn reduce_right( &self, callbackfn: &Function, initial_value: Option<&T>, ) -> T
where T: FromVal + Into<Val> + Clone + Default,

Source

pub fn entries(&self) -> Any

Source

pub fn keys(&self) -> Any

Source

pub fn values(&self) -> Any

Source§

impl<T> TypedArray<T>
where T: FromVal,

Source

pub fn iter(&self) -> TypedArrayIter<'_, T>

Return an iterator over owned elements.

Examples found in repository?
examples/array.rs (line 12)
5fn main() {
6    emlite::init();
7    // Create a TypedArray from a Vec of Any
8    let seq = TypedArray::from(vec![Any::from(1), Any::from(2), Any::from(3)]);
9    println!("Created TypedArray: {:?}", seq);
10
11    // Access elements
12    for (i, val) in seq.iter().enumerate() {
13        println!("Element {}: {:?}", i, val);
14    }
15
16    // Convert TypedArray back to Vec<Any> (if supported by your API)
17    // let vec: Vec<Any> = seq.clone().into();
18    // println!("Converted back to Vec: {:?}", vec);
19    // If not supported, just print the sequence
20    println!("TypedArray: {:?}", seq);
21}

Methods from Deref<Target = Val>§

Source

pub fn get<T>(&self, prop: T) -> Val
where T: Into<Val>,

Gets the property prop

Source

pub fn set<K, V>(&self, prop: K, val: V)
where K: Into<Val>, V: Into<Val>,

Set the underlying js object property prop to val

Source

pub fn has<T>(&self, prop: T) -> bool
where T: Into<Val>,

Checks whether a property prop exists

Source

pub fn has_own_property(&self, prop: &str) -> bool

Checks whether a non-inherited property prop exists

Source

pub fn type_of(&self) -> String

Gets the typeof the underlying js object

Source

pub fn at<T>(&self, idx: T) -> Val
where T: Into<Val>,

Gets the element at index idx. Assumes the underlying js type is indexable

Source

pub fn to_vec<V>(&self) -> Vec<V>
where V: FromVal,

Converts the underlying js array to a Vec of V

Source

pub fn call(&self, f: &str, args: &[Val]) -> Val

Calls the method f with args, can return an undefined js value

Source

pub fn new(&self, args: &[Val]) -> Val

Calls the object’s constructor with args constructing a new object

Source

pub fn invoke(&self, args: &[Val]) -> Val

Invokes the function object with args, can return an undefined js value

Source

pub fn await_(&self) -> Val

Awaits the invoked function object

Source

pub fn instanceof(&self, v: Val) -> bool

Checks whether this Val is an instanceof v

Source

pub fn is_number(&self) -> bool

Source

pub fn is_bool(&self) -> bool

Source

pub fn is_string(&self) -> bool

Source

pub fn is_null(&self) -> bool

Source

pub fn is_undefined(&self) -> bool

Source

pub fn is_error(&self) -> bool

Source

pub fn is_function(&self) -> bool

Source

pub fn as_<T>(&self) -> T
where T: FromVal,

Examples found in repository?
examples/any.rs (line 15)
3fn main() {
4    emlite::init();
5    // Create Any from different Rust types
6    let num = Any::from(123);
7    let text = Any::from("hello");
8    let boolean = Any::from(true);
9    println!("Any from int: {:?}", num);
10    println!("Any from str: {:?}", text);
11    println!("Any from bool: {:?}", boolean);
12    Console::get().log(&[num.clone(), text.clone(), boolean.clone()]);
13
14    // Convert Any back to Rust types using as_::<T>()
15    let n: i32 = num.as_();
16    let s: Option<String> = text.as_();
17    let b: bool = boolean.as_();
18    println!("Extracted i32: {}", n);
19    println!("Extracted String: {:?}", s);
20    println!("Extracted bool: {}", b);
21}
More examples
Hide additional examples
examples/closures.rs (line 10)
4fn main() {
5    emlite::init();
6
7    // 0-arg closure returning a number
8    let c0 = Closure::bind0(|| 42);
9    let f0: Function = (&c0).into();
10    let r0 = f0.call(&Any::undefined(), &[]).unwrap().as_::<i32>();
11    Console::get().log(&[Any::from(r0)]);
12
13    // 1-arg closure: add 1
14    let c1 = Closure::bind1(|x: i32| x + 1);
15    let f1: Function = (&c1).into();
16    let r1 = f1
17        .call(&Any::undefined(), &[Any::from(9)])
18        .unwrap()
19        .as_::<i32>();
20    Console::get().log(&[Any::from(r1)]);
21
22    // 2-arg closure: sum
23    let c2 = Closure::bind2(|a: i32, b: i32| a + b);
24    let f2: Function = (&c2).into();
25    let r2 = f2
26        .call(&Any::undefined(), &[Any::from(2), Any::from(3)])
27        .unwrap()
28        .as_::<i32>();
29    Console::get().log(&[Any::from(r2)]);
30
31    // 3-arg closure: format string
32    let c3 = Closure::bind3(|a: i32, b: i32, c: i32| format!("{}-{}-{}", a, b, c));
33    let f3: Function = (&c3).into();
34    let r3 = f3
35        .call(
36            &Any::undefined(),
37            &[Any::from(1), Any::from(2), Any::from(3)],
38        )
39        .unwrap()
40        .as_::<Option<String>>()
41        .unwrap();
42    Console::get().log(&[Any::from(r3)]);
43
44    // 4-arg closure: sum of four
45    let c4 = Closure::bind4(|a: i32, b: i32, c: i32, d: i32| a + b + c + d);
46    let f4: Function = (&c4).into();
47    let r4 = f4
48        .call(
49            &Any::undefined(),
50            &[Any::from(1), Any::from(2), Any::from(3), Any::from(4)],
51        )
52        .unwrap()
53        .as_::<i32>();
54    Console::get().log(&[Any::from(r4)]);
55}
Source

pub fn to_utf16(&self) -> Option<Vec<u16>>

Extracts UTF-16 data as Option<Vec>

Source

pub fn to_utf16_result(&self) -> Result<Vec<u16>, Val>

Extracts UTF-16 data, returning error if null or if self is error

Trait Implementations§

Source§

impl<T> AsMut<Val> for TypedArray<T>

Source§

fn as_mut(&mut self) -> &mut Val

Converts this type into a mutable reference of the (usually inferred) input type.
Source§

impl<T> AsRef<Val> for TypedArray<T>

Source§

fn as_ref(&self) -> &Val

Converts this type into a shared reference of the (usually inferred) input type.
Source§

impl<T: Clone> Clone for TypedArray<T>

Source§

fn clone(&self) -> TypedArray<T>

Returns a duplicate of the value. Read more
1.0.0 · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl<T: Debug> Debug for TypedArray<T>

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl<T> Deref for TypedArray<T>

Source§

type Target = Val

The resulting type after dereferencing.
Source§

fn deref(&self) -> &Self::Target

Dereferences the value.
Source§

impl<T> DerefMut for TypedArray<T>

Source§

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.
Source§

impl<T: Clone> From<&[T]> for TypedArray<T>
where Val: From<T>,

Source§

fn from(slice: &[T]) -> Self

Converts to this type from the input type.
Source§

impl<T> From<&TypedArray<T>> for Val

Source§

fn from(x: &TypedArray<T>) -> Val

Converts to this type from the input type.
Source§

impl<T> From<TypedArray<T>> for Val

Source§

fn from(x: TypedArray<T>) -> Val

Converts to this type from the input type.
Source§

impl<T: Clone> From<Vec<T>> for TypedArray<T>
where Val: From<T>,

Source§

fn from(buf: Vec<T>) -> Self

Converts to this type from the input type.
Source§

impl<T> FromVal for TypedArray<T>

Source§

fn from_val(v: &Val) -> Self

Creates a Val object from another
Source§

fn take_ownership(v: Handle) -> Self

Takes the ownership of a handle
Source§

fn as_handle(&self) -> Handle

Returns the raw js handle
Source§

impl<'a, T> IntoIterator for &'a TypedArray<T>
where T: FromVal,

Source§

type Item = T

The type of the elements being iterated over.
Source§

type IntoIter = TypedArrayIter<'a, T>

Which kind of iterator are we turning this into?
Source§

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value. Read more
Source§

impl<T: PartialEq> PartialEq for TypedArray<T>

Source§

fn eq(&self, other: &TypedArray<T>) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl<T: PartialOrd> PartialOrd for TypedArray<T>

Source§

fn partial_cmp(&self, other: &TypedArray<T>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists. Read more
1.0.0 · Source§

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator. Read more
1.0.0 · Source§

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator. Read more
1.0.0 · Source§

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator. Read more
1.0.0 · Source§

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator. Read more
Source§

impl<T> StructuralPartialEq for TypedArray<T>

Auto Trait Implementations§

§

impl<T> Freeze for TypedArray<T>

§

impl<T> RefUnwindSafe for TypedArray<T>
where T: RefUnwindSafe,

§

impl<T> Send for TypedArray<T>
where T: Send,

§

impl<T> Sync for TypedArray<T>
where T: Sync,

§

impl<T> Unpin for TypedArray<T>
where T: Unpin,

§

impl<T> UnwindSafe for TypedArray<T>
where T: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<P, T> Receiver for P
where P: Deref<Target = T> + ?Sized, T: ?Sized,

Source§

type Target = T

🔬This is a nightly-only experimental API. (arbitrary_self_types)
The target type on which the method may be called.
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.