four-cc

四字符码的表示。

lib.rs:

Newtype 包装器，提供对四字符码值的便捷表示。

将此类型用于公共 API 中，作为传递等价的 u32 的替代方案，可以使值的预期使用更加明确。

创建 FourCC 值

use four_cc::FourCC;

let uuid = FourCC(*b"uuid");

// using Into
let code: FourCC = b"uuid".into();
assert_eq!(uuid, code);

从切片中

let data = b"moofftyp";
let code = FourCC::from(&data[0..4]);  // would panic if fewer than 4 bytes
assert_eq!(FourCC(*b"moof"), code);

从 u32 中

let data: u32 = 0x6d6f6f66;
let code = FourCC::from(data);
assert_eq!(FourCC(*b"moof"), code);
// conversion back into a u32
let converted: u32 = code.into();
assert_eq!(data, converted);

常量

FourCC 值可以在 const 表达式中使用

const UUID: FourCC = FourCC(*b"uuid");

匹配

只要您定义了要匹配的常量，就可以在 match 模式中使用 FourCC 值

const UUID: FourCC = FourCC(*b"uuid");
const MOOV: FourCC = FourCC(*b"moov");
match other_value {
    MOOV => println!("movie"),
    UUID => println!("unique identifier"),
    // compiler will not accept: FourCC(*b"trun") => println!("track fragment run"),
    _ => println!("Other value; scary stuff")
}

无效的文本值

如果文本值不是四个字节，则编译会失败

let bad_fourcc = FourCC(*b"uuid123");
// -> expected an array with a fixed size of 4 elements, found one with 7 elements

注意 FourCC 值可能包含不可打印的字节值，包括字节的零值。

调试显示

let uuid = FourCC(*b"uuid");
println!("it's {:?}", uuid);  // produces: it's FourCC{uuid}

注意，如果 FourCC 字节无法转换为 UTF8，则将使用回退表示（因为如果 format!() 抛出异常的话，将会很令人惊讶）。

let uuid = FourCC(*b"u\xFFi\0");
println!("it's {:?}", uuid);  // produces: it's FourCC{u\xffi\x00}