# Class: RDF::Literal::Decimal

Inherits:
Numeric
show all
Defined in:
lib/rdf/model/literal/decimal.rb

## Overview

A decimal literal.

Examples:

Arithmetic with decimal literals

``````RDF::Literal(BigDecimal('1.0')) + 0.5   #=> RDF::Literal(BigDecimal('1.5'))
RDF::Literal(BigDecimal('1.0')) - 0.5   #=> RDF::Literal(BigDecimal('0.5'))
RDF::Literal(BigDecimal('1.0')) * 0.5   #=> RDF::Literal(BigDecimal('0.5'))
RDF::Literal(BigDecimal('1.0')) / 0.5   #=> RDF::Literal(BigDecimal('2.0'))``````

Since:

• 0.2.1

Integer

## Constant Summary

DATATYPE =

Since:

• 0.2.1

`RDF::XSD.decimal`
GRAMMAR =

Since:

• 0.2.1

`/^[\+\-]?\d+(\.\d*)?\$/.freeze`

## Instance Method Summary collapse

• Returns the absolute value of `self`.

• Converts this literal into its canonical lexical representation.

• Returns the smallest integer greater than or equal to `self`.

• Returns the largest integer less than or equal to `self`.

• constructor

A new instance of Decimal.

• Returns `self` if the value is not zero, `nil` otherwise.

• Returns the number with no fractional part that is closest to the argument.

• Returns the value as a string.

• Returns `true` if the value is zero.

### Methods inherited from Numeric

#*, #+, #+@, #-, #-@, #/, #<=>, #==, #to_d, #to_f, #to_i, #to_r

## Constructor Details

### #initialize(value, datatype: nil, lexical: nil, **options) ⇒ Decimal

Returns a new instance of Decimal

Parameters:

• value (String, BidDecimal, Numeric)
• value (Object)
• language (Symbol)

(nil) Language is downcased to ensure proper matching

• lexical (String)

(nil) Supplied lexical representation of this literal, otherwise it comes from transforming `value` to a string form..

• datatype (URI)

(nil)

• validate (Boolean)

(false)

• canonicalize (Boolean)

(false)

Since:

• 0.2.1

 ``` 20 21 22 23 24 25 26 27 28 29 30 31 32``` ```# File 'lib/rdf/model/literal/decimal.rb', line 20 def initialize(value, datatype: nil, lexical: nil, **options) @datatype = RDF::URI(datatype || self.class.const_get(:DATATYPE)) @string = lexical || (value if value.is_a?(String)) @object = case when value.is_a?(::BigDecimal) then value when value.is_a?(::Float) then BigDecimal(value.to_s) when value.is_a?(::Numeric) then BigDecimal(value) else value = value.to_s value += "0" if value.end_with?(".") # Normalization required in Ruby 2.4 BigDecimal(value) rescue nil end end```

## Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class RDF::Literal

## Instance Method Details

### #abs ⇒ RDF::Literal

Returns the absolute value of `self`.

Returns:

Since:

• 0.2.3

 ``` 59 60 61``` ```# File 'lib/rdf/model/literal/decimal.rb', line 59 def abs (d = to_d) && d > 0 ? self : RDF::Literal(d.abs) end```

### #canonicalize! ⇒ RDF::Literal

Converts this literal into its canonical lexical representation.

Returns:

• `self`

Since:

• 0.2.1

 ``` 39 40 41 42 43 44 45 46 47 48 49 50 51 52``` ```# File 'lib/rdf/model/literal/decimal.rb', line 39 def canonicalize! # Can't use simple %f transformation due to special requirements from # N3 tests in representation @string = begin i, f = @object.to_s('F').split('.') i.sub!(/^\+?0+(\d)\$/, '\1') # remove the optional leading '+' sign and any extra leading zeroes f = f[0, 16] # truncate the fractional part after 15 decimal places f.sub!(/0*\$/, '') # remove any trailing zeroes f = '0' if f.empty? # ...but there must be a digit to the right of the decimal point "#{i}.#{f}" end @object = BigDecimal(@string) unless @object.nil? self end```

### #ceil ⇒ RDF::Literal

Returns the smallest integer greater than or equal to `self`.

Examples:

``RDF::Literal(1).ceil            #=> RDF::Literal(1)``

Returns:

Since:

• 0.2.1

 ``` 78 79 80``` ```# File 'lib/rdf/model/literal/decimal.rb', line 78 def ceil self.class.new(to_d.ceil) end```

### #floor ⇒ RDF::Literal

Returns the largest integer less than or equal to `self`.

Examples:

``RDF::Literal(1).floor            #=> RDF::Literal(1)``

Returns:

Since:

• 0.2.1

 ``` 89 90 91``` ```# File 'lib/rdf/model/literal/decimal.rb', line 89 def floor self.class.new(to_d.floor) end```

### #nonzero? ⇒ Boolean

Returns `self` if the value is not zero, `nil` otherwise.

Returns:

Since:

• 0.2.3

 ``` 107 108 109``` ```# File 'lib/rdf/model/literal/decimal.rb', line 107 def nonzero? to_d.nonzero? ? self : nil end```

### #round ⇒ RDF::Literal

Returns the number with no fractional part that is closest to the argument. If there are two such numbers, then the one that is closest to positive infinity is returned. An error is raised if arg is not a numeric value.

Returns:

Since:

• 0.2.1

 ``` 67 68 69``` ```# File 'lib/rdf/model/literal/decimal.rb', line 67 def round self.class.new(to_d.round) end```

### #to_s ⇒ String

Returns the value as a string.

Returns:

• (String)

• BigDecimal#to_s

Since:

• 0.2.1

 ``` 116 117 118``` ```# File 'lib/rdf/model/literal/decimal.rb', line 116 def to_s @string || @object.to_s('F') end```

### #zero? ⇒ Boolean

Returns `true` if the value is zero.

Returns:

Since:

• 0.2.3

 ``` 98 99 100``` ```# File 'lib/rdf/model/literal/decimal.rb', line 98 def zero? to_d.zero? end```