Class: BigDecimal

Inherits:
Object show all
Defined in:
activesupport/lib/active_support/json/encoding.rb,
activesupport/lib/active_support/core_ext/object/duplicable.rb,
activesupport/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 'activesupport/lib/active_support/json/encoding.rb', line 198

def as_json(options = nil) to_s end

#encode_with(coder) ⇒ Object



27
28
29
30
# File 'activesupport/lib/active_support/core_ext/big_decimal/conversions.rb', line 27

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

#to_dObject



34
35
36
# File 'activesupport/lib/active_support/core_ext/big_decimal/conversions.rb', line 34

def to_d
  self
end

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



40
41
42
# File 'activesupport/lib/active_support/core_ext/big_decimal/conversions.rb', line 40

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
# File 'activesupport/lib/active_support/core_ext/big_decimal/conversions.rb', line 18

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

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