Struct QuerySolutions 

pub struct QuerySolutions<S: Rdf> { /* private fields */ }

Represents a collection of query solutions from a SPARQL SELECT query.

This type holds the complete result set from a SPARQL query execution, including all solution rows and a prefix map for qualifying IRIs in output.

Type Parameters

• S - The RDF graph type implementing Rdf

Implementations

impl<S: Rdf> QuerySolutions<S>

pub fn new( solutions: Vec<QuerySolution<S>>, prefixmap: PrefixMap, ) -> QuerySolutions<S>

Creates a new query solutions collection with the given data.

Arguments

• solutions - Vector of query solution rows
• prefixmap - Prefix map for IRI qualification in output

pub fn empty() -> QuerySolutions<S>

Creates an empty query solutions collection.

Returns a new instance with no solutions and an empty prefix map.

pub fn prefixmap(&self) -> &PrefixMap

Returns a reference to the prefix map.

The prefix map contains namespace bindings used for qualifying IRIs when displaying or formatting results.

pub fn extend( &mut self, solutions: Vec<QuerySolution<S>>, prefixmap: PrefixMap, ) -> Result<(), PrefixMapError>

Extends this collection with additional solutions and prefix mappings.

Arguments

• solutions - Additional solutions to append
• prefixmap - Prefix map to merge (new prefixes or updated IRIs)

Errors

Returns an error if the prefix maps have conflicting definitions for the same prefix (same prefix bound to different namespaces).

pub fn iter(&self) -> impl Iterator<Item = &QuerySolution<S>>

Returns an iterator over the query solutions.

pub fn count(&self) -> usize

Returns the number of solutions in this collection.

pub fn write_table(&self, writer: &mut dyn Write) -> Result<(), RDFError>

Writes the query solutions as a formatted ASCII table.

Produces a human-readable table with modern rounded borders, row numbers, and qualified IRIs using the prefix map. The table includes:

• Row numbers in the first column (1-indexed)
• Variable names as column headers (with ? prefix)
• Qualified IRIs using registered prefixes
• Blank nodes displayed as _:identifier
• Literals shown with their datatype/language tags
• RDF-star quoted triples in << s p o >> syntax
• Empty cells for unbound variables

Arguments

• writer - Output destination (stdout, file, buffer, etc.)

Returns an error if:

• Writing to the output fails
• Term conversion fails when processing solutions

impl<S: Rdf + Serialize> QuerySolutions<S>

pub fn as_json(&self) -> String

Serializes the query solutions as pretty-printed JSON.

Trait Implementations

impl<S: Clone + Rdf> Clone for QuerySolutions<S>

fn clone(&self) -> QuerySolutions<S>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S: Debug + Rdf> Debug for QuerySolutions<S>

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

Formats the value using the given formatter.

impl<S: Rdf> Display for QuerySolutions<S>

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

Formats the query solutions as plain text, one solution per line.

Each solution is displayed using its show() method, which presents variable bindings in the format ?variable -> value. Solutions are separated by blank lines for readability.

impl<S: Rdf> IntoIterator for QuerySolutions<S>

type Item = QuerySolution<S>

The type of items yielded by the iterator.

type IntoIter = IntoIter<QuerySolution<S>>

The iterator type for consuming iteration.

fn into_iter(self) -> Self::IntoIter

Converts the query solutions into an iterator, consuming the collection.

This allows using QuerySolutions directly in for loops and other iterator contexts. The collection is consumed, yielding owned QuerySolution instances.

impl<S> Serialize for QuerySolutions<S>

where S: Serialize + Rdf,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.