| RDF-Query documentation | Contained in the RDF-Query distribution. |
RDF::Query::Algebra::Sort - Algebra class for sorting
This document describes RDF::Query::Algebra::Sort version 2.907.
Beyond the methods documented below, this class inherits methods from the RDF::Query::Algebra class.
new ( $pattern, [ $dir = $expr ] )>Returns a new Sort structure.
construct_argsReturns a list of arguments that, passed to this class' constructor, will produce a clone of this algebra pattern.
patternReturns the pattern to be sorted.
orderbyReturns the array of ordering definitions.
sseReturns the SSE string for this algebra expression.
as_sparqlReturns the SPARQL string for this algebra expression.
as_hashReturns the query as a nested set of plain data structures (no objects).
typeReturns the type of this algebra expression.
referenced_variablesReturns a list of the variable names used in this algebra expression.
potentially_boundReturns a list of the variable names used in this algebra expression that will bind values during execution.
definite_variablesReturns a list of the variable names that will be bound after evaluating this algebra expression.
is_solution_modifierReturns true if this node is a solution modifier.
Gregory Todd Williams <gwilliams@cpan.org>
| RDF-Query documentation | Contained in the RDF-Query distribution. |
# RDF::Query::Algebra::Sort # -----------------------------------------------------------------------------
package RDF::Query::Algebra::Sort; use strict; use warnings; no warnings 'redefine'; use base qw(RDF::Query::Algebra); use Data::Dumper; use Set::Scalar; use Log::Log4perl; use Scalar::Util qw(blessed); use Carp qw(carp croak confess); use Time::HiRes qw(gettimeofday tv_interval); ###################################################################### our ($VERSION); BEGIN { $VERSION = '2.907'; } ######################################################################
sub new { my $class = shift; my $pattern = shift; my @orderby = @_; return bless( [ $pattern, @orderby ], $class ); }
sub construct_args { my $self = shift; my $pattern = $self->pattern; my @orderby = $self->orderby; return ($pattern, @orderby); }
sub pattern { my $self = shift; if (@_) { $self->[0] = shift; } return $self->[0]; }
sub orderby { my $self = shift; my @orderby = @{ $self }[ 1 .. $#{ $self } ]; return @orderby; }
sub sse { my $self = shift; my $context = shift; my $prefix = shift || ''; my $indent = $context->{indent} || ' '; my @order_sse; my @orderby = $self->orderby; foreach my $o (@orderby) { my ($dir, $val) = @$o; push(@order_sse, sprintf("($dir %s)", $val->sse( $context, "${prefix}${indent}" ))); } return sprintf( "(sort\n${prefix}${indent}%s\n${prefix}${indent}%s)", $self->pattern->sse( $context, "${prefix}${indent}" ), join(' ', @order_sse), ); }
sub as_sparql { my $self = shift; my $context = shift || {}; my $indent = shift; if ($context->{ skip_sort }) { $context->{ skip_sort }--; return $self->pattern->as_sparql( $context, $indent ); } my $order_exprs = $self->_as_sparql_order_exprs($context, $indent); my $string = sprintf( "%s\nORDER BY %s", $self->pattern->as_sparql( $context, $indent ), $order_exprs, ); return $string; } sub _as_sparql_order_exprs { my $self = shift; my $context = shift; my $intent = shift; my @order_sparql; my @orderby = $self->orderby; foreach my $o (@orderby) { my ($dir, $val) = @$o; $dir = uc($dir); my $str = ($dir eq 'ASC') ? $val->as_sparql( $context ) : sprintf("%s(%s)", $dir, $val->as_sparql( $context )); push(@order_sparql, $str); } return join(' ', @order_sparql); }
sub as_hash { my $self = shift; my $context = shift; return { type => lc($self->type), pattern => $self->pattern->as_hash, order => [ map { $_->as_hash } $self->orderby ], }; }
sub type { return 'SORT'; }
sub referenced_variables { my $self = shift; return RDF::Query::_uniq($self->pattern->referenced_variables); }
sub potentially_bound { my $self = shift; return RDF::Query::_uniq($self->pattern->potentially_bound); }
sub definite_variables { my $self = shift; return $self->pattern->definite_variables; }
sub is_solution_modifier { return 1; } 1; __END__