Class String
In: lib/money/core_extensions.rb
Parent: Object

Open String to add new methods.

Methods

Public Instance methods

Converts the current string into a Currency object.

@return [Money::Currency]

@raise [Money::Currency::UnknownCurrency]

  If this String reference an unknown currency.

@example

  "USD".to_currency #=> #<Money::Currency id: usd>

Parses the current string and converts it to a Money object. Excess characters will be discarded.

@param [Currency, String, Symbol] currency

  The currency to set the resulting +Money+ object to.

@return [Money]

@example

  '100'.to_money                #=> #<Money @cents=10000>
  '100.37'.to_money             #=> #<Money @cents=10037>
  '100 USD'.to_money            #=> #<Money @cents=10000, @currency=#<Money::Currency id: usd>>
  'USD 100'.to_money            #=> #<Money @cents=10000, @currency=#<Money::Currency id: usd>>
  '$100 USD'.to_money           #=> #<Money @cents=10000, @currency=#<Money::Currency id: usd>>
  'hello 2000 world'.to_money   #=> #<Money @cents=200000 @currency=#<Money::Currency id: usd>>

@see Money.from_string

[Validate]