Struct Wtf8

pub struct Wtf8 { /* private fields */ }

Available on crate features __ecma and ecma_ast only.

A borrowed slice of well-formed WTF-8 data.

Similar to &str, but can additionally contain surrogate code points if they’re not in a surrogate pair.

Implementations

impl Wtf8

pub const fn from_str(value: &str) -> &Wtf8

Create a WTF-8 slice from a UTF-8 &str slice.

Since WTF-8 is a superset of UTF-8, this always succeeds.

pub const fn len(&self) -> usize

Return the length, in WTF-8 bytes.

pub const fn is_empty(&self) -> bool

Return true if the string has a length of zero bytes.

pub fn slice(&self, begin: usize, end: usize) -> &Wtf8

Return a slice of the given string for the byte range [begin..end).

Failure

Fails when begin and end do not point to code point boundaries, or point beyond the end of the string.

pub fn slice_from(&self, begin: usize) -> &Wtf8

Return a slice of the given string from byte begin to its end.

Failure

Fails when begin is not at a code point boundary, or is beyond the end of the string.

pub fn slice_to(&self, end: usize) -> &Wtf8

Return a slice of the given string from its beginning to byte end.

Failure

Fails when end is not at a code point boundary, or is beyond the end of the string.

pub fn ascii_byte_at(&self, position: usize) -> u8

Return the code point at position if it is in the ASCII range, or `b’\xFF’ otherwise.

Failure

Fails if position is beyond the end of the string.

pub fn code_points(&self) -> Wtf8CodePoints<'_>

Return an iterator for the string’s code points.

pub fn as_str(&self) -> Option<&str>

Try to convert the string to UTF-8 and return a &str slice.

Return None if the string contains surrogates.

This does not copy the data.

pub const fn as_bytes(&self) -> &[u8]

Return the underlying WTF-8 bytes.

pub fn to_string_lossy(&self) -> Cow<'_, str>

Lossily convert the string to UTF-8. Return an UTF-8 &str slice if the contents are well-formed in UTF-8.

Surrogates are replaced with "\u{FFFD}" (the replacement character “�”).

This only copies the data if necessary (if it contains any surrogate).

pub fn to_ill_formed_utf16(&self) -> IllFormedUtf16CodeUnits<'_>

Convert the WTF-8 string to potentially ill-formed UTF-16 and return an iterator of 16-bit code units.

This is lossless: calling Wtf8Buf::from_ill_formed_utf16 on the resulting code units would always return the original WTF-8 string.

pub const unsafe fn from_bytes_unchecked(bytes: &[u8]) -> &Wtf8

Create a WTF-8 from a WTF-8 encoded byte slice.

Safety

The caller must ensure that bytes is a well-formed WTF-8 byte sequence.

This means that:

• All bytes must form valid UTF-8 sequences OR valid surrogate code point encodings
• Surrogate code points may appear unpaired and be encoded separately, but if they are paired, it should be encoded as a single 4-byte UTF-8 sequence. For example, the byte sequence [0xED, 0xA0, 0x80, 0xED, 0xB0, 0x80] is not valid WTF-8 because WTF-8 forbids encoding a surrogate pair as two separate 3-byte sequences.

Trait Implementations

impl AsRef<Wtf8> for Wtf8Atom

fn as_ref(&self) -> &Wtf8

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

impl Borrow<Wtf8> for Wtf8Buf

fn borrow(&self) -> &Wtf8

Immutably borrows from an owned value.

impl Debug for Wtf8

Format the slice with double quotes, and surrogates as \u followed by four hexadecimal digits. Example: "a\u{D800}" for a slice with code points [U+0061, U+D800]

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

Formats the value using the given formatter.

impl From<&Wtf8> for Wtf8Atom

fn from(s: &Wtf8) -> Wtf8Atom

Converts to this type from the input type.

impl<'a> From<&'a str> for &'a Wtf8

fn from(s: &'a str) -> &'a Wtf8

Converts to this type from the input type.

impl Hash for Wtf8

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

where H: Hasher,

Feeds this value into the given Hasher.

impl Ord for Wtf8

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

This method returns an Ordering between self and other.

impl PartialEq<&Wtf8> for Wtf8Atom

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl PartialEq<&Wtf8> for Wtf8Buf

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl PartialEq<Wtf8> for Wtf8Atom

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl PartialEq<Wtf8Atom> for Wtf8

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl PartialEq<Wtf8Buf> for &Wtf8

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl PartialEq for Wtf8

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl PartialOrd for Wtf8

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

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

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

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

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

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

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

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

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

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

impl ToOwned for Wtf8

type Owned = Wtf8Buf

The resulting type after obtaining ownership.

fn to_owned(&self) -> Wtf8Buf

Creates owned data from borrowed data, usually by cloning.

fn clone_into(&self, target: &mut Self::Owned)

Uses borrowed data to replace owned data, usually by cloning.

impl Eq for Wtf8