private double AsBaseNumericType(ElectricCurrentUnit unit)
{
if (Unit == unit)
{
return(_value);
}
var baseUnitValue = AsBaseUnit();
switch (unit)
{
case ElectricCurrentUnit.Ampere: return(baseUnitValue);
case ElectricCurrentUnit.Centiampere: return((baseUnitValue) / 1e-2d);
case ElectricCurrentUnit.Kiloampere: return((baseUnitValue) / 1e3d);
case ElectricCurrentUnit.Megaampere: return((baseUnitValue) / 1e6d);
case ElectricCurrentUnit.Microampere: return((baseUnitValue) / 1e-6d);
case ElectricCurrentUnit.Milliampere: return((baseUnitValue) / 1e-3d);
case ElectricCurrentUnit.Nanoampere: return((baseUnitValue) / 1e-9d);
case ElectricCurrentUnit.Picoampere: return((baseUnitValue) / 1e-12d);
default:
throw new NotImplementedException($"Can not convert {Unit} to {unit}.");
}
}
/// <summary>
/// Dynamically convert from value and unit enum <see cref="ElectricCurrentUnit" /> to <see cref="ElectricCurrent" />.
/// </summary>
/// <param name="value">Value to convert from.</param>
/// <param name="fromUnit">Unit to convert from.</param>
/// <returns>ElectricCurrent unit value.</returns>
public static ElectricCurrent?From(double?value, ElectricCurrentUnit fromUnit)
{
if (!value.HasValue)
{
return(null);
}
switch (fromUnit)
{
case ElectricCurrentUnit.Ampere:
return(FromAmperes(value.Value));
case ElectricCurrentUnit.Kiloampere:
return(FromKiloamperes(value.Value));
case ElectricCurrentUnit.Megaampere:
return(FromMegaamperes(value.Value));
case ElectricCurrentUnit.Microampere:
return(FromMicroamperes(value.Value));
case ElectricCurrentUnit.Milliampere:
return(FromMilliamperes(value.Value));
case ElectricCurrentUnit.Nanoampere:
return(FromNanoamperes(value.Value));
default:
throw new NotImplementedException("fromUnit: " + fromUnit);
}
}
/// <summary>
/// Dynamically convert from value and unit enum <see cref="ElectricCurrentUnit" /> to <see cref="ElectricCurrent" />.
/// </summary>
/// <param name="val">Value to convert from.</param>
/// <param name="fromUnit">Unit to convert from.</param>
/// <returns>ElectricCurrent unit value.</returns>
public static ElectricCurrent From(double val, ElectricCurrentUnit fromUnit)
{
switch (fromUnit)
{
case ElectricCurrentUnit.Ampere:
return(FromAmperes(val));
case ElectricCurrentUnit.Kiloampere:
return(FromKiloamperes(val));
case ElectricCurrentUnit.Megaampere:
return(FromMegaamperes(val));
case ElectricCurrentUnit.Microampere:
return(FromMicroamperes(val));
case ElectricCurrentUnit.Milliampere:
return(FromMilliamperes(val));
case ElectricCurrentUnit.Nanoampere:
return(FromNanoamperes(val));
default:
throw new NotImplementedException("fromUnit: " + fromUnit);
}
}
/// <summary>
/// Creates an instance of if the base units class that represents the base units for a quantity.
/// All quantities, both base and derived, can be represented by a combination of these seven base units.
/// </summary>
/// <param name="length">The length unit (L).</param>
/// <param name="mass">The mass unit (M).</param>
/// <param name="time">The time unit (T).</param>
/// <param name="current">The electric current unit (I).</param>
/// <param name="temperature">The temperature unit (Θ).</param>
/// <param name="amount">The amount of substance unit (N).</param>
/// <param name="luminousIntensity">The luminous intensity unit (J).</param>
public BaseUnits(
LengthUnit length = LengthUnit.Undefined,
MassUnit mass = MassUnit.Undefined,
DurationUnit time = DurationUnit.Undefined,
ElectricCurrentUnit current = ElectricCurrentUnit.Undefined,
TemperatureUnit temperature = TemperatureUnit.Undefined,
AmountOfSubstanceUnit amount = AmountOfSubstanceUnit.Undefined,
LuminousIntensityUnit luminousIntensity = LuminousIntensityUnit.Undefined)
{
Length = length;
Mass = mass;
Time = time;
Current = current;
Temperature = temperature;
Amount = amount;
LuminousIntensity = luminousIntensity;
IsFullyDefined = Length != LengthUnit.Undefined &&
Mass != MassUnit.Undefined &&
Time != DurationUnit.Undefined &&
Current != ElectricCurrentUnit.Undefined &&
Temperature != TemperatureUnit.Undefined &&
Amount != AmountOfSubstanceUnit.Undefined &&
LuminousIntensity != LuminousIntensityUnit.Undefined;
}
public static ElectricCurrent From(QuantityValue value, ElectricCurrentUnit fromUnit)
#endif
{
switch (fromUnit)
{
case ElectricCurrentUnit.Ampere:
return(FromAmperes(value));
case ElectricCurrentUnit.Kiloampere:
return(FromKiloamperes(value));
case ElectricCurrentUnit.Megaampere:
return(FromMegaamperes(value));
case ElectricCurrentUnit.Microampere:
return(FromMicroamperes(value));
case ElectricCurrentUnit.Milliampere:
return(FromMilliamperes(value));
case ElectricCurrentUnit.Nanoampere:
return(FromNanoamperes(value));
case ElectricCurrentUnit.Picoampere:
return(FromPicoamperes(value));
default:
throw new NotImplementedException("fromUnit: " + fromUnit);
}
}
/// <summary>
/// Convert to the unit representation <paramref name="unit" />.
/// </summary>
/// <returns>Value in new unit if successful, exception otherwise.</returns>
/// <exception cref="NotImplementedException">If conversion was not successful.</exception>
public double As(ElectricCurrentUnit unit)
{
switch (unit)
{
case ElectricCurrentUnit.Ampere:
return(Amperes);
case ElectricCurrentUnit.Kiloampere:
return(Kiloamperes);
case ElectricCurrentUnit.Megaampere:
return(Megaamperes);
case ElectricCurrentUnit.Microampere:
return(Microamperes);
case ElectricCurrentUnit.Milliampere:
return(Milliamperes);
case ElectricCurrentUnit.Nanoampere:
return(Nanoamperes);
default:
throw new NotImplementedException("unit: " + unit);
}
}
public string ToString(ElectricCurrentUnit unit, [CanBeNull] Culture culture, int significantDigitsAfterRadix)
{
double value = As(unit);
string format = UnitFormatter.GetFormat(value, significantDigitsAfterRadix);
return(ToString(unit, culture, format));
}
public static string GetAbbreviation(ElectricCurrentUnit unit, [CanBeNull] string cultureName)
{
// Windows Runtime Component does not support CultureInfo and IFormatProvider types, so we use culture name for public methods: https://msdn.microsoft.com/en-us/library/br230301.aspx
IFormatProvider provider = cultureName == null ? UnitSystem.DefaultCulture : new CultureInfo(cultureName);
return(UnitSystem.GetCached(provider).GetDefaultAbbreviation(unit));
}
// Windows Runtime Component does not support nullable types (double?): https://msdn.microsoft.com/en-us/library/br230301.aspx
#if !WINDOWS_UWP
/// <summary>
/// Dynamically convert from value and unit enum <see cref="ElectricCurrentUnit" /> to <see cref="ElectricCurrent" />.
/// </summary>
/// <param name="value">Value to convert from.</param>
/// <param name="fromUnit">Unit to convert from.</param>
/// <returns>ElectricCurrent unit value.</returns>
public static ElectricCurrent?From(QuantityValue?value, ElectricCurrentUnit fromUnit)
{
if (!value.HasValue)
{
return(null);
}
return(new ElectricCurrent((double)value.Value, fromUnit));
}
public void CurrentConversions(double value1, ElectricCurrentUnit units1, double value2, ElectricCurrentUnit units2)
{
new ElectricCurrent(value1, units1) {
Units = units2
}.Value.ShouldBeWithinEpsilonOf(value2);
new ElectricCurrent(value2, units2) {
Units = units1
}.Value.ShouldBeWithinEpsilonOf(value1);
}
/// <summary>
/// Creates the quantity with the given numeric value and unit.
/// </summary>
/// <param name="value">The numeric value to construct this quantity with.</param>
/// <param name="unit">The unit representation to construct this quantity with.</param>
/// <remarks>Value parameter cannot be named 'value' due to constraint when targeting Windows Runtime Component.</remarks>
/// <exception cref="ArgumentException">If value is NaN or Infinity.</exception>
private ElectricCurrent(decimal value, ElectricCurrentUnit unit)
{
if (unit == ElectricCurrentUnit.Undefined)
{
throw new ArgumentException("The quantity can not be created with an undefined unit.", nameof(unit));
}
_value = value;
_unit = unit;
}
/// <summary>
/// Creates the quantity with the given numeric value and unit.
/// </summary>
/// <param name="numericValue">The numeric value to contruct this quantity with.</param>
/// <param name="unit">The unit representation to contruct this quantity with.</param>
/// <remarks>Value parameter cannot be named 'value' due to constraint when targeting Windows Runtime Component.</remarks>
/// <exception cref="ArgumentException">If value is NaN or Infinity.</exception>
private ElectricCurrent(double numericValue, ElectricCurrentUnit unit)
{
if (unit == ElectricCurrentUnit.Undefined)
{
throw new ArgumentException("The quantity can not be created with an undefined unit.", nameof(unit));
}
_value = Guard.EnsureValidNumber(numericValue, nameof(numericValue));
_unit = unit;
}
/// <summary>
/// Convert to the unit representation <paramref name="unit" />.
/// </summary>
/// <returns>Value converted to the specified unit.</returns>
public double As(ElectricCurrentUnit unit)
{
if (Unit == unit)
{
return(Convert.ToDouble(Value));
}
var converted = AsBaseNumericType(unit);
return(Convert.ToDouble(converted));
}
/// <summary>
/// Creates an instance of if the base units class that represents the base units for a quantity.
/// All quantities, both base and derived, can be represented by a combination of these seven base units.
/// </summary>
/// <param name="length">The length unit (L).</param>
/// <param name="mass">The mass unit (M).</param>
/// <param name="time">The time unit (T).</param>
/// <param name="current">The electric current unit (I).</param>
/// <param name="temperature">The temperature unit (Θ).</param>
/// <param name="amount">The amount of substance unit (N).</param>
/// <param name="luminousIntensity">The luminous intensity unit (J).</param>
public BaseUnits(LengthUnit length, MassUnit mass, DurationUnit time, ElectricCurrentUnit current,
TemperatureUnit temperature, AmountOfSubstanceUnit amount, LuminousIntensityUnit luminousIntensity)
{
Length = length;
Mass = mass;
Time = time;
Current = current;
Temperature = temperature;
Amount = amount;
LuminousIntensity = luminousIntensity;
}
public string ToString(ElectricCurrentUnit unit, [CanBeNull] IFormatProvider provider, [NotNull] string format, [NotNull] params object[] args)
{
if (format == null) throw new ArgumentNullException(nameof(format));
if (args == null) throw new ArgumentNullException(nameof(args));
provider = provider ?? UnitSystem.DefaultCulture;
double value = As(unit);
object[] formatArgs = UnitFormatter.GetFormatArgs(unit, value, provider, args);
return string.Format(provider, format, formatArgs);
}
/// <summary>
/// Parse a string with one or two quantities of the format "<quantity> <unit>".
/// </summary>
/// <param name="str">String to parse. Typically in the form: {number} {unit}</param>
/// <param name="provider">Format to use when parsing number and unit. Defaults to <see cref="UnitSystem.DefaultCulture" />.</param>
/// <example>
/// Length.Parse("5.5 m", new CultureInfo("en-US"));
/// </example>
/// <exception cref="ArgumentNullException">The value of 'str' cannot be null. </exception>
/// <exception cref="ArgumentException">
/// Expected string to have one or two pairs of quantity and unit in the format
/// "<quantity> <unit>". Eg. "5.5 m" or "1ft 2in"
/// </exception>
/// <exception cref="AmbiguousUnitParseException">
/// More than one unit is represented by the specified unit abbreviation.
/// Example: Volume.Parse("1 cup") will throw, because it can refer to any of
/// <see cref="VolumeUnit.MetricCup" />, <see cref="VolumeUnit.UsLegalCup" /> and <see cref="VolumeUnit.UsCustomaryCup" />.
/// </exception>
/// <exception cref="UnitsNetException">
/// If anything else goes wrong, typically due to a bug or unhandled case.
/// We wrap exceptions in <see cref="UnitsNetException" /> to allow you to distinguish
/// Units.NET exceptions from other exceptions.
/// </exception>
public static ElectricCurrent Parse(string str, [CanBeNull] IFormatProvider provider)
{
if (str == null) throw new ArgumentNullException(nameof(str));
provider = provider ?? UnitSystem.DefaultCulture;
return QuantityParser.Parse<ElectricCurrent, ElectricCurrentUnit>(str, provider,
delegate(string value, string unit, IFormatProvider formatProvider2)
{
double parsedValue = double.Parse(value, formatProvider2);
ElectricCurrentUnit parsedUnit = ParseUnit(unit, formatProvider2);
return From(parsedValue, parsedUnit);
}, (x, y) => FromAmperes(x.Amperes + y.Amperes));
}
/// <summary>
/// Parse a string of the format "<quantity> <unit>".
/// </summary>
/// <example>
/// Length.Parse("5.5 m", new CultureInfo("en-US"));
/// </example>
/// <exception cref="ArgumentNullException">The value of 'str' cannot be null. </exception>
/// <exception cref="ArgumentException">
/// Expected 2 words. Input string needs to be in the format "<quantity> <unit
/// >".
/// </exception>
/// <exception cref="UnitsNetException">Error parsing string.</exception>
public static ElectricCurrent Parse(string str, IFormatProvider formatProvider = null)
{
if (str == null)
{
throw new ArgumentNullException("str");
}
var numFormat = formatProvider != null ?
(NumberFormatInfo)formatProvider.GetFormat(typeof(NumberFormatInfo)) :
NumberFormatInfo.CurrentInfo;
var numRegex = string.Format(@"[\d., {0}{1}]*\d", // allows digits, dots, commas, and spaces in the quantity (must end in digit)
numFormat.NumberGroupSeparator, // adds provided (or current) culture's group separator
numFormat.NumberDecimalSeparator); // adds provided (or current) culture's decimal separator
var regexString = string.Format("(?<value>[-+]?{0}{1}{2}{3}",
numRegex, // capture base (integral) Quantity value
@"(?:[eE][-+]?\d+)?)", // capture exponential (if any), end of Quantity capturing
@"\s?", // ignore whitespace (allows both "1kg", "1 kg")
@"(?<unit>\S+)"); // capture Unit (non-whitespace) input
var regex = new Regex(regexString);
GroupCollection groups = regex.Match(str.Trim()).Groups;
var valueString = groups["value"].Value;
var unitString = groups["unit"].Value;
if (valueString == "" || unitString == "")
{
var ex = new ArgumentException(
"Expected valid quantity and unit. Input string needs to be in the format \"<quantity><unit> or <quantity> <unit>\".", "str");
ex.Data["input"] = str;
ex.Data["formatprovider"] = formatProvider == null ? null : formatProvider.ToString();
throw ex;
}
try
{
ElectricCurrentUnit unit = ParseUnit(unitString, formatProvider);
double value = double.Parse(valueString, formatProvider);
return(From(value, unit));
}
catch (Exception e)
{
var newEx = new UnitsNetException("Error parsing string.", e);
newEx.Data["input"] = str;
newEx.Data["formatprovider"] = formatProvider == null ? null : formatProvider.ToString();
throw newEx;
}
}
// ReSharper restore VirtualMemberNeverOverriden.Global
protected (double UnitsInBaseUnit, double Tolerence) GetConversionFactor(ElectricCurrentUnit unit)
{
return(unit switch
{
ElectricCurrentUnit.Ampere => (AmperesInOneAmpere, AmperesTolerance),
ElectricCurrentUnit.Centiampere => (CentiamperesInOneAmpere, CentiamperesTolerance),
ElectricCurrentUnit.Kiloampere => (KiloamperesInOneAmpere, KiloamperesTolerance),
ElectricCurrentUnit.Megaampere => (MegaamperesInOneAmpere, MegaamperesTolerance),
ElectricCurrentUnit.Microampere => (MicroamperesInOneAmpere, MicroamperesTolerance),
ElectricCurrentUnit.Milliampere => (MilliamperesInOneAmpere, MilliamperesTolerance),
ElectricCurrentUnit.Nanoampere => (NanoamperesInOneAmpere, NanoamperesTolerance),
ElectricCurrentUnit.Picoampere => (PicoamperesInOneAmpere, PicoamperesTolerance),
_ => throw new NotSupportedException()
});
/// <summary>
/// Parse a string given a particular regular expression.
/// </summary>
/// <exception cref="UnitsNetException">Error parsing string.</exception>
private static List <ElectricCurrent> ParseWithRegex(string regexString, string str, IFormatProvider formatProvider = null)
{
var regex = new Regex(regexString);
MatchCollection matches = regex.Matches(str.Trim());
var converted = new List <ElectricCurrent>();
foreach (Match match in matches)
{
GroupCollection groups = match.Groups;
var valueString = groups["value"].Value;
var unitString = groups["unit"].Value;
if (groups["invalid"].Value != "")
{
var newEx = new UnitsNetException("Invalid string detected: " + groups["invalid"].Value);
newEx.Data["input"] = str;
newEx.Data["matched value"] = valueString;
newEx.Data["matched unit"] = unitString;
newEx.Data["formatprovider"] = formatProvider == null ? null : formatProvider.ToString();
throw newEx;
}
if (valueString == "" && unitString == "")
{
continue;
}
try
{
ElectricCurrentUnit unit = ParseUnit(unitString, formatProvider);
double value = double.Parse(valueString, formatProvider);
converted.Add(From(value, unit));
}
catch (AmbiguousUnitParseException)
{
throw;
}
catch (Exception ex)
{
var newEx = new UnitsNetException("Error parsing string.", ex);
newEx.Data["input"] = str;
newEx.Data["matched value"] = valueString;
newEx.Data["matched unit"] = unitString;
newEx.Data["formatprovider"] = formatProvider == null ? null : formatProvider.ToString();
throw newEx;
}
}
return(converted);
}
/// <summary>
/// Parse a string with one or two quantities of the format "<quantity> <unit>".
/// </summary>
/// <param name="str">String to parse. Typically in the form: {number} {unit}</param>
/// <param name="cultureName">Name of culture (ex: "en-US") to use when parsing number and unit. Defaults to <see cref="UnitSystem" />'s default culture.</param>
/// <example>
/// Length.Parse("5.5 m", new CultureInfo("en-US"));
/// </example>
/// <exception cref="ArgumentNullException">The value of 'str' cannot be null. </exception>
/// <exception cref="ArgumentException">
/// Expected string to have one or two pairs of quantity and unit in the format
/// "<quantity> <unit>". Eg. "5.5 m" or "1ft 2in"
/// </exception>
/// <exception cref="AmbiguousUnitParseException">
/// More than one unit is represented by the specified unit abbreviation.
/// Example: Volume.Parse("1 cup") will throw, because it can refer to any of
/// <see cref="VolumeUnit.MetricCup" />, <see cref="VolumeUnit.UsLegalCup" /> and <see cref="VolumeUnit.UsCustomaryCup" />.
/// </exception>
/// <exception cref="UnitsNetException">
/// If anything else goes wrong, typically due to a bug or unhandled case.
/// We wrap exceptions in <see cref="UnitsNetException" /> to allow you to distinguish
/// Units.NET exceptions from other exceptions.
/// </exception>
public static ElectricCurrent Parse(string str, [CanBeNull] string cultureName)
{
if (str == null)
{
throw new ArgumentNullException(nameof(str));
}
// Windows Runtime Component does not support CultureInfo and IFormatProvider types, so we use culture name for public methods: https://msdn.microsoft.com/en-us/library/br230301.aspx
IFormatProvider provider = cultureName == null ? UnitSystem.DefaultCulture : new CultureInfo(cultureName);
return(QuantityParser.Parse <ElectricCurrent, ElectricCurrentUnit>(str, provider,
delegate(string value, string unit, IFormatProvider formatProvider2)
{
double parsedValue = double.Parse(value, formatProvider2);
ElectricCurrentUnit parsedUnit = ParseUnit(unit, formatProvider2);
return From(parsedValue, parsedUnit);
}, (x, y) => FromAmperes(x.Amperes + y.Amperes)));
}
public string ToString(ElectricCurrentUnit unit, [CanBeNull] string cultureName, [NotNull] string format, [NotNull] params object[] args)
{
if (format == null)
{
throw new ArgumentNullException(nameof(format));
}
if (args == null)
{
throw new ArgumentNullException(nameof(args));
}
// Windows Runtime Component does not support CultureInfo and IFormatProvider types, so we use culture name for public methods: https://msdn.microsoft.com/en-us/library/br230301.aspx
IFormatProvider provider = cultureName == null ? UnitSystem.DefaultCulture : new CultureInfo(cultureName);
double value = As(unit);
object[] formatArgs = UnitFormatter.GetFormatArgs(unit, value, provider, args);
return(string.Format(provider, format, formatArgs));
}
/// <summary>
/// Parse a string with one or two quantities of the format "<quantity> <unit>".
/// </summary>
/// <param name="str">String to parse. Typically in the form: {number} {unit}</param>
/// <param name="culture">Format to use when parsing number and unit. If it is null, it defaults to <see cref="NumberFormatInfo.CurrentInfo"/> for parsing the number and <see cref="CultureInfo.CurrentUICulture"/> for parsing the unit abbreviation by culture/language.</param>
/// <example>
/// Length.Parse("5.5 m", new CultureInfo("en-US"));
/// </example>
/// <exception cref="ArgumentNullException">The value of 'str' cannot be null. </exception>
/// <exception cref="ArgumentException">
/// Expected string to have one or two pairs of quantity and unit in the format
/// "<quantity> <unit>". Eg. "5.5 m" or "1ft 2in"
/// </exception>
/// <exception cref="AmbiguousUnitParseException">
/// More than one unit is represented by the specified unit abbreviation.
/// Example: Volume.Parse("1 cup") will throw, because it can refer to any of
/// <see cref="VolumeUnit.MetricCup" />, <see cref="VolumeUnit.UsLegalCup" /> and <see cref="VolumeUnit.UsCustomaryCup" />.
/// </exception>
/// <exception cref="UnitsNetException">
/// If anything else goes wrong, typically due to a bug or unhandled case.
/// We wrap exceptions in <see cref="UnitsNetException" /> to allow you to distinguish
/// Units.NET exceptions from other exceptions.
/// </exception>
public static ElectricCurrent Parse(string str, [CanBeNull] Culture culture)
{
if (str == null)
{
throw new ArgumentNullException("str");
}
#if WINDOWS_UWP
IFormatProvider formatProvider = culture == null ? null : new CultureInfo(culture);
#else
IFormatProvider formatProvider = culture;
#endif
return(UnitParser.ParseUnit <ElectricCurrent>(str, formatProvider,
delegate(string value, string unit, IFormatProvider formatProvider2)
{
double parsedValue = double.Parse(value, formatProvider2);
ElectricCurrentUnit parsedUnit = ParseUnit(unit, formatProvider2);
return From(parsedValue, parsedUnit);
}, (x, y) => FromAmperes(x.Amperes + y.Amperes)));
}
public string ToString(ElectricCurrentUnit unit, [CanBeNull] Culture culture, [NotNull] string format,
[NotNull] params object[] args)
{
if (format == null)
{
throw new ArgumentNullException(nameof(format));
}
if (args == null)
{
throw new ArgumentNullException(nameof(args));
}
#if WINDOWS_UWP
IFormatProvider formatProvider = culture == null ? null : new CultureInfo(culture);
#else
IFormatProvider formatProvider = culture;
#endif
double value = As(unit);
object[] formatArgs = UnitFormatter.GetFormatArgs(unit, value, formatProvider, args);
return(string.Format(formatProvider, format, formatArgs));
}
/// <summary>
/// Parse a string with one or two quantities of the format "<quantity> <unit>".
/// </summary>
/// <param name="str">String to parse. Typically in the form: {number} {unit}</param>
/// <param name="culture">Format to use when parsing number and unit. If it is null, it defaults to <see cref="NumberFormatInfo.CurrentInfo"/> for parsing the number and <see cref="CultureInfo.CurrentUICulture"/> for parsing the unit abbreviation by culture/language.</param>
/// <example>
/// Length.Parse("5.5 m", new CultureInfo("en-US"));
/// </example>
/// <exception cref="ArgumentNullException">The value of 'str' cannot be null. </exception>
/// <exception cref="ArgumentException">
/// Expected string to have one or two pairs of quantity and unit in the format
/// "<quantity> <unit>". Eg. "5.5 m" or "1ft 2in"
/// </exception>
/// <exception cref="AmbiguousUnitParseException">
/// More than one unit is represented by the specified unit abbreviation.
/// Example: Volume.Parse("1 cup") will throw, because it can refer to any of
/// <see cref="VolumeUnit.MetricCup" />, <see cref="VolumeUnit.UsLegalCup" /> and <see cref="VolumeUnit.UsCustomaryCup" />.
/// </exception>
/// <exception cref="UnitsNetException">
/// If anything else goes wrong, typically due to a bug or unhandled case.
/// We wrap exceptions in <see cref="UnitsNetException" /> to allow you to distinguish
/// Units.NET exceptions from other exceptions.
/// </exception>
public static ElectricCurrent Parse(string str, [CanBeNull] Culture culture)
{
if (str == null)
{
throw new ArgumentNullException("str");
}
// Windows Runtime Component does not support CultureInfo type, so use culture name string for public methods instead: https://msdn.microsoft.com/en-us/library/br230301.aspx
#if WINDOWS_UWP
IFormatProvider formatProvider = culture == null ? null : new CultureInfo(culture);
#else
IFormatProvider formatProvider = culture;
#endif
return(QuantityParser.Parse <ElectricCurrent, ElectricCurrentUnit>(str, formatProvider,
delegate(string value, string unit, IFormatProvider formatProvider2)
{
double parsedValue = double.Parse(value, formatProvider2);
ElectricCurrentUnit parsedUnit = ParseUnit(unit, formatProvider2);
return From(parsedValue, parsedUnit);
}, (x, y) => FromAmperes(x.Amperes + y.Amperes)));
}
public string ToString(ElectricCurrentUnit unit, [CanBeNull] Culture culture, [NotNull] string format,
[NotNull] params object[] args)
{
if (format == null)
{
throw new ArgumentNullException(nameof(format));
}
if (args == null)
{
throw new ArgumentNullException(nameof(args));
}
// Windows Runtime Component does not support CultureInfo type, so use culture name string for public methods instead: https://msdn.microsoft.com/en-us/library/br230301.aspx
#if WINDOWS_UWP
IFormatProvider formatProvider = culture == null ? null : new CultureInfo(culture);
#else
IFormatProvider formatProvider = culture;
#endif
double value = As(unit);
object[] formatArgs = UnitFormatter.GetFormatArgs(unit, value, formatProvider, args);
return(string.Format(formatProvider, format, formatArgs));
}
/// <summary>
/// Dynamically convert from value and unit enum <see cref="ElectricCurrentUnit" /> to <see cref="ElectricCurrent" />.
/// </summary>
/// <param name="value">Value to convert from.</param>
/// <param name="fromUnit">Unit to convert from.</param>
/// <returns>ElectricCurrent unit value.</returns>
public static ElectricCurrent?From(QuantityValue?value, ElectricCurrentUnit fromUnit)
{
return(value.HasValue ? new ElectricCurrent((double)value.Value, fromUnit) : default(ElectricCurrent?));
}
/// <summary>
/// Get string representation of value and unit. Using two significant digits after radix.
/// </summary>
/// <param name="unit">Unit representation to use.</param>
/// <param name="culture">Culture to use for localization and number formatting.</param>
/// <returns>String representation.</returns>
public string ToString(ElectricCurrentUnit unit, [CanBeNull] Culture culture)
{
return(ToString(unit, culture, 2));
}
/// <summary>
/// Get string representation of value and unit. Using current UI culture and two significant digits after radix.
/// </summary>
/// <param name="unit">Unit representation to use.</param>
/// <returns>String representation.</returns>
public string ToString(ElectricCurrentUnit unit)
{
return(ToString(unit, null, 2));
}
public static string GetAbbreviation(ElectricCurrentUnit unit, [CanBeNull] Culture culture)
{
return(UnitSystem.GetCached(culture).GetDefaultAbbreviation(unit));
}
public static string GetAbbreviation(ElectricCurrentUnit unit)
{
return(GetAbbreviation(unit, null));
}
/// <summary>
/// Converts this ElectricCurrent to another ElectricCurrent with the unit representation <paramref name="unit" />.
/// </summary>
/// <returns>A ElectricCurrent with the specified unit.</returns>
public ElectricCurrent ToUnit(ElectricCurrentUnit unit)
{
var convertedValue = AsBaseNumericType(unit);
return(new ElectricCurrent(convertedValue, unit));
}