RubyGems - nmoneys - Versions diffs - 2.1.0.0.20110901 → 2.2.0.0.20120213 - Mend

nmoneys 2.1.0.0.20110901 → 2.2.0.0.20120213

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

data/lib/NMoneys.dll CHANGED Viewed

Binary file

data/lib/NMoneys.xml CHANGED Viewed

@@ -4,6 +4,62 @@
         <name>NMoneys</name>
     </assembly>
     <members>
+        <member name="T:NMoneys.Allocators.IRemainderAllocator">
+            <summary>
+            Distributes the remainder after allocating the highest fair amount amongst all the recipients.
+            </summary>
+            <remarks>
+            IF the total amount to be allocated cannot be allocated to each recipient evenly, then
+            this will define the order in which recipients will be allocated the remainder left over
+            after an equal distribution is made.
+            <para>
+            This is not relevant if the total sum of money can be evenly distributed.
+            </para>
+            </remarks>
+            <example>
+            The classic example is that of a three-way split on a US dollar; after we
+            allocate each recipient 33 cents we have a cent left over. In this case the <see cref="T:NMoneys.Allocators.IRemainderAllocator"/>
+            will determine which recipient gets that extra penny.
+            </example>
+        </member>
+        <member name="M:NMoneys.Allocators.IRemainderAllocator.Allocate(NMoneys.Money,System.Collections.Generic.IList{System.Decimal})">
+            <summary>
+            Allocates the remainder after allocating the highest fair amount amongst all the recipients.
+            </summary>
+            <remarks>
+            At the end of the distribution, the sum of the amounts of <paramref name="alreadyAllocated"/> must be equal to the original amount to allocate.
+            <para>Implementors will increase the amounts of <paramref name="alreadyAllocated"/> according to whichever strategy is chosen to distribute the <paramref name="remainder"/>.</para>
+            <para>It may not be called at all if the money can be evently distributed in <see cref="M:NMoneys.Money.Allocate(System.Int32,NMoneys.Allocators.IRemainderAllocator)"/>.</para>
+            </remarks>
+            <param name="remainder">The remainder amount that might need to be allocated or <see cref="M:NMoneys.Money.Zero"/> if no remainder.</param>
+            <param name="alreadyAllocated">An array representing the evenly allocated amounts.
+            Its amounts will be modified according to the strategy chosen to allocate the <paramref name="remainder"/>.</param>
+        </member>
+        <member name="M:NMoneys.Allocators.RemainderAllocatorBase.apply(NMoneys.Money@,System.Collections.Generic.IList{System.Decimal},System.Int32)">
+            <summary>
+            Distributes the minimal amount to the specified result.
+            </summary>
+        </member>
+        <member name="M:NMoneys.PowerOfTen.Positive(NMoneys.Currency)">
+            <summary>
+            10 ^ <see cref="P:NMoneys.Currency.SignificantDecimalDigits"/>.
+            </summary>
+        </member>
+        <member name="M:NMoneys.PowerOfTen.Positive(System.Int32)">
+            <summary>
+            10 ^ <paramref name="numberOfDecimals"/>.
+            </summary>
+        </member>
+        <member name="M:NMoneys.PowerOfTen.Negative(NMoneys.Currency)">
+            <summary>
+            10 ^ -<see cref="P:NMoneys.Currency.SignificantDecimalDigits"/>.
+            </summary>
+        </member>
+        <member name="M:NMoneys.PowerOfTen.Negative(System.Int32)">
+            <summary>
+            10 ^ -<paramref name="numberOfDecimals"/>.
+            </summary>
+        </member>
         <member name="T:NMoneys.Currency">
             <summary>
              Represents a currency unit such as Euro or American Dollar.
@@ -557,6 +613,11 @@
             Indicates the number of decimal places to use in currency values.
             </summary>
         </member>
+        <member name="P:NMoneys.Currency.MinAmount">
+            <summary>
+            Represents the smalles amount that can be represented for the currency according to its <see cref="P:NMoneys.Currency.SignificantDecimalDigits"/>.
+            </summary>
+        </member>
         <member name="P:NMoneys.Currency.NativeName">
             <summary>
             Gets the name of the currency formatted in the native language of the country/region where the currency is used.
@@ -844,7 +905,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.ALL">
             <summary>
-            Albanian Lek
+            Lek
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.AMD">
@@ -854,7 +915,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.ANG">
             <summary>
-            Netherlands Antillian Guilder
+            Netherlands Antillean Guilder
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.AOA">
@@ -884,7 +945,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.BAM">
             <summary>
-            Convertible Marks
+            Convertible Mark
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.BBD">
@@ -894,7 +955,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.BDT">
             <summary>
-            Bangladeshi Taka
+            Taka
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.BGN">
@@ -929,12 +990,12 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.BOV">
             <summary>
-            Boliviano
+            Mvdol
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.BRL">
             <summary>
-            Real
+            Brazilian Real
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.BSD">
@@ -954,7 +1015,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.BYR">
             <summary>
-            Belarusian Ruble
+            Belarussian Ruble
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.BZD">
@@ -989,7 +1050,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.CLF">
             <summary>
-            Chilean Peso
+            Unidades de fomento
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.CLP">
@@ -1009,7 +1070,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.COU">
             <summary>
-            Colombian Peso
+            Unidad de Valor Real
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.CRC">
@@ -1094,7 +1155,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.GBP">
             <summary>
-            UK Pound Sterling
+            Pound Sterling
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.GEL">
@@ -1104,7 +1165,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.GHS">
             <summary>
-            Cedi
+            Ghana Cedi
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.GIP">
@@ -1124,7 +1185,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.GTQ">
             <summary>
-            Guatemalan Quetzal
+            Quetzal
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.GYD">
@@ -1139,7 +1200,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.HNL">
             <summary>
-            Honduran Lempira
+            Lempira
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.HRK">
@@ -1154,17 +1215,17 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.HUF">
             <summary>
-            Hungarian Forint
+            Forint
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.IDR">
             <summary>
-            Indonesian Rupiah
+            Rupiah
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.ILS">
             <summary>
-            Israeli New Shekel
+            New Israeli Sheqel
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.INR">
@@ -1184,7 +1245,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.ISK">
             <summary>
-            Icelandic Krona
+            Iceland Krona
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.JMD">
@@ -1199,7 +1260,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.JPY">
             <summary>
-            Japanese Yen
+            Yen
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.KES">
@@ -1209,7 +1270,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.KGS">
             <summary>
-            som
+            Som
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.KMF">
@@ -1229,7 +1290,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.KRW">
             <summary>
-            Korean Won
+            Won
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.KWD">
@@ -1304,7 +1365,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.MKD">
             <summary>
-            Macedonian Denar
+            Denar
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.MMK">
@@ -1319,7 +1380,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.MOP">
             <summary>
-            Macao Pataca
+            Pataca
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.MRO">
@@ -1349,7 +1410,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.MXV">
             <summary>
-            Mexican Peso
+            Mexican Unidad de Inversion (UDI)
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.MYR">
@@ -1359,22 +1420,22 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.MZN">
             <summary>
-            Metical
+            Mozambique Metical
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.NAD">
             <summary>
-            Namibian Dollar
+            Namibia Dollar
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.NGN">
             <summary>
-            Nigerian Naira
+            Naira
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.NIO">
             <summary>
-            Nicaraguan Cordoba Oro
+            Cordoba Oro
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.NOK">
@@ -1384,7 +1445,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.NPR">
             <summary>
-            Nepalese Rupees
+            Nepalese Rupee
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.NZD">
@@ -1394,17 +1455,17 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.OMR">
             <summary>
-            Omani Rial
+            Rial Omani
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.PAB">
             <summary>
-            Panamanian Balboa
+            Balboa
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.PEN">
             <summary>
-            Peruvian Nuevo Sol
+            Nuevo Sol
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.PGK">
@@ -1424,12 +1485,12 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.PLN">
             <summary>
-            Polish Zloty
+            Zloty
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.PYG">
             <summary>
-            Paraguay Guarani
+            Guarani
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.QAR">
@@ -1439,7 +1500,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.RON">
             <summary>
-            Romanian Leu
+            New Romanian Leu
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.RSD">
@@ -1454,7 +1515,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.RWF">
             <summary>
-            Rwandan Franc
+            Rwanda Franc
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.SAR">
@@ -1519,7 +1580,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.SVC">
             <summary>
-            US Dollar
+            El Salvador Colon
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.SYP">
@@ -1534,17 +1595,17 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.THB">
             <summary>
-            Thai Baht
+            Baht
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.TJS">
             <summary>
-            Ruble
+            Somoni
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.TMT">
             <summary>
-            Turkmen manat
+            Turkmenistan New Manat
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.TND">
@@ -1564,7 +1625,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.TTD">
             <summary>
-            Trinidad Dollar
+            Trinidad and Tobago Dollar
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.TWD">
@@ -1579,7 +1640,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.UAH">
             <summary>
-            Ukrainian Grivna
+            Hryvnia
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.UGX">
@@ -1604,7 +1665,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.UYI">
             <summary>
-            Peso Uruguayo
+            >Uruguay Peso en Unidades Indexadas (URUIURUI)
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.UYU">
@@ -1614,17 +1675,17 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.UZS">
             <summary>
-            Uzbekistan Som
+            Uzbekistan Sum
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.VEF">
             <summary>
-            Venezuelan Bolivar
+            Bolivar Fuerte
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.VND">
             <summary>
-            Vietnamese Dong
+            Dong
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.VUV">
@@ -1654,7 +1715,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.XBA">
             <summary>
-            Bond Markets Units European Composite Unit (EURCO)
+            European Composite Unit (EURCO)
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.XBB">
@@ -1679,7 +1740,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.XDR">
             <summary>
-            SDR
+            SDR (Special Drawing Right)
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.XOF">
@@ -1729,7 +1790,7 @@
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.ZAR">
             <summary>
-            South African Rand
+            Rand
             </summary>
         </member>
         <member name="F:NMoneys.CurrencyIsoCode.ZMK">
@@ -1790,6 +1851,14 @@
             The alphabetic ISO 4217 code of the <see cref="T:NMoneys.CurrencyIsoCode"/>
             </summary>
         </member>
+        <member name="M:NMoneys.IsoCodeExtensions.AsCurrency(NMoneys.CurrencyIsoCode)">
+            <summary>
+            Obtains the instance of Currency associated to the CurrencyIsoCode specified.
+            </summary>
+            <param name="isoCode">ISO 4217 code</param>
+            <returns>The instance of <see cref="T:NMoneys.Currency"/> represented by the <paramref name="isoCode"/>.</returns>
+            <seealso cref="M:NMoneys.Currency.Get(NMoneys.CurrencyIsoCode)"/>
+        </member>
         <member name="T:NMoneys.MisconfiguredCurrencyException">
             <summary>
             The exception that is thrown when a currency has not been properly configured.
@@ -1878,234 +1947,256 @@
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Aud(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Aud"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Cad(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Cad"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Chf(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Chf"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Cny(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Cny"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Dkk(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Dkk"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Eur(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Eur"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Gbp(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Gbp"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Hkd(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Hkd"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Huf(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Huf"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Inr(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Inr"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Jpy(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Jpy"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Mxn(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Mxn"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Myr(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Myr"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Nok(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Nok"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Nzd(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Nzd"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Rub(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Rub"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Sek(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Sek"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Sgd(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Sgd"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Thb(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Thb"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Usd(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Usd"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Zar(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Zar"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Xxx(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Xxx"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Xts(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Xts"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Euros(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Euro"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Dollars(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Dollar"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Pounds(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Pound"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Lerus(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Eur"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Bucks(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Usd"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.Quid(System.Decimal)">
             <summary>
-            Creates an <see cref="T:NMoneys.Money"/> instance with the specified currency.
+            Creates an <see cref="T:NMoneys.Money"/> instance with the specified NMoneys.Currency.
             </summary>
             <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
             <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <see cref="F:NMoneys.Currency.Gbp"/>.</returns>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.ToMoney(NMoneys.CurrencyIsoCode,System.Decimal)">
-            <summary>Creates a <see cref="T:NMoneys.Money"/> instance with the specified amount and currency.</summary>
+            <summary>Creates a <see cref="T:NMoneys.Money"/> instance with the specified amount and NMoneys.Currency.</summary>
              <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
              <param name="currency">The <see cref="P:NMoneys.Money.CurrencyCode"/> of the monetary quantity.</param>
              <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <paramref name="currency"/>.</returns>
              <seealso cref="M:NMoneys.Money.#ctor(System.Decimal,NMoneys.CurrencyIsoCode)"/>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.ToMoney(System.Decimal)">
-            <summary>Creates a <see cref="T:NMoneys.Money"/> instance with the specified amount and unspecified currency.</summary>
+            <summary>Creates a <see cref="T:NMoneys.Money"/> instance with the specified amount and unspecified NMoneys.Currency.</summary>
              <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
              <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and unspecified currency (<see cref="F:NMoneys.CurrencyIsoCode.XXX"/>).</returns>
              <seealso cref="M:NMoneys.Money.#ctor(System.Decimal)"/>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.ToMoney(System.Decimal,NMoneys.CurrencyIsoCode)">
-            <summary>Creates a <see cref="T:NMoneys.Money"/> instance with the specified amount and currency.</summary>
+            <summary>Creates a <see cref="T:NMoneys.Money"/> instance with the specified amount and NMoneys.Currency.</summary>
              <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
              <param name="currency">The <see cref="P:NMoneys.Money.CurrencyCode"/> of the monetary quantity.</param>
              <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <paramref name="currency"/>.</returns>
              <seealso cref="M:NMoneys.Money.#ctor(System.Decimal,NMoneys.CurrencyIsoCode)"/>
         </member>
         <member name="M:NMoneys.Extensions.MoneyExtensions.ToMoney(System.Decimal,NMoneys.Currency)">
-            <summary>Creates a <see cref="T:NMoneys.Money"/> instance with the specified amount and currency.</summary>
+            <summary>Creates a <see cref="T:NMoneys.Money"/> instance with the specified amount and NMoneys.Currency.</summary>
              <param name="amount">The <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
              <param name="currency">The incarnation of the <see cref="P:NMoneys.Money.CurrencyCode"/>.</param>
              <returns>A <see cref="T:NMoneys.Money"/> with the specified <paramref name="amount"/> and <paramref name="currency"/>.</returns>
              <seealso cref="M:NMoneys.Money.#ctor(System.Decimal,NMoneys.Currency)"/>
         </member>
+        <member name="M:NMoneys.Extensions.MoneyExtensions.ToMoney(System.Collections.Generic.IEnumerable{System.Decimal},NMoneys.CurrencyIsoCode)">
+            <summary>Creates an array of <see cref="T:NMoneys.Money"/> instances all with the specified currency and the corresponding amount.</summary>
+             <param name="amounts">Each of the <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
+             <param name="currency">The <see cref="P:NMoneys.Money.CurrencyCode"/> of the monetary quantity.</param>
+             <returns>An array of <see cref="T:NMoneys.Money"/> with the same length as <paramref name="amounts"/> and each member with the specified
+             amount and <paramref name="currency"/>.</returns>
+             <seealso cref="M:NMoneys.Extensions.MoneyExtensions.ToMoney(System.Decimal,NMoneys.CurrencyIsoCode)"/>
+        </member>
+        <member name="M:NMoneys.Extensions.MoneyExtensions.ToMoney(System.Collections.Generic.IEnumerable{System.Decimal},NMoneys.Currency)">
+            <summary>Creates an array of <see cref="T:NMoneys.Money"/> instances all with the specified currency and the corresponding amount.</summary>
+             <param name="amounts">Each of the <see cref="P:NMoneys.Money.Amount"/> of the monetary quantity.</param>
+             <param name="currency">The incarnation of the <see cref="P:NMoneys.Money.CurrencyCode"/>.</param>
+             <returns>An array of <see cref="T:NMoneys.Money"/> with the same length as <paramref name="amounts"/> and each member with the specified
+             amount and <paramref name="currency"/>.</returns>
+             <seealso cref="M:NMoneys.Extensions.MoneyExtensions.ToMoney(System.Decimal,NMoneys.Currency)"/>
+        </member>
+        <member name="M:NMoneys.Extensions.MoneyExtensions.Currency(NMoneys.Money)">
+            <summary>
+            The currency instance of <paramref name="money"/>.
+            </summary>
+            <returns>The instance of <see cref="M:NMoneys.Extensions.MoneyExtensions.Currency(NMoneys.Money)"/> represented by <see cref="P:NMoneys.Money.CurrencyCode"/>.</returns>
+        </member>
         <member name="T:NMoneys.CharacterReference">
             <summary>
             Represents a reserved character in an HTML/XML document.
@@ -2250,6 +2341,48 @@
             Allows ignore raising multiple events for single obsolete currency.
             </summary>
         </member>
+        <member name="T:NMoneys.RemainderAllocator">
+            <summary>
+            Factory class for provided implementations of <see cref="T:NMoneys.Allocators.IRemainderAllocator"/>
+            </summary>
+        </member>
+        <member name="F:NMoneys.RemainderAllocator.FirstToLast">
+            <summary>
+            Allocate the remainder to the first known recipient and keep going in order towards
+            the last recipient until the remainder has been fully allocated.
+            </summary>
+            <remarks>
+            In the case of a dollar split three ways the extra penny to the first receipient
+            and the allocation is done.
+            </remarks>
+        </member>
+        <member name="F:NMoneys.RemainderAllocator.LastToFirst">
+            <summary>
+            Allocate the remainder to the last known recipient and keep going in order towards
+            the first recipient until the remainder has been fully allocated.
+            </summary>
+            <remarks>
+            In the case of a dollar split three ways the extra penny to the first receipient
+            and the allocation is done.
+            </remarks>
+        </member>
+        <member name="F:NMoneys.RemainderAllocator.Random">
+            <summary>
+            Allocate the remainder to a randomly selected recipient and keep going using another randomly
+            selected recipient until the remainder has been fully allocated.
+            </summary>
+            <remarks>
+            In the case of the dollar split three ways randomly, the recipient that gets the extra penny is indeterminate.
+            <para>
+            This <see cref="T:NMoneys.Allocators.IRemainderAllocator"/> is much slower than either <see cref="T:NMoneys.Allocators.FirstToLastAllocator"/>
+            or <see cref="T:NMoneys.Allocators.LastToFirstAllocator"/>. In addition, this particular implementation *could* arguably
+            be made even more random. See the referenced links for some other implementation ideas that might
+            enhance perf and/or randomness.
+            </para>
+            <seealso href="http://stackoverflow.com/questions/48087/select-a-random-n-elements-from-listt-in-c-sharp"/>
+            <seealso href="http://www.fsmpi.uni-bayreuth.de/~dun3/archives/return-random-subset-of-n-elements-of-a-given-array/98.html"/>
+            </remarks>
+        </member>
         <member name="T:NMoneys.Serialization.CurrencyCodeConverter">
             <summary>
             Provides JavaScript Object Notation (JSON) format conversions for <see cref="T:NMoneys.CurrencyIsoCode"/>.
@@ -3156,6 +3289,28 @@
             <returns>a <see cref="T:NMoneys.Money"/> with <see cref="P:NMoneys.Money.Amount"/> as the result of applying <paramref name="unaryOperation"/> to the previous <see cref="P:NMoneys.Money.Amount"/>.</returns>
             <exception cref="T:System.ArgumentNullException"><paramref name="unaryOperation"/> is null.</exception>
         </member>
+        <member name="M:NMoneys.Money.Allocate(System.Int32,NMoneys.Allocators.IRemainderAllocator)">
+            <summary>
+            Allocates the sum of money fully and 'fairly', delegating the distribution of whichever remainder after
+            allocating the highest fair amount amongst the recipients to the provided <paramref name="allocator"/>.
+            </summary>
+            <remarks>
+            <para>
+            A sum of money that can be allocated to each recipient exactly evenly is inherently 'fair'. For example, a US
+            Dollar split four (4) ways leaves each recipient with 25 cents.</para>
+            <para>
+            A US Dollar split three (3) ways cannot be distributed evenly and is therefore inherently 'unfair'. The
+            best we can do is minimize the amount of the remainder (in this case a cent) and allocate it in a way
+            that seems random and thus fair to the recipients.</para>
+            <para>The precision to use for rounding will be the <see cref="P:NMoneys.Currency.SignificantDecimalDigits"/>
+            of the currency represented by <see cref="P:NMoneys.Money.CurrencyCode"/>.</para>
+            </remarks>
+            <param name="numberOfRecipients">The number of times to split up the total.</param>
+            <param name="allocator">The <see cref="T:NMoneys.Allocators.IRemainderAllocator"/> that will distribute the remainder after an even split.</param>
+            <returns>The results of the allocation as an array with a length equal to <paramref name="numberOfRecipients"/>.</returns>
+            <exception cref="T:System.ArithmeticException">The <paramref name="allocator"/> did not distributed all the remainder.</exception>
+            <seealso cref="T:NMoneys.Allocators.IRemainderAllocator"/>
+        </member>
         <member name="M:NMoneys.Money.GetObjectData(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
             <summary>
             Populates a <see cref="T:System.Runtime.Serialization.SerializationInfo"/> with the data needed to serialize the target object.
@@ -3307,6 +3462,13 @@
             <para>For example, 'EUR 2.35' will return a minor amount of 235, since EUR has 2 significant decimal values.
             'BHD -1.345' will return -1345.</para></remarks>
         </member>
+        <member name="P:NMoneys.Money.MinValue">
+            <summary>
+            Represents the smallest quantity that couldn be represented using the currency corresponding to <see cref="P:NMoneys.Money.CurrencyCode"/>.
+            <seealso cref="P:NMoneys.Currency.MinAmount"/>
+            <seealso cref="P:NMoneys.Currency.SignificantDecimalDigits"/>
+            </summary>
+        </member>
         <member name="P:NMoneys.Money.HasDecimals">
             <summary>
             Specifies whether the <see cref="P:NMoneys.Money.Amount"/> is not a whole number.

metadata CHANGED Viewed

@@ -1,67 +1,47 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification
 name: nmoneys
-version: !ruby/object:Gem::Version
-  prerelease: false
-  segments:
-  - 2
-  - 1
-  - 0
-  - 0
-  - 20110901
-  version: 2.1.0.0.20110901
+version: !ruby/object:Gem::Version
+  version: 2.2.0.0.20120213
+  prerelease:
 platform: ruby
-authors:
+authors:
 - Daniel Gonzalez Garcia
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2011-09-01 00:00:00 +02:00
-default_executable:
+date: 2012-02-13 00:00:00.000000000 Z
 dependencies: []
-description: NMoneys is an implementation of the Money Value Object to support representing moneys in the currencies defined in the ISO 4217 standard
+description: NMoneys is an implementation of the Money Value Object to support representing
+  moneys in the currencies defined in the ISO 4217 standard
 email: nmoneys@googlegroups.com
 executables: []
 extensions: []
 extra_rdoc_files: []
-files:
+files:
 - lib/NMoneys.dll
 - lib/NMoneys.xml
-has_rdoc: true
 homepage: http://code.google.com/p/nmoneys/
 licenses: []
 post_install_message:
 rdoc_options: []
-require_paths:
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements:
-  - - ">="
-    - !ruby/object:Gem::Version
-      segments:
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements:
-  - - ">="
-    - !ruby/object:Gem::Version
-      segments:
-      - 0
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
 rubyforge_project: nmoneys
-rubygems_version: 1.3.7
+rubygems_version: 1.8.11
 signing_key:
 specification_version: 3
 summary: NMoneys - .Net implementation of Money Value Object
 test_files: []