Struct JSInternedStrRef 

pub struct JSInternedStrRef<'a, 'b> { /* private fields */ }

A double reference to an interned string inside Interner.

JSInternedStrRef::utf8 returns an Option, since not every UTF-16 string is fully representable as a UTF-8 string (because of unpaired surrogates). However, every UTF-8 string is representable as a UTF-16 string, so JSInternedStrRef::utf8 returns a &[u16].

Implementations

impl<'a, 'b> JSInternedStrRef<'a, 'b>

pub const fn utf8(&self) -> Option<&'a str>

Returns the inner reference to the interned string in UTF-8 encoding. if the string is not representable in UTF-8, returns None

pub const fn utf16(&self) -> &'b [u16]

Returns the inner reference to the interned string in UTF-16 encoding.

pub fn join<F, G, T>(self, f: F, g: G, prioritize_utf8: bool) -> T

where F: FnOnce(&'a str) -> T, G: FnOnce(&'b [u16]) -> T,

Joins the result of both possible strings into a common type.

If self is representable by a UTF-8 string and the prioritize_utf8 argument is set, it will prioritize calling f, and will only call g if self is only representable by a UTF-16 string. Otherwise, it will directly call g.

pub fn join_with_context<C, F, G, T>( self, f: F, g: G, ctx: C, prioritize_utf8: bool, ) -> T

where F: FnOnce(&'a str, C) -> T, G: FnOnce(&'b [u16], C) -> T,

Same as join, but where you can pass an additional context.

Useful when you have a &mut Context context that cannot be borrowed by both closures at the same time.

pub fn into_common<C>(self, prioritize_utf8: bool) -> C

where C: From<&'a str> + From<&'b [u16]>,

Converts both string types into a common type C.

If self is representable by a UTF-8 string and the prioritize_utf8 argument is set, it will prioritize converting its UTF-8 representation first, and will only convert its UTF-16 representation if it is only representable by a UTF-16 string. Otherwise, it will directly convert its UTF-16 representation.

Trait Implementations

impl<'a, 'b> Clone for JSInternedStrRef<'a, 'b>

fn clone(&self) -> JSInternedStrRef<'a, 'b>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a, 'b> Copy for JSInternedStrRef<'a, 'b>

impl<'a, 'b> Debug for JSInternedStrRef<'a, 'b>

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

Formats the value using the given formatter.

impl Display for JSInternedStrRef<'_, '_>

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

Formats the value using the given formatter.

impl<'a, 'b> Eq for JSInternedStrRef<'a, 'b>

impl<'a, 'b> Hash for JSInternedStrRef<'a, 'b>

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'a, 'b> PartialEq for JSInternedStrRef<'a, 'b>

fn eq(&self, other: &JSInternedStrRef<'a, 'b>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<'a, 'b> StructuralPartialEq for JSInternedStrRef<'a, 'b>