Struct std::str::Utf8Error

pub struct Utf8Error { /* fields omitted */ }

尝试将 u8 的序列解释为字符串时可能发生的错误。

这样，例如 String 和 &str 的 from_utf8 系列函数和方法都利用了此错误。

Examples

此错误类型的方法可用于创建类似于 String::from_utf8_lossy 的功能，而无需分配堆内存:

fn from_utf8_lossy<F>(mut input: &[u8], mut push: F) where F: FnMut(&str) {
    loop {
        match std::str::from_utf8(input) {
            Ok(valid) => {
                push(valid);
                break
            }
            Err(error) => {
                let (valid, after_valid) = input.split_at(error.valid_up_to());
                unsafe {
                    push(std::str::from_utf8_unchecked(valid))
                }
                push("\u{FFFD}");

                if let Some(invalid_sequence_length) = error.error_len() {
                    input = &after_valid[invalid_sequence_length..]
                } else {
                    break
                }
            }
        }
    }
}

Implementations

impl Utf8Error

pub fn valid_up_to(&self) -> usize

返回给定字符串中的索引，直到对其进行有效 UTF-8 验证为止。

它是使 from_utf8(&input[..index]) 返回 Ok(_) 的最大索引。

Examples

基本用法:

use std::str;

// vector 中的一些无效字节
let sparkle_heart = vec![0, 159, 146, 150];

// std::str::from_utf8 返回 Utf8Error
let error = str::from_utf8(&sparkle_heart).unwrap_err();

// 第二个字节在这里无效
assert_eq!(1, error.valid_up_to());

pub fn error_len(&self) -> Option<usize>

提供有关失败的更多信息:

• None: 输入的末尾意外到达。 self.valid_up_to() 从输入末尾开始是 1 到 3 个字节。 如果字节流 (例如文件或网络套接字) 正在以增量方式进行解码，则这可能是有效的 char，其 UTF-8 字节序列跨越了多个块。

• Some(len): 遇到意外的字节。 提供的长度是从 valid_up_to() 给定的索引处开始的无效字节序列的长度。 如果有损解码，则应在该序列之后 (插入 U+FFFD REPLACEMENT CHARACTER 之后) 恢复解码。

Trait Implementations

impl Clone for Utf8Error

pub fn clone(&self) -> Utf8Error

返回值的副本。

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

从 source 执行复制分配。

impl Debug for Utf8Error

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

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

impl Display for Utf8Error

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

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

impl Error for Utf8Error

fn description(&self) -> &str

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

fn source(&self) -> Option<&(dyn Error + 'static)>

此错误的下级来源 (如果有)。

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace #53487)

返回发生错误的栈回溯 (如果有)。

fn cause(&self) -> Option<&dyn Error>

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl PartialEq<Utf8Error> for Utf8Error

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

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

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

此方法测试 !=。

impl Copy for Utf8Error

impl Eq for Utf8Error

impl StructuralEq for Utf8Error

impl StructuralPartialEq for Utf8Error