RDFtk: IRI

本软件包提供了 IRI 和 URI 规范的实现。

与RDFtk项目的其余部分一样，这个crate的目标是在可用性和优化之间寻求平衡，因此它可能比必要的克隆更多，并且解析速度可能比预期慢。对于大多数情况，客户端应使用IRIRef类型，它是一个Arc引用，因此可以在不克隆整个IRI值的情况下重复使用。

示例

最常见的用法是从字符串解析IRI值。

use field33_rdftk_iri_temporary_fork::IRI;
use std::convert::from_str;

let result = IRI::from_str(
    "https://john.doe@www.example.com:123/forum/questions/?tag=networking&order=newest#top",
);

builder模块允许更程序化地构建IRI。

use field33_rdftk_iri_temporary_fork::{IRI, Scheme};
use field33_rdftk_iri_temporary_fork::builder::IriBuilder;

let mut builder = IriBuilder::default();
let result: IriResult<IRI> = builder
    .scheme(&Scheme::https())
    .user_name("john.doe")
    .host("www.example.com")?
    .port(123.into())
    .path_str("/forum/questions/")?
    .query_str("tag=networking&order=newest")?
    .fragment_str("top")?
    .try_into();

注意使用Scheme::https()，Scheme和Port类型都包含用于构建已知值的相关函数。

特性

以下特性存在于此crate中。

• builder [默认] -- 包含builder模块，它反过来又包含IriBuilder类型。
• genid [默认] -- 包含一个构造函数，用于创建"genid"已知IRI值。
• path_iri [默认] -- 为IRI提供TryFrom<&PathBuf>和TryFrom<PathBuf>的实现。
• uuid_iri [默认] -- 为IRI提供TryFrom<&Uuid>和TryFrom<Uuid>的实现。