Significant​Digits​Number​Rounder Significant​Digits​Number​Rounder Significant​Digits​Number​Rounder Class

Definition

Rounds numbers to a specified number of significant digits.

public sealed class SignificantDigitsNumberRounder : INumberRounder, ISignificantDigitsNumberRounderpublic sealed class SignificantDigitsNumberRounder : INumberRounder, ISignificantDigitsNumberRounderPublic NotInheritable Class SignificantDigitsNumberRounder Implements INumberRounder, ISignificantDigitsNumberRounder
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Constructors

SignificantDigitsNumberRounder() SignificantDigitsNumberRounder() SignificantDigitsNumberRounder()

Creates a SignificantDigitsNumberRounder object.

This constructor initializes RoundingAlgorithm to a default value of RoundingAlgorithm.**RoundHalfUp**, and SignificantDigits to 0.

public SignificantDigitsNumberRounder()public SignificantDigitsNumberRounder()Public Sub New()
Attributes

Properties

RoundingAlgorithm RoundingAlgorithm RoundingAlgorithm

Gets or sets the rounding strategy value for this SignificantDigitsNumberRounder object.

public RoundingAlgorithm RoundingAlgorithm { get; set; }public RoundingAlgorithm RoundingAlgorithm { get; set; }Public ReadWrite Property RoundingAlgorithm As RoundingAlgorithm
Attributes

Remarks

This property is initialized to a default value of RoundingAlgorithm.**RoundHalfUp**.

SignificantDigits SignificantDigits SignificantDigits

Gets or sets the number of significant digits this SignificantDigitsNumberRounder object uses for rounding.

public unsigned short SignificantDigits { get; set; }public uint SignificantDigits { get; set; }Public ReadWrite Property SignificantDigits As uint
Value
uint uint uint

The number of significant digits used for rounding.

Attributes

Remarks

This property is initialized to a default value of 1.

If this property is 0, no rounding is performed by the SignificantDigitsNumberRounder object.

When rounding is performed, leading 0s in the input are not considered. Significant digits are counted beginning with the first non-zero digit until the number of SignificantDigits occurs, and then RoundingAlgorithm is used to round at that position.

Methods

RoundDouble(Double) RoundDouble(Double) RoundDouble(Double)

Rounds a Double number to the specified number of significant digits.

public double RoundDouble(Double value)public double RoundDouble(Double value)Public Function RoundDouble(value As Double) As double
Parameters
value
System.Double System.Double System.Double

The Double value to be rounded.

Returns
double double double

The rounded number. This result is a double precision floating point number, which is not necessarily an integer.

Attributes

Remarks

The rounding strategy is based on the values of SignificantDigits and RoundingAlgorithm.

Note

This method is precise only within the limits of the Double data type: approximately 15 digits.

RoundInt32(Int32) RoundInt32(Int32) RoundInt32(Int32)

Rounds an Int32 number to the specified number of significant digits.

public int RoundInt32(Int32 value)public int RoundInt32(Int32 value)Public Function RoundInt32(value As Int32) As int
Parameters
value
System.Int32 System.Int32 System.Int32

The Int32 value to be rounded.

Returns
int int int

The rounded 32 bit integer.

Attributes

Remarks

The rounding strategy is based on the values of SignificantDigits and RoundingAlgorithm.

RoundInt64(Int64) RoundInt64(Int64) RoundInt64(Int64)

Rounds an Int64 number to the specified number of significant digits.

public long RoundInt64(Int64 value)public long RoundInt64(Int64 value)Public Function RoundInt64(value As Int64) As long
Parameters
value
System.Int64 System.Int64 System.Int64

The Int64 value to be rounded.

Returns
long long long

The rounded 64 bit integer.

Attributes

Remarks

The rounding strategy is based on the values of SignificantDigits and RoundingAlgorithm.

RoundSingle(Single) RoundSingle(Single) RoundSingle(Single)

Rounds a Single number to the specified number of significant digits.

public float RoundSingle(Single value)public float RoundSingle(Single value)Public Function RoundSingle(value As Single) As float
Parameters
value
System.Single System.Single System.Single

The Single value to be rounded.

Returns
float float float

The rounded number. This result is a single precision floating point number, which is not necessarily an integer.

Attributes

Remarks

The rounding strategy is based on the values of SignificantDigits and RoundingAlgorithm.

Note

This method is precise only within the limits of the Single data type: approximately 7 digits.

RoundUInt32(UInt32) RoundUInt32(UInt32) RoundUInt32(UInt32)

Rounds a UInt32 number to the specified number of significant digits.

public unsigned short RoundUInt32(UInt32 value)public uint RoundUInt32(UInt32 value)Public Function RoundUInt32(value As UInt32) As uint
Parameters
value
System.UInt32 System.UInt32 System.UInt32

The UInt32 value to be rounded.

Returns
uint uint uint

The rounded unsigned 32 bit integer.

Attributes

Remarks

The rounding strategy is based on the values of SignificantDigits and RoundingAlgorithm.

RoundUInt64(UInt64) RoundUInt64(UInt64) RoundUInt64(UInt64)

Rounds a UInt64 number to the specified number of significant digits.

public ulong RoundUInt64(UInt64 value)public ulong RoundUInt64(UInt64 value)Public Function RoundUInt64(value As UInt64) As ulong
Parameters
value
System.UInt64 System.UInt64 System.UInt64

The UInt64 value to be rounded.

Returns
ulong ulong ulong

The rounded unsigned 64 bit integer.

Attributes

Remarks

The rounding strategy is based on the values of SignificantDigits and RoundingAlgorithm.

See Also