Skip to content

K-Sortable Globally Unique IDs Library for .NET: Generate K-sortable GUIDs that maintain a balance between randomness and time-based ordering, ensuring system-wide uniqueness and minimal collisions.

License

Notifications You must be signed in to change notification settings

steve-warren/ksuid

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ksuid nuget

This is a dotnet implementation of Segment's K-Sortable Globally Unique Identifiers.

overview

  • creates random KSUID strings
  • blazing-fast performance
  • no additional memory overhead, memory allocation only for string
  • thread-safe and lock-free
  • uses crypto PRNG to generate random bits
  • unit-tested
  • targets .net standard 2.1

installation

$ dotnet add package KsuidDotNet

how to use

Create a random KSUID:

string id = Ksuid.NewKsuid();

Console.WriteLine(id); // outputs 29faSiN1gPB6IzM74u6tMfTO02L

Creating a random KSUID string with the prefix c_:

string id = Ksuid.NewKsuid("c_");

Console.WriteLine(id); // outputs c_29faSiN1gPB6IzM74u6tMfTO02L

micro benchmarks

Benchmark results for KsuidDotNet and other KSUID libraries.

BenchmarkDotNet=v0.13.2, OS=Windows 11 (10.0.22621.1555)
13th Gen Intel Core i7-13700K, 1 CPU, 24 logical and 16 physical cores
.NET SDK=7.0.203
  [Host]     : .NET 7.0.5 (7.0.523.17405), X64 RyuJIT AVX2
  DefaultJob : .NET 7.0.5 (7.0.523.17405), X64 RyuJIT AVX2
Method Mean Error StdDev Gen0 Allocated
KsuidDotNet_NewKsuidToString 194.8 ns 0.46 ns 0.43 ns 0.0050 80 B
StructKsuid_RandomKsuidToString 380.2 ns 0.91 ns 0.85 ns 0.0048 80 B
DotKsuid_GenerateToString 412.0 ns 1.15 ns 1.08 ns 0.0839 1320 B
ksuid_GenerateToString 1,884.6 ns 7.08 ns 6.27 ns 0.4978 7824 B
KsuidDotNet_NewKsuid_WithStringPrefix 196.5 ns 0.37 ns 0.35 ns 0.0050 80 B
StructKsuid_RandomKsuidToStringWithStringPrefix 387.2 ns 0.50 ns 0.44 ns 0.0100 160 B
DotKsuid_GenerateToStringWithStringPrefix 421.5 ns 1.05 ns 0.98 ns 0.0892 1400 B
ksuid_GenerateToStringWithStringPrefix 1,881.8 ns 8.95 ns 7.94 ns 0.5035 7904 B

license

This library is open-source software released under the MIT License.

About

K-Sortable Globally Unique IDs Library for .NET: Generate K-sortable GUIDs that maintain a balance between randomness and time-based ordering, ensuring system-wide uniqueness and minimal collisions.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages