Struct String 

pub struct String<A: IVm>(/* private fields */);

use nanvm_lib::{
    vm::{String, IVm, Any, ToString, ToAny},
    common::sized_index::SizedIndex,
    naive::Naive,
};
fn string_test<A: IVm>() {
    let a: String<A> = "Hello, world!".into();
    assert_eq!(a.length(), 13);
    assert_eq!(a[12], '!' as u16);
    let b: String<A> = ['H' as u16, 'i' as u16, '!' as u16].to_string();
    let c = a.clone() + b;
    let ac: Any<A> = c.to_any();
    let d: String<A> = ac.try_into().unwrap();
    assert_eq!(d.length(), 16);
    assert_eq!(format!("{d:?}"), r#""Hello, world!Hi!""#);
    assert_eq!(char::decode_utf16(d.clone()).map(Result::unwrap).collect::<std::string::String>(), "Hello, world!Hi!");
    let n = "Hello, world!Hi!".into();
    assert_eq!(d, n);
    assert_eq!(d, d);
    assert_ne!(d, a);
}

string_test::<Naive>();

Implementations

impl<A: IVm> String<A>

pub fn from_char_code(args: Array<A>) -> Result<Self, Any<A>>

String.fromCharCode(...args): ToUint16 of each argument, in order. Code units are preserved, including unpaired surrogates.

Trait Implementations

impl<A: IVm> Add for String<A>

type Output = String<A>

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self::Output

Performs the + operation.

impl<A: IVm> AddAssign for String<A>

fn add_assign(&mut self, other: Self)

Performs the += operation.

impl<A: Clone + IVm> Clone for String<A>

where A::InternalString: Clone,

fn clone(&self) -> String<A>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<A: IVm> Debug for String<A>

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

Formats the value using the given formatter.

impl<A: IVm> Default for String<A>

fn default() -> Self

Returns the “default value” for a type.

impl<A: IVm> Eq for String<A>

impl<A: IVm> From<&str> for String<A>

fn from(value: &str) -> Self

Converts to this type from the input type.

impl<A: IVm> From<String<A>> for Unpacked<A>

fn from(value: String<A>) -> Self

Converts to this type from the input type.

impl<A: IVm> From<String<A>> for String

Lossy: a lone surrogate, which a JavaScript string may hold and a Rust string cannot, becomes U+FFFD. Use char::decode_utf16 directly where a lone surrogate must be told apart from a real U+FFFD.

fn from(value: String<A>) -> Self

Converts to this type from the input type.

impl<A: IVm> Index<u32> for String<A>

fn index(&self, index: u32) -> &Self::Output

Currently panics if out of bounds. TODO: Future versions may change to return Result<u16, Any<A>>. Also we can implement Index<Any<A>>, Index<f64> and Index<String16>.

type Output = u16

The returned type after indexing.

impl<A: IVm> IntoIterator for String<A>

type Item = u16

The type of the elements being iterated over.

type IntoIter = IndexIter<u32, String<A>>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<A: IVm> Ord for String<A>

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<A: IVm> PartialEq for String<A>

fn eq(&self, other: &Self) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<A: IVm> PartialOrd for String<A>

Lexicographic order by UTF-16 code unit — String::lessThan, the rule < uses when both operands are strings. Not codepoint-aware: a surrogate pair is compared unit by unit, the same as any other pair of code units, never combined into one codepoint first.

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

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl<A: IVm> TryFrom<Any<A>> for String<A>

type Error = Any<A>

The type returned in the event of a conversion error.

fn try_from(value: Any<A>) -> Result<Self, Self::Error>

Performs the conversion.