/// <summary>
/// Returns a quantity indicating whether this instance is equal to a specified <see cref="Gu.Units.Data"/> object within the given tolerance.
/// </summary>
/// <returns>
/// true if <paramref name="other"/> represents the same Data as this instance; otherwise, false.
/// </returns>
/// <param name="other">An instance of <see cref="Gu.Units.Data"/> 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(Data other, Data tolerance)
{
Ensure.GreaterThan(tolerance.bits, 0, nameof(tolerance));
return(Math.Abs(this.bits - other.bits) < tolerance.bits);
}
/// <summary>
/// Returns a quantity indicating whether this instance is equal to a specified <see cref="Gu.Units.Data"/> object.
/// </summary>
/// <returns>
/// true if <paramref name="other"/> represents the same Data as this instance; otherwise, false.
/// </returns>
/// <param name="other">An instance of <see cref="Gu.Units.Data"/> object to compare with this instance.</param>
public bool Equals(Data other)
{
return(this.bits.Equals(other.bits));
}
/// <summary>
/// Creates an instance of <see cref="Gu.Units.Data"/> from its string representation
/// </summary>
/// <param name="text">The string representation of the <see cref="Gu.Units.Data"/></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="Data"/></param>
/// <returns>True if an instance of <see cref="Data"/> could be parsed from <paramref name="text"/></returns>
public static bool TryParse(string text, NumberStyles styles, IFormatProvider provider, out Data result)
{
return(QuantityParser.TryParse <DataUnit, Data>(text, From, styles, provider, out result));
}
/// <summary>
/// Compares this instance to a specified <see cref="Gu.Units.Data"/> 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.Data"/> 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.Data"/> object to compare to this instance.</param>
public int CompareTo(Data quantity)
{
return(this.bits.CompareTo(quantity.bits));
}
/// <summary>
/// Creates an instance of <see cref="Gu.Units.Data"/> from its string representation
/// </summary>
/// <param name="text">The string representation of the <see cref="Gu.Units.Data"/></param>
/// <param name="styles">Specifies the <see cref="NumberStyles"/> to be used.</param>
/// <param name="result">The parsed <see cref="Data"/></param>
/// <returns>True if an instance of <see cref="Data"/> could be parsed from <paramref name="text"/></returns>
public static bool TryParse(string text, NumberStyles styles, out Data result)
{
return(QuantityParser.TryParse <DataUnit, Data>(text, From, styles, CultureInfo.CurrentCulture, out result));
}
