/// <summary>
/// Divides <paramref name="left"/> by <paramref name="right"/>
/// </summary>
/// <param name="left">The left value</param>
/// <param name="right">The right value</param>
/// <returns>The <see cref="Power"/> that is the result from the division.</returns>
public static Power operator /(Energy left, Time right)
{
return(Power.FromWatts(left.joules / right.seconds));
}
/// <summary>
/// Multiplies <paramref name="left"/> with <paramref name="right"/>
/// </summary>
/// <param name="left">The left value</param>
/// <param name="right">The right value</param>
/// <returns>The <see cref="Power"/> that is the result from the multiplication.</returns>
public static Power operator *(Energy left, Frequency right)
{
return(Power.FromWatts(left.joules * right.hertz));
}
/// <summary>
/// Returns a quantity indicating whether this instance is equal to a specified <see cref="Gu.Units.Power"/> object within the given tolerance.
/// </summary>
/// <returns>
/// true if <paramref name="other"/> represents the same Power as this instance; otherwise, false.
/// </returns>
/// <param name="other">An instance of <see cref="Gu.Units.Power"/> object to compare with this instance.</param>
/// <param name="tolerance">The maximum difference for being considered equal. Must be greater than zero.</param>
public bool Equals(Power other, Power tolerance)
{
Ensure.GreaterThan(tolerance.watts, 0, nameof(tolerance));
return(Math.Abs(this.watts - other.watts) < tolerance.watts);
}
/// <summary>
/// Returns a quantity indicating whether this instance is equal to a specified <see cref="Gu.Units.Power"/> object.
/// </summary>
/// <returns>
/// true if <paramref name="other"/> represents the same Power as this instance; otherwise, false.
/// </returns>
/// <param name="other">An instance of <see cref="Gu.Units.Power"/> object to compare with this instance.</param>
public bool Equals(Power other)
{
return(this.watts.Equals(other.watts));
}
/// <summary>
/// Compares this instance to a specified <see cref="Gu.Units.Power"/> object and returns an integer that indicates whether this <paramref name="quantity"/> is smaller than, equal to, or greater than the <see cref="Gu.Units.Power"/> object.
/// </summary>
/// <returns>
/// A signed number indicating the relative quantitys of this instance and <paramref name="quantity"/>.
///
/// Value
///
/// Description
///
/// A negative integer
///
/// This instance is smaller than <paramref name="quantity"/>.
///
/// Zero
///
/// This instance is equal to <paramref name="quantity"/>.
///
/// A positive integer
///
/// This instance is larger than <paramref name="quantity"/>.
///
/// </returns>
/// <param name="quantity">An instance of <see cref="Gu.Units.Power"/> object to compare to this instance.</param>
public int CompareTo(Power quantity)
{
return(this.watts.CompareTo(quantity.watts));
}
/// <summary>
/// Creates an instance of <see cref="Gu.Units.Power"/> from its string representation
/// </summary>
/// <param name="text">The string representation of the <see cref="Gu.Units.Power"/></param>
/// <param name="styles">Specifies the <see cref="NumberStyles"/> to be used.</param>
/// <param name="provider">Specifies the formatProvider to be used.</param>
/// <param name="result">The parsed <see cref="Power"/></param>
/// <returns>True if an instance of <see cref="Power"/> could be parsed from <paramref name="text"/></returns>
public static bool TryParse(string text, NumberStyles styles, IFormatProvider provider, out Power result)
{
return(QuantityParser.TryParse <PowerUnit, Power>(text, From, styles, provider, out result));
}
/// <summary>
/// Creates an instance of <see cref="Gu.Units.Power"/> from its string representation
/// </summary>
/// <param name="text">The string representation of the <see cref="Gu.Units.Power"/></param>
/// <param name="styles">Specifies the <see cref="NumberStyles"/> to be used.</param>
/// <param name="result">The parsed <see cref="Power"/></param>
/// <returns>True if an instance of <see cref="Power"/> could be parsed from <paramref name="text"/></returns>
public static bool TryParse(string text, NumberStyles styles, out Power result)
{
return(QuantityParser.TryParse <PowerUnit, Power>(text, From, styles, CultureInfo.CurrentCulture, out result));
}
