Sha256: fae53b3f559001900dddf2717e363b31342a311e5178102c7d9540cdbe148e76

Contents?: true

Size: 1.56 KB

Versions: 8

Compression:

Stored size: 1.56 KB

Contents

module SPARQL; module Algebra
  class Operator
    ##
    # The SPARQL `str` operator.
    #
    # [121] BuiltInCall ::= ... | 'STR' '(' Expression ')' 
    #
    # @example SPARQL Grammar
    #   PREFIX  xsd: <http://www.w3.org/2001/XMLSchema#>
    #   PREFIX  : <http://example.org/things#>
    #   SELECT  ?x ?v
    #   WHERE
    #       { ?x :p ?v . 
    #         FILTER ( str(?v) = "1" ) .
    #       }
    #
    # @example SSE
    #   (prefix ((xsd: <http://www.w3.org/2001/XMLSchema#>)
    #            (: <http://example.org/things#>))
    #     (project (?x ?v)
    #       (filter (= (str ?v) "1")
    #         (bgp (triple ?x :p ?v)))))
    #
    # @see https://www.w3.org/TR/sparql11-query/#func-str
    class Str < Operator::Unary
      include Evaluatable

      NAME = :str

      ##
      # Returns the string form of the operand.
      #
      # @param  [RDF::Literal, RDF::URI] term
      #   a literal or IRI
      # @return [RDF::Literal] a simple literal
      # @raise  [TypeError] if the operand is not a literal or IRI
      def apply(term, **options)
        case term
          when RDF::Literal then RDF::Literal(term.value)
          when RDF::URI     then RDF::Literal(term.to_s)
          else raise TypeError, "expected an RDF::Literal or RDF::URI, but got #{term.inspect}"
        end
      end

      ##
      #
      # Returns a partial SPARQL grammar for this operator.
      #
      # @return [String]
      def to_sparql(**options)
        "str(" + operands.first.to_sparql(**options) + ")"
      end
    end # Str
  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/str.rb
sparql-3.3.0 lib/sparql/algebra/operator/str.rb
sparql-3.2.6 lib/sparql/algebra/operator/str.rb
sparql-3.2.5 lib/sparql/algebra/operator/str.rb
sparql-3.2.4 lib/sparql/algebra/operator/str.rb
sparql-3.2.3 lib/sparql/algebra/operator/str.rb
sparql-3.2.1 lib/sparql/algebra/operator/str.rb
sparql-3.2.0 lib/sparql/algebra/operator/str.rb