Beizsoft.Names
2.0.1
dotnet add package Beizsoft.Names --version 2.0.1
NuGet\Install-Package Beizsoft.Names -Version 2.0.1
<PackageReference Include="Beizsoft.Names" Version="2.0.1" />
paket add Beizsoft.Names --version 2.0.1
#r "nuget: Beizsoft.Names, 2.0.1"
// Install Beizsoft.Names as a Cake Addin
#addin nuget:?package=Beizsoft.Names&version=2.0.1
// Install Beizsoft.Names as a Cake Tool
#tool nuget:?package=Beizsoft.Names&version=2.0.1
Beizsoft.Names
A .NET string-ID library, using Beizsoft.Interning and Beizsoft.NullAwareEquality to offer an optimized mechanism for keying values by strings.
The Name<TStringComparer>
class contains a string value and its pre-calculated hash. All instances of Name<TStringComparer>
are interned, meaning each string will have only once Name<TStringComparer>
instance (per string comparer used). The static Name
class provides a .For(string content)
method using the NullAwareOrdinalStringComparer
as the default comparer.
The Name<TStringComparer>.For
method is used to get or create the singular Name
instance associated with any given string, which can then be compared using its public Hash
field and ReferenceEquals
with other Name
s of the same type. Name
s which are implemented using a different INullAwareEqualityComparer<string>
are not considered equal.
Name<TStringComparer>.Comparer.Instance
provides a single-instance INullAwareEqualityComparer<Name<TStringComparer>>
to use when comparing Name<TStringComparer>
s. This class can also be instantiated, to allow for its use in generic methods with a new()
constraint.
Name
s are designed for use-cases where Name.For
can be called as few times as possible, or where the calls are non-performance-critical. Their ideal use-case is as dictionary keys, avoiding the cost of hashing for every addition, removal and lookup.
The in-built NullAwareOrdinalStringComparer
could be re-worked to remove a single null check when comparing two strings which are both known not to be null (NotNullEquals
), but for simplicity, the NullAwareOrdinalStringComparer
class uses the in-built string-comparison functionality. A separate package may be added to cover this optimization.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 is compatible. net5.0-windows was computed. net6.0 is compatible. 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.1 is compatible. netstandard1.2 is compatible. netstandard1.3 is compatible. netstandard1.4 is compatible. netstandard1.5 is compatible. netstandard1.6 is compatible. netstandard2.0 is compatible. netstandard2.1 is compatible. |
.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 | 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.1
- Beizsoft.Interning (>= 1.0.0)
- Beizsoft.NullAwareEquality (>= 1.0.0)
- NETStandard.Library (>= 1.6.1)
-
.NETStandard 1.2
- Beizsoft.Interning (>= 1.0.0)
- Beizsoft.NullAwareEquality (>= 1.0.0)
- NETStandard.Library (>= 1.6.1)
-
.NETStandard 1.3
- Beizsoft.Interning (>= 1.0.0)
- Beizsoft.NullAwareEquality (>= 1.0.0)
- NETStandard.Library (>= 1.6.1)
-
.NETStandard 1.4
- Beizsoft.Interning (>= 1.0.0)
- Beizsoft.NullAwareEquality (>= 1.0.0)
- NETStandard.Library (>= 1.6.1)
-
.NETStandard 1.5
- Beizsoft.Interning (>= 1.0.0)
- Beizsoft.NullAwareEquality (>= 1.0.0)
- NETStandard.Library (>= 1.6.1)
-
.NETStandard 1.6
- Beizsoft.Interning (>= 1.0.0)
- Beizsoft.NullAwareEquality (>= 1.0.0)
- NETStandard.Library (>= 1.6.1)
-
.NETStandard 2.0
- Beizsoft.Interning (>= 1.0.0)
- Beizsoft.NullAwareEquality (>= 1.0.0)
-
.NETStandard 2.1
- Beizsoft.Interning (>= 1.0.0)
- Beizsoft.NullAwareEquality (>= 1.0.0)
-
net5.0
- Beizsoft.Interning (>= 1.0.0)
- Beizsoft.NullAwareEquality (>= 1.0.0)
-
net6.0
- Beizsoft.Interning (>= 1.0.0)
- Beizsoft.NullAwareEquality (>= 1.0.0)
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 |
---|