Extension Methods
Various extension methods are provided for several common .NET types.
Important
The ActiproSoftware.Extensions namespace must be imported for the extensions described below to be available.
Double Extensions
The DoubleExtensions type contains extension methods for the Double type.
| Type | Description |
|---|---|
| ClampToNonnegative | Returns the value clamped to a nonnegative number greater than or equal to 0.0. Values less than 0.0 return 0.0. All other values are unchanged. |
| ClampToPercentage | Returns the value clamped to a percentage between 0.0 and 1.0 (inclusive). Values less than 0.0 return 0.0, and values greater than 1.0 return 1.0. All other values are unchanged. |
| ClampToRange | Returns the value clamped between the specified minimum and maximum values. Values less than the minimum return the minumum, and values greater than the maximum return the maximum. All other values are unchanged. |
| IsBetween | Returns whether a value is between the specified minimum and maximum (inclusive or exclusive). |
| IsNonnegative | Returns if a value is 0.0 or greater. |
| IsPercentage | Returns if a value is between 0.0 and 1.0 (inclusive). |
| NormalizeDegreeAngle | Returns a degree angle normalized to a value between 0.0 and 360.0. Negative values are converted to their equivalent positive angle (e.g., -15.0 is normalized as 345.0). Values greater than 360.0 are normized to their equivalent position within the first 360.0 degrees (e.g., 460.0 is normalized as 100.0). |
| Round | Returns a number rounded to a specified number of digits using a given RoundMode. |
| RoundToMultiple | Returns a number rounded to the nearest multiple of another number (e.g., 13.0 rounded to the nearest multiple of 5.0 returns 15.0). |
Int32 Extensions
The Int32Extensions type contains extension methods for the Int32 type.
| Type | Description |
|---|---|
| ClampToNonnegative | Returns the value clamped to a nonnegative number greater than or equal to 0. Values less than 0 return 0. All other values are unchanged. |
| ClampToRange | Returns the value clamped between the specified minimum and maximum values. Values less than the minimum return the minumum, and values greater than the maximum return the maximum. All other values are unchanged. |
| IsBetween | Returns whether a value is between the specified minimum and maximum (inclusive or exclusive). |
| IsEven | Returns whether the value is an even number, including 0. |
| IsNonnegative | Returns if a value is 0 or greater. |
| IsOdd | Returns whether the value is an odd number. |
| RoundToMultiple | Returns a number rounded to the nearest multiple of another number (e.g., 13 rounded to the nearest multiple of 5 returns 15). |
Object Extensions
The ObjectExtensions type contains extension methods for the Object type.
| Type | Description |
|---|---|
| TryConvertToDouble | Tries to convert an object to a Double value. To be successful, non-Double values must implement IConvertible.ToDouble. Alternatively, String values are processed using Double.TryParse. |