Class: BigDecimal
- Defined in:
- activesupport/lib/active_support/json/encoding.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
-
#as_json(options = nil) ⇒ Object
A BigDecimal would be naturally represented as a JSON number.
- #encode_with(coder) ⇒ Object
- #to_d ⇒ Object
- #to_formatted_s(format = DEFAULT_STRING_FORMAT) ⇒ Object (also: #to_s)
-
#to_yaml(opts = {}) ⇒ Object
This emits the number without any scientific notation.
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.
201 |
# File 'activesupport/lib/active_support/json/encoding.rb', line 201 def as_json( = 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_d ⇒ Object
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 |