CLSS.ExtensionMethods.IComparable.ClampToRange
1.3.0
dotnet add package CLSS.ExtensionMethods.IComparable.ClampToRange --version 1.3.0
NuGet\Install-Package CLSS.ExtensionMethods.IComparable.ClampToRange -Version 1.3.0
<PackageReference Include="CLSS.ExtensionMethods.IComparable.ClampToRange" Version="1.3.0" />
paket add CLSS.ExtensionMethods.IComparable.ClampToRange --version 1.3.0
#r "nuget: CLSS.ExtensionMethods.IComparable.ClampToRange, 1.3.0"
// Install CLSS.ExtensionMethods.IComparable.ClampToRange as a Cake Addin
#addin nuget:?package=CLSS.ExtensionMethods.IComparable.ClampToRange&version=1.3.0
// Install CLSS.ExtensionMethods.IComparable.ClampToRange as a Cake Tool
#tool nuget:?package=CLSS.ExtensionMethods.IComparable.ClampToRange&version=1.3.0
CLSS.ExtensionMethods.IComparable.ClampToRange
Problem
The process to clamp a value to a range is somewhat long:
if (value < min) value = min;
else if (value > max) value = max;
Even longer when the type of your value does not implement comparison operators:
// Type of meetingDate is System.DateTime
if (meetingDate.CompareTo(startDate) < 0) meetingDate = startDate;
else if (meetingDate.CompareTo(endDate) > 0) meetingDate = endDate;
The System.Math.Clamp
method can do this operation in one line, but it only supports a limited number of primitive types. Types such as System.Version
and System.DateTime
are not supported.
Solution
ClampToRange
does this in a more intuitive, shorter and functional style friendly way:
using CLSS;
value = value.ClampToRange(min, max);
No more short stops in your code reading to decode the meanings of comparison operators. When you read ClampToRange
, you know what it's doing.
ClampToRange
has a wider range of supported types than System.Math.Clamp
. It supports all IComparable<T>
types. For non-generic IComparable
types, the equivalent method provided by this package is ClampToRangeNonGeneric
.
using CLSS;
// System.DateTime implements IComparable<T>
meetingDate = meetingDate.ClampToRange(startDate, endDate);
ClampToRange
can also take in CLSS type ValueRange
on .NET Standard 2.0 or higher.
using CLSS;
var displayableRange = new ValueRange(0, 9999);
int value = value.ClampToRange(displayableRange);
This package is a part of the C# Language Syntactic Sugar suite.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp1.0 was computed. netcoreapp1.1 was computed. netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard1.0 is compatible. netstandard1.1 was computed. netstandard1.2 was computed. netstandard1.3 was computed. netstandard1.4 was computed. netstandard1.5 was computed. netstandard1.6 was computed. netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net45 was computed. net451 was computed. net452 was computed. net46 was computed. net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen30 was computed. tizen40 was computed. tizen60 was computed. |
Universal Windows Platform | uap was computed. uap10.0 was computed. |
Windows Phone | wp8 was computed. wp81 was computed. wpa81 was computed. |
Windows Store | netcore was computed. netcore45 was computed. netcore451 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 1.0
- NETStandard.Library (>= 1.6.1)
-
.NETStandard 2.0
- CLSS.Types.ValueRange (>= 1.0.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
1.3.0 | 229 | 2/16/2024 |
- Renamed the version for non-generic IComparable for better compatibility with types that implement both generic and non-generic IComparable.