GoeaLabs.Bedrock 1.0.0

GoeaLabs.Bedrock

Project Description

A collection of general purpose helper methods used by my other libraries.

Compatibility

Compatible with .NET6 and higher, includes .NET7 build.

API(s)

• Array extensions:

byte[] FillRandom(this byte[]);

uint[] FillRandom(this uint[]);

bool IsEqual(this byte[], byte[]);

bool IsEqual(this uint[], uint[]);

bool IsEmpty(this byte[]);

bool IsEmpty(this uint[]);

• Span extensions:

bool IsEqual(this Span<byte>, Span<byte>);

void Split(this Span<uint>, Span<byte>);

void Merge(this Span<byte>, Span<uint>);

void XOR(this Span<byte>, Span<byte>);

Note that Split and Merge above are endianness agnostic: you will get the same results even on IBM System/390, the only Big Endian platform with .NET support I am aware of.

• Integers extensions:

void Halve(this ushort, out byte, out byte);

void Halve(this uint, out ushort, out ushort);

void Halve(this ulong, out uint, out uint);

#if NET7_0_OR_GREATER
void Halve(this UInt128, out ulong, out ulong);
#endif

ushort Merge(this byte, byte);

uint Merge(this ushort, ushort);

ulong Merge(this uint, uint);

#if NET7_0_OR_GREATER
UInt128 Merge(this ulong, ulong);
#endif

byte XOR(this byte, byte);

• Integers scaling to arbitrary ranges:

ulong ScaleUnsigned64(ulong, ulong, ulong, ulong, ulong);

long ScaleSigned64(long, long, long, long, long);

BigInteger ScaleBigInt(BigInteger, BigInteger, BigInteger, BigInteger, BigInteger);

#if NET7_0_OR_GREATER
UInt128 ScaleUnsigned128(UInt128, UInt128, UInt128, UInt128, UInt128);
#endif

#if NET7_0_OR_GREATER
Int128 ScaleSigned128(Int128, Int128, Int128, Int128, Int128);
#endif

Installation

Install with NuGet Package Manager Console

Install-Package GoeaLabs.Bedrock

Install with .NET CLI

dotnet add package GoeaLabs.Bedrock