RDFtk: IRI

此包提供了 IRI 和 URI 规范的实现。

与RDFtk项目的其余部分一样，这个crate的目标是实用性而非优化，因此它可能需要执行比必要的更多克隆，并且解析速度可能比预期的要慢。大部分情况下，客户端应使用IRIRef类型，这是一个Arc引用，因此可以在不克隆整个IRI值的情况下重用。

示例

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

use rdftk_iri::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 rdftk_iri::{IRI, Scheme};
use rdftk_iri::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>的实现。