class BigDecimal

Constants

DEFAULT_STRING_FORMAT
YAML_MAPPING
YAML_TAG

Public Instance Methods

_original_to_s(format = DEFAULT_STRING_FORMAT) click to toggle source
Alias for: to_s
as_json(options = nil) click to toggle source

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.

# File lib/active_support/json/encoding.rb, line 194
def as_json(options = nil) to_s end
encode_with(coder) click to toggle source
# 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_d() click to toggle source
# File lib/active_support/core_ext/big_decimal/conversions.rb, line 34
def to_d
  self
end
to_formatted_s(format = DEFAULT_STRING_FORMAT) click to toggle source
# File lib/active_support/core_ext/big_decimal/conversions.rb, line 39
def to_formatted_s(format = DEFAULT_STRING_FORMAT)
  _original_to_s(format)
end
Also aliased as: to_s
to_s(format = DEFAULT_STRING_FORMAT) click to toggle source
Also aliased as: _original_to_s
Alias for: to_formatted_s
to_yaml(opts = {}) click to toggle source

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.

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