Sha256: cbcefbcd34ec0a949cb1688050c4935281cc7845bc0d3ac72b199327c4280e94

Contents?: true

Size: 1.77 KB

Versions: 10

Compression:

Stored size: 1.77 KB

Contents

module SPARQL; module Algebra
  class Operator
    ##
    # The SPARQL GraphPattern `ask` operator.
    #
    # Applications can use the ASK form to test whether or not a query pattern has a solution. No information is returned about the possible query solutions, just whether or not a solution exists.
    #
    # @example
    #   (prefix ((: <http://example/>))
    #     (ask
    #       (bgp (triple :x :p ?x))))
    #
    # @see http://www.w3.org/TR/sparql11-query/#ask
    class Ask < Operator::Unary
      include Query
      
      NAME = [:ask]

      ##
      # Executes this query on the given `queryable` graph or repository.
      # Returns true if any solutions are found, false otherwise.
      #
      # @param  [RDF::Queryable] queryable
      #   the graph or repository to query
      # @param  [Hash{Symbol => Object}] options
      #   any additional keyword options
      # @yield  [RDF::Literal::Boolean]
      # @yieldparam  [RDF::Query::Solution] solution
      # @yieldreturn [void] ignored
      # @return [RDF::Literal::Boolean]\
      # @see    http://www.w3.org/TR/sparql11-query/#sparqlAlgebra
      def execute(queryable, options = {})
        debug(options) {"Ask #{operands.first}"}
        res = boolean(!queryable.query(operands.last, options.merge(depth: options[:depth].to_i + 1)).empty?)
        yield res if block_given?
        res
      end
      
      ##
      # Returns an optimized version of this query.
      #
      # Return optimized query
      #
      # @return [Union, RDF::Query] `self`
      def optimize
        operands = operands.map(&:optimize)
      end

      # Query results in a boolean result (e.g., ASK)
      # @return [Boolean]
      def query_yields_boolean?
        true
      end
    end # Ask
  end # Operator
end; end # SPARQL::Algebra

Version data entries

10 entries across 10 versions & 1 rubygems

Version Path
sparql-3.0.2 lib/sparql/algebra/operator/ask.rb
sparql-3.0.1 lib/sparql/algebra/operator/ask.rb
sparql-3.0.0 lib/sparql/algebra/operator/ask.rb
sparql-2.2.2 lib/sparql/algebra/operator/ask.rb
sparql-2.2.1 lib/sparql/algebra/operator/ask.rb
sparql-2.2.0 lib/sparql/algebra/operator/ask.rb
sparql-2.1.0 lib/sparql/algebra/operator/ask.rb
sparql-2.0.0 lib/sparql/algebra/operator/ask.rb
sparql-2.0.0.beta2 lib/sparql/algebra/operator/ask.rb
sparql-2.0.0.beta1 lib/sparql/algebra/operator/ask.rb