Struct core::str::Utf8Chunk

pub struct Utf8Chunk<'a> { /* private fields */ }

🔬This is a nightly-only experimental API. (utf8_chunks #99543)

Utf8Chunks 迭代器返回的项。

在解码 UTF-8 字符串时，Utf8Chunk 存储一个 u8 序列，直到第一个断字符。

Examples

#![feature(utf8_chunks)]

use std::str::Utf8Chunks;

// 无效的 UTF-8 字符串
let bytes = b"foo\xF1\x80bar";

// 解码第一个 `Utf8Chunk`
let chunk = Utf8Chunks::new(bytes).next().unwrap();

// 前三个字符有效 UTF-8
assert_eq!("foo", chunk.valid());

// 第四个字符损坏了
assert_eq!(b"\xF1\x80", chunk.invalid());

Implementations

impl<'a> Utf8Chunk<'a>

pub fn valid(&self) -> &'a str

🔬This is a nightly-only experimental API. (utf8_chunks #99543)

返回下一个经过验证的 UTF-8 子字符串。

该子字符串可以在字符串的开头为空，也可以在断开的 UTF-8 字符之间为空。

pub fn invalid(&self) -> &'a [u8]

🔬This is a nightly-only experimental API. (utf8_chunks #99543)

返回导致失败的无效序列。

返回的切片最大长度为 3，并在 valid 给出的子字符串之后开始。 解码将在此序列后恢复。

如果为空，则这是字符串中的最后一个块。 如果非空，则遇到意外字节或意外到达输入结尾。

有损解码将用 U+FFFD REPLACEMENT CHARACTER 替换这个序列。

Trait Implementations

impl<'a> Clone for Utf8Chunk<'a>

fn clone(&self) -> Utf8Chunk<'a>

返回值的副本。

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

从 source 执行复制分配。

impl<'a> Debug for Utf8Chunk<'a>

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

使用给定的格式化程序格式化该值。

impl<'a> PartialEq<Utf8Chunk<'a>> for Utf8Chunk<'a>

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

此方法测试 self 和 other 值是否相等，并由 == 使用。

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

此方法测试 !=。 默认实现几乎总是足够的，并且不应在没有充分理由的情况下被覆盖。

impl<'a> Eq for Utf8Chunk<'a>

impl<'a> StructuralEq for Utf8Chunk<'a>

impl<'a> StructuralPartialEq for Utf8Chunk<'a>