Struct oxigraph::model::BlankNode

pub struct BlankNode(_);

An owned RDF blank node.

The common way to create a new blank node is to use the BlankNode::default function.

It is also possible to create a blank node from a blank node identifier using the BlankNode::new function. The blank node identifier must be valid according to N-Triples, Turtle and SPARQL grammars.

The default string formatter is returning an N-Triples, Turtle and SPARQL compatible representation:

use oxigraph::model::BlankNode;

assert_eq!(
    "_:a122",
    BlankNode::new("a122")?.to_string()
);

Implementations

impl BlankNode

pub fn new(id: impl Into<String>) -> Result<Self, BlankNodeIdParseError>

Creates a blank node from a unique identifier.

The blank node identifier must be valid according to N-Triples, Turtle and SPARQL grammars.

In most cases, it is much more convenient to create a blank node using BlankNode::default() that creates a random ID that could be easily inlined by Oxigraph stores.

pub fn new_unchecked(id: impl Into<String>) -> Self

Creates a blank node from a unique identifier without validation.

It is the caller's responsibility to ensure that id is a valid blank node identifier according to N-Triples, Turtle and SPARQL grammars.

new is a safe version of this constructor and should be used for untrusted data.

pub fn new_from_unique_id(id: impl Into<u128>) -> Self

Creates a blank node from a unique numerical id

In most cases, it is much more convenient to create a blank node using BlankNode::default().

pub fn as_str(&self) -> &str

Returns the underlying ID of this blank node

pub fn into_string(self) -> String

Returns the underlying ID of this blank node

pub fn as_ref(&self) -> BlankNodeRef<'_>

Trait Implementations

impl Clone for BlankNode

fn clone(&self) -> BlankNode

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for BlankNode

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

Formats the value using the given formatter.

impl Default for BlankNode

fn default() -> Self

Builds a new RDF blank node with a unique id

impl Display for BlankNode

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

Formats the value using the given formatter.

impl Eq for BlankNode

impl<'a> From<&'a BlankNode> for BlankNodeRef<'a>

fn from(node: &'a BlankNode) -> Self

Performs the conversion.

impl<'a> From<&'a BlankNode> for NamedOrBlankNodeRef<'a>

fn from(node: &'a BlankNode) -> Self

Performs the conversion.

impl<'a> From<&'a BlankNode> for TermRef<'a>

fn from(node: &'a BlankNode) -> Self

Performs the conversion.

impl<'a> From<&'a BlankNode> for GraphNameRef<'a>

fn from(node: &'a BlankNode) -> Self

Performs the conversion.

impl From<BlankNode> for NamedOrBlankNode

fn from(node: BlankNode) -> Self

Performs the conversion.

impl From<BlankNode> for Term

fn from(node: BlankNode) -> Self

Performs the conversion.

impl From<BlankNode> for GraphName

fn from(node: BlankNode) -> Self

Performs the conversion.

impl<'a> From<BlankNodeRef<'a>> for BlankNode

fn from(node: BlankNodeRef<'a>) -> Self

Performs the conversion.

impl Hash for BlankNode

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl PartialEq<BlankNode> for BlankNode

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl<'_> PartialEq<BlankNode> for BlankNodeRef<'_>

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<'_> PartialEq<BlankNodeRef<'_>> for BlankNode

fn eq(&self, other: &BlankNodeRef<'_>) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl StructuralEq for BlankNode

impl StructuralPartialEq for BlankNode

impl TTerm for BlankNode

fn kind(&self) -> TermKind

Returns the kind of this term (IRI, literal, blank node, variable).

fn value_raw(&self) -> RawValue<'_>

Return the "value" of this term, possibly split in two substrings. The second part might only be non-empty if this term is an IRI reference.

fn as_dyn(&self) -> &dyn TTerm

This method ensures that all implementations of TTerm can be turned into a trait object.

fn value(&self) -> MownStr<'_>

Return the "value" of this term, which depends on its kind: * for an IRI reference, its value; * for a literal, its lexical value; * for a blank node, its local identifier; * for a variable, its name.

fn datatype(&self) -> Option<SimpleIri<'_>>

Return the datatype IRI of this term if it is a literal.

fn language(&self) -> Option<&str>

Return the language tag of this term if it is a language-tagged literal.

fn is_absolute(&self) -> bool

All terms are absolute, except for: * relative IRI references, * literals whose datatype is a relative IRI reference.

impl TryCopyTerm for BlankNode

type Error = SophiaToOxigraphConversionError

The error type produced when failing to copy a given term

fn try_copy<T: ?Sized>(other: &T) -> Result<Self, Self::Error> where
    T: TTerm, 

Try to copy term into an instance of this type.