Sha256: e16be1b93f6dab6aba48304c2a2a3930d20602c29be7fd78d0e6234a77209ab9

Contents?: true

Size: 1.61 KB

Versions: 8

Compression:

Stored size: 1.61 KB

Contents

module SPARQL; module Algebra
  class Operator
    ##
    # The SPARQL logical `rand` operator.
    #
    # Returns a pseudo-random number between 0 (inclusive) and 1.0e0 (exclusive). Different numbers can be produced every time this function is invoked. Numbers should be produced with approximately equal probability.
    #
    # [121] BuiltInCall ::= ... | 'RAND' NIL 
    #
    # @example SPARQL Grammar
    #   PREFIX xsd: <http://www.w3.org/2001/XMLSchema#>
    #   ASK {
    #     BIND(RAND() AS ?r)
    #     FILTER(DATATYPE(?r) = xsd:double && ?r >= 0.0 && ?r < 1.0)
    #   }
    #
    # @example SSE
    #   (prefix
    #    ((xsd: <http://www.w3.org/2001/XMLSchema#>))
    #    (ask
    #     (filter
    #      (&&
    #       (&& (= (datatype ?r) xsd:double) (>= ?r 0.0))
    #       (< ?r 1.0))
    #      (extend ((?r (rand)))
    #       (bgp)))))
    #
    # @see https://www.w3.org/TR/sparql11-query/#idp2130040
    class Rand < Operator::Nullary
      include Evaluatable

      NAME = :rand

      ##
      # Returns a pseudo-random number between 0 (inclusive) and 1.0e0 (exclusive). Different numbers can be produced every time this function is invoked. Numbers should be produced with approximately equal probability.
      #
      # @return [RDF::Literal::Double] random value
      def apply(**options)
        RDF::Literal::Double.new(Random.rand)
      end

      ##
      #
      # Returns a partial SPARQL grammar for this operator.
      #
      # Extracts projections
      #
      # @return [String]
      def to_sparql(**options)
        "RAND()"
      end
    end # Rand
  end # Operator
end; end # SPARQL::Algebra

Version data entries

8 entries across 8 versions & 1 rubygems

Version Path
sparql-3.3.1 lib/sparql/algebra/operator/rand.rb
sparql-3.3.0 lib/sparql/algebra/operator/rand.rb
sparql-3.2.6 lib/sparql/algebra/operator/rand.rb
sparql-3.2.5 lib/sparql/algebra/operator/rand.rb
sparql-3.2.4 lib/sparql/algebra/operator/rand.rb
sparql-3.2.3 lib/sparql/algebra/operator/rand.rb
sparql-3.2.1 lib/sparql/algebra/operator/rand.rb
sparql-3.2.0 lib/sparql/algebra/operator/rand.rb