Class BaseLiteralNode

Abstract Base Class for Literal Nodes.

Inheritance

object

BaseNode

BaseLiteralNode

LiteralNode

Implements

ILiteralNode

INode

IComparable<INode>

IComparable<IBlankNode>

IComparable<IGraphLiteralNode>

IComparable<ILiteralNode>

IComparable<IUriNode>

IComparable<IVariableNode>

IComparable<IRefNode>

IComparable<ITripleNode>

IEquatable<INode>

IEquatable<IBlankNode>

IEquatable<IGraphLiteralNode>

IEquatable<ILiteralNode>

IEquatable<IUriNode>

IEquatable<IVariableNode>

IEquatable<IRefNode>

IEquatable<ITripleNode>

IEquatable<BaseLiteralNode>

IComparable<BaseLiteralNode>

Inherited Members

BaseNode._nodeType

BaseNode.NodeType

BaseNode.ToString(INodeFormatter)

BaseNode.ToString(INodeFormatter, TripleSegment)

object.Equals(object, object)

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

Namespace: VDS.RDF

Assembly: dotNetRdf.dll

Syntax

[Serializable]
public abstract class BaseLiteralNode : BaseNode, ILiteralNode, INode, IComparable<INode>, IComparable<IBlankNode>, IComparable<IGraphLiteralNode>, IComparable<ILiteralNode>, IComparable<IUriNode>, IComparable<IVariableNode>, IComparable<IRefNode>, IComparable<ITripleNode>, IEquatable<INode>, IEquatable<IBlankNode>, IEquatable<IGraphLiteralNode>, IEquatable<ILiteralNode>, IEquatable<IUriNode>, IEquatable<IVariableNode>, IEquatable<IRefNode>, IEquatable<ITripleNode>, IEquatable<BaseLiteralNode>, IComparable<BaseLiteralNode>

Constructors

BaseLiteralNode(string, bool)

Internal Only Constructor for Literal Nodes.

Declaration

protected BaseLiteralNode(string literal, bool normalize)

Parameters

Type	Name	Description
string	literal	String value of the Literal.
bool	normalize	Whether to Normalize the Literal Value.

BaseLiteralNode(string, string, bool)

Internal Only Constructor for Literal Nodes.

Declaration

protected BaseLiteralNode(string literal, string langspec, bool normalize)

Parameters

Type	Name	Description
string	literal	String value of the Literal.
string	langspec	String value for the Language Specifier for the Literal.
bool	normalize	Whether to Normalize the Literal Value.

BaseLiteralNode(string, Uri, bool)

Internal Only Constructor for Literal Nodes.

Declaration

protected BaseLiteralNode(string literal, Uri datatype, bool normalize)

Parameters

Type	Name	Description
string	literal	String value of the Literal.
Uri	datatype	Uri for the Literals Data Type.
bool	normalize	Whether to Normalize the Literal Value.

Properties

DataType

Gives the Data Type Uri for the Literal (if it exists) or a null.

Declaration

public Uri DataType { get; }

Property Value

Type	Description
Uri

Language

Gives the Language Specifier for the Literal (if it exists) or the Empty String.

Declaration

public string Language { get; }

Property Value

Type	Description
string

Value

Gives the String Value of the Literal.

Declaration

public string Value { get; }

Property Value

Type	Description
string

Methods

CompareTo(BaseLiteralNode)

Returns an Integer indicating the Ordering of this Node compared to another Node.

Declaration

public int CompareTo(BaseLiteralNode other)

Parameters

Type	Name	Description
BaseLiteralNode	other	Node to test against.

Returns

Type	Description
int

CompareTo(IBlankNode)

Returns an Integer indicating the Ordering of this Node compared to another Node.

Declaration

public override int CompareTo(IBlankNode other)

Parameters

Type	Name	Description
IBlankNode	other	Node to test against.

Returns

Type	Description
int

Overrides

BaseNode.CompareTo(IBlankNode)

CompareTo(IGraphLiteralNode)

Returns an Integer indicating the Ordering of this Node compared to another Node.

Declaration

public override int CompareTo(IGraphLiteralNode other)

Parameters

Type	Name	Description
IGraphLiteralNode	other	Node to test against.

Returns

Type	Description
int

Overrides

BaseNode.CompareTo(IGraphLiteralNode)

CompareTo(ILiteralNode)

Returns an Integer indicating the Ordering of this Node compared to another Node.

Declaration

public override int CompareTo(ILiteralNode other)

Parameters

Type	Name	Description
ILiteralNode	other	Node to test against.

Returns

Type	Description
int

Overrides

BaseNode.CompareTo(ILiteralNode)

CompareTo(INode)

Implementation of CompareTo for Literal Nodes.

Declaration

public override int CompareTo(INode other)

Parameters

Type	Name	Description
INode	other	Node to Compare To.

Returns

Type	Description
int

Overrides

BaseNode.CompareTo(INode)

Remarks

Literal Nodes are greater than Blank Nodes, Uri Nodes and Nulls, they are less than Graph Literal Nodes.

Two Literal Nodes are initially compared based upon Data Type, untyped literals are less than typed literals. Two untyped literals are compared purely on lexical value, Language Specifier has no effect on the ordering. This means Literal Nodes are only partially ordered, for example "hello"@en and "hello"@en-us are considered to be the same for ordering purposes though they are different for equality purposes. Data-typed Literals can only be properly ordered if they are one of a small subset of types (Integers, Booleans, Date Times, Strings and URIs). If the datatypes for two Literals are non-matching they are ordered on Datatype Uri, this ensures that each range of Literal Nodes is sorted to some degree. Again this also means that Literals are partially ordered since unknown datatypes will only be sorted based on lexical value and not on actual value.

CompareTo(IRefNode)

Returns an Integer indicating the Ordering of this Node compared to another Node.

Declaration

public override int CompareTo(IRefNode other)

Parameters

Type	Name	Description
IRefNode	other	Node to test against.

Returns

Type	Description
int

Overrides

BaseNode.CompareTo(IRefNode)

CompareTo(ITripleNode)

Returns an Integer indicating the Ordering of this Node compared to another Node.

Declaration

public override int CompareTo(ITripleNode other)

Parameters

Type	Name	Description
ITripleNode	other	Node to test against.

Returns

Type	Description
int

Overrides

BaseNode.CompareTo(ITripleNode)

CompareTo(IUriNode)

Returns an Integer indicating the Ordering of this Node compared to another Node.

Declaration

public override int CompareTo(IUriNode other)

Parameters

Type	Name	Description
IUriNode	other	Node to test against.

Returns

Type	Description
int

Overrides

BaseNode.CompareTo(IUriNode)

CompareTo(IVariableNode)

Returns an Integer indicating the Ordering of this Node compared to another Node.

Declaration

public override int CompareTo(IVariableNode other)

Parameters

Type	Name	Description
IVariableNode	other	Node to test against.

Returns

Type	Description
int

Overrides

BaseNode.CompareTo(IVariableNode)

Equals(object)

Implementation of the Equals method for Literal Nodes.

Declaration

public override bool Equals(object obj)

Parameters

Type	Name	Description
object	obj	Object to compare the Node with.

Returns

Type	Description
bool

Overrides

BaseNode.Equals(object)

Remarks

The default behaviour is for Literal Nodes to be considered equal IFF

1. Their Language Specifiers are identical (or neither has a Language Specifier)
2. Their Data Types are identical (or neither has a Data Type)
3. Their String values are identical

This behaviour can be overridden to use value equality by setting the LiteralEqualityMode option to be Loose if this is more suited to your application.

Equals(BaseLiteralNode)

Determines whether this Node is equal to a Literal Node.

Declaration

public bool Equals(BaseLiteralNode other)

Parameters

Type	Name	Description
BaseLiteralNode	other	Literal Node.

Returns

Type	Description
bool

Equals(IBlankNode)

Determines whether this Node is equal to a Blank Node (should always be false).

Declaration

public override bool Equals(IBlankNode other)

Parameters

Type	Name	Description
IBlankNode	other	Blank Node.

Returns

Type	Description
bool

Overrides

BaseNode.Equals(IBlankNode)

Equals(IGraphLiteralNode)

Determines whether this Node is equal to a Graph Literal Node (should always be false).

Declaration

public override bool Equals(IGraphLiteralNode other)

Parameters

Type	Name	Description
IGraphLiteralNode	other	Graph Literal Node.

Returns

Type	Description
bool

Overrides

BaseNode.Equals(IGraphLiteralNode)

Equals(ILiteralNode)

Determines whether this Node is equal to a Literal Node.

Declaration

public override bool Equals(ILiteralNode other)

Parameters

Type	Name	Description
ILiteralNode	other	Literal Node.

Returns

Type	Description
bool

Overrides

BaseNode.Equals(ILiteralNode)

Equals(INode)

Implementation of the Equals method for Literal Nodes.

Declaration

public override bool Equals(INode other)

Parameters

Type	Name	Description
INode	other	Object to compare the Node with.

Returns

Type	Description
bool

Overrides

BaseNode.Equals(INode)

Remarks

The default behaviour is for Literal Nodes to be considered equal IFF

1. Their Language Specifiers are identical (or neither has a Language Specifier)
2. Their Data Types are identical (or neither has a Data Type)
3. Their String values are identical

This behaviour can be overridden to use value equality by setting the LiteralEqualityMode option to be Loose if this is more suited to your application.

Equals(IRefNode)

Determines whether this Node is equal to a Ref Node (should always be false).

Declaration

public override bool Equals(IRefNode other)

Parameters

Type	Name	Description
IRefNode	other	Ref Node.

Returns

Type	Description
bool

Overrides

BaseNode.Equals(IRefNode)

Equals(ITripleNode)

Determines whether this Node is equal to a Triple Node (should always be false).

Declaration

public override bool Equals(ITripleNode other)

Parameters

Type	Name	Description
ITripleNode	other	Triple Node.

Returns

Type	Description
bool

Overrides

BaseNode.Equals(ITripleNode)

Equals(IUriNode)

Determines whether this Node is equal to a URI Node (should always be false).

Declaration

public override bool Equals(IUriNode other)

Parameters

Type	Name	Description
IUriNode	other	URI Node.

Returns

Type	Description
bool

Overrides

BaseNode.Equals(IUriNode)

Equals(IVariableNode)

Determines whether this Node is equal to a Variable Node (should always be false).

Declaration

public override bool Equals(IVariableNode other)

Parameters

Type	Name	Description
IVariableNode	other	Variable Node.

Returns

Type	Description
bool

Overrides

BaseNode.Equals(IVariableNode)

GetHashCode()

Serves as the default hash function.

Declaration

public override int GetHashCode()

Returns

Type	Description
int	A hash code for the current object.

Overrides

BaseNode.GetHashCode()

ToString()

Gets a String representation of a Literal Node.

Declaration

public override string ToString()

Returns

Type	Description
string

Overrides

BaseNode.ToString()

Remarks

Gives a value without quotes (as some syntaxes use) with the Data Type/Language Specifier appended using Notation 3 syntax.

Implements

ILiteralNode

INode

IComparable<T>

IComparable<T>

IComparable<T>

IComparable<T>

IComparable<T>

IComparable<T>

IComparable<T>

IComparable<T>

IEquatable<T>

IEquatable<T>

IEquatable<T>

IEquatable<T>

IEquatable<T>

IEquatable<T>

IEquatable<T>

IEquatable<T>

IEquatable<T>

IComparable<T>

Extension Methods

Extensions.ToSafeString(object)

Extensions.AsEnumerable<T>(T)

DynamicExtensions.AsDynamic(INode, IGraph, Uri)

Extensions.EffectiveBooleanValue(INode)

Extensions.IsListRoot(INode, IGraph)

ValuedNodeExtensions.AsValuedNode(INode)