nmoneys 2.1.0.0.20110901 → 2.2.0.0.20120213

data/lib/NMoneys.xml

@@ -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

@@ -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: []
-