Struct LiteralRef 

pub struct LiteralRef<'a>(/* private fields */);

A borrowed RDF literal.

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

use oxrdf::LiteralRef;
use oxrdf::vocab::xsd;

assert_eq!(
    "\"foo\\nbar\"",
    LiteralRef::new_simple_literal("foo\nbar").to_string()
);

assert_eq!(
    r#""1999-01-01"^^<http://www.w3.org/2001/XMLSchema#date>"#,
    LiteralRef::new_typed_literal("1999-01-01", xsd::DATE).to_string()
);

Implementations

impl<'a> LiteralRef<'a>

pub const fn new_simple_literal(value: &'a str) -> Self

Builds an RDF simple literal.

pub fn new_typed_literal( value: &'a str, datatype: impl Into<NamedNodeRef<'a>>, ) -> Self

Builds an RDF literal with a datatype.

pub const fn new_language_tagged_literal_unchecked( value: &'a str, language: &'a str, ) -> Self

Builds an RDF language-tagged string.

It is the responsibility of the caller to check that language is valid BCP47 language tag, and is lowercase.

Literal::new_language_tagged_literal() is a safe version of this constructor and should be used for untrusted data.

pub const fn new_directional_language_tagged_literal_unchecked( value: &'a str, language: &'a str, direction: BaseDirection, ) -> Self

Available on crate feature rdf-12 only.

Builds an RDF directional language-tagged string.

It is the responsibility of the caller to check that language is valid BCP47 language tag, and is lowercase.

Literal::new_directional_language_tagged_literal() is a safe version of this constructor and should be used for untrusted data.

pub const fn value(self) -> &'a str

The literal lexical form

pub const fn language(self) -> Option<&'a str>

The literal language tag if it is a language-tagged string.

Language tags are defined by the BCP47. They are normalized to lowercase by this implementation.

pub const fn direction(self) -> Option<BaseDirection>

Available on crate feature rdf-12 only.

The literal base direction if it is a directional language-tagged string.

The two possible base directions are left-to-right (ltr) and right-to-left (rtl).

pub const fn datatype(self) -> NamedNodeRef<'a>

The literal datatype.

The datatype of language-tagged string is always rdf:langString. The datatype of simple literals is xsd:string.

pub const fn is_plain(self) -> bool

👎Deprecated since 0.3.0: Plain literal concept is removed in RDF 1.1

Checks if this literal could be seen as an RDF 1.0 plain literal.

It returns true if the literal is a language-tagged string or has the datatype xsd:string.

pub fn into_owned(self) -> Literal

Trait Implementations

impl<'a> Clone for LiteralRef<'a>

fn clone(&self) -> LiteralRef<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for LiteralRef<'a>

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

Formats the value using the given formatter.

impl Display for LiteralRef<'_>

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

Formats the value using the given formatter.

impl<'a> From<&'a Literal> for LiteralRef<'a>

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

Converts to this type from the input type.

impl<'a> From<&'a str> for LiteralRef<'a>

fn from(value: &'a str) -> Self

Converts to this type from the input type.

impl From<LiteralRef<'_>> for Term

fn from(literal: LiteralRef<'_>) -> Self

Converts to this type from the input type.

impl<'a> From<LiteralRef<'a>> for Literal

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

Converts to this type from the input type.

impl<'a> From<LiteralRef<'a>> for TermRef<'a>

fn from(literal: LiteralRef<'a>) -> Self

Converts to this type from the input type.

impl<'a> Hash for LiteralRef<'a>

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, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq<Literal> for LiteralRef<'_>

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<LiteralRef<'_>> for Literal

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> PartialEq for LiteralRef<'a>

fn eq(&self, other: &LiteralRef<'a>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for LiteralRef<'_>

Available on crate feature serde only.

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl<'a> Copy for LiteralRef<'a>

impl<'a> Eq for LiteralRef<'a>

impl<'a> StructuralPartialEq for LiteralRef<'a>