当前位置: 首页>>代码示例 >>用法及示例精选 >>正文


Rust String.from_utf8用法及代码示例


本文简要介绍rust语言中 std::string::String.from_utf8 的用法。

用法

pub fn from_utf8(vec: Vec<u8, Global>) -> Result<String, FromUtf8Error>

将字节向量转换为 String

字符串 ( String ) 由字节 ( u8 ) 组成,字节向量 ( Vec<u8> ) 由字节组成,因此此函数在两者之间进行转换。并非所有字节切片都是有效的 String s,但是:String 要求它是有效的 UTF-8。 from_utf8() 检查以确保字节是有效的 UTF-8,然后进行转换。

如果您确定字节切片是有效的 UTF-8,并且您不想产生有效性检查的开销,则此函数有一个不安全版本 from_utf8_unchecked ,它具有相同的行为但跳过查看。

为了效率起见,此方法将注意不复制向量。

如果您需要 &str 而不是 String ,请考虑 str::from_utf8

此方法的逆方法是 into_bytes

错误

如果切片不是 UTF-8,则返回 Err ,并说明为什么提供的字节不是 UTF-8。您移入的矢量也包括在内。

例子

基本用法:

// some bytes, in a vector
let sparkle_heart = vec![240, 159, 146, 150];

// We know these bytes are valid, so we'll use `unwrap()`.
let sparkle_heart = String::from_utf8(sparkle_heart).unwrap();

assert_eq!("💖", sparkle_heart);

不正确的字节:

// some invalid bytes, in a vector
let sparkle_heart = vec![0, 159, 146, 150];

assert!(String::from_utf8(sparkle_heart).is_err());

有关如何处理此错误的更多详细信息,请参阅 FromUtf8Error 的文档。

相关用法


注:本文由纯净天空筛选整理自rust-lang.org大神的英文原创作品 std::string::String.from_utf8。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。