Class: BigDecimal

Inherits:
Object show all
Defined in:
lib/active_support/json/encoding.rb,
lib/active_support/core_ext/object/duplicable.rb,
lib/active_support/core_ext/big_decimal/conversions.rb

Constant Summary collapse

YAML_TAG =
'tag:yaml.org,2002:float'
YAML_MAPPING =
{ 'Infinity' => '.Inf', '-Infinity' => '-.Inf', 'NaN' => '.NaN' }
DEFAULT_STRING_FORMAT =
'F'

Instance Method Summary collapse

Instance Method Details

#as_json(options = nil) ⇒ Object

A BigDecimal would be naturally represented as a JSON number. Most libraries, however, parse non-integer JSON numbers directly as floats. Clients using those libraries would get in general a wrong number and no way to recover other than manually inspecting the string with the JSON code itself.

That’s why a JSON string is returned. The JSON literal is not numeric, but if the other end knows by contract that the data is supposed to be a BigDecimal, it still has the chance to post-process the string and get the real value.



198
# File 'lib/active_support/json/encoding.rb', line 198

def as_json(options = nil) to_s end

#encode_with(coder) ⇒ Object



29
30
31
32
# File 'lib/active_support/core_ext/big_decimal/conversions.rb', line 29

def encode_with(coder)
  string = to_s
  coder.represent_scalar(nil, YAML_MAPPING[string] || string)
end

#to_dObject



36
37
38
# File 'lib/active_support/core_ext/big_decimal/conversions.rb', line 36

def to_d
  self
end

#to_formatted_s(format = DEFAULT_STRING_FORMAT) ⇒ Object Also known as: to_s



42
43
44
# File 'lib/active_support/core_ext/big_decimal/conversions.rb', line 42

def to_formatted_s(format = DEFAULT_STRING_FORMAT)
  _original_to_s(format)
end

#to_yaml(opts = {}) ⇒ Object

This emits the number without any scientific notation. This is better than self.to_f.to_s since it doesn’t lose precision.

Note that reconstituting YAML floats to native floats may lose precision.



18
19
20
21
22
23
24
25
26
27
# File 'lib/active_support/core_ext/big_decimal/conversions.rb', line 18

def to_yaml(opts = {})
  return super if
    (defined?(YAML::ENGINE) && !YAML::ENGINE.syck?) ||
    (defined?(Psych) && YAML == Psych)

  YAML.quick_emit(nil, opts) do |out|
    string = to_s
    out.scalar(YAML_TAG, YAML_MAPPING[string] || string, :plain)
  end
end