Class ByteUtil

Utility methods to deal with System.Byte arrays.

Inheritance
System.Object
ByteUtil
Inherited Members
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.ToString()
Namespace: Libplanet.Common
Assembly: Libplanet.Common.dll
Syntax
public static class ByteUtil

Methods

| Improve this Doc View Source

CalculateHashCode(Byte[])

Calculates a deterministic hash code from a given bytes. It is mostly used to implement System.Object.GetHashCode() method.

Declaration
[Pure]
public static int CalculateHashCode(byte[] bytes)
Parameters
Type Name Description
System.Byte[] bytes

A System.Byte array, which completely determines (or encodes) an object, to calculate a hash code.
Returns
Type Description
System.Int32

A hash code determined from the given bytes. For equivalent bytes, the same hash code is returned. It must not be null.
Exceptions
Type Condition
System.ArgumentNullException

Thrown when the given bytes is null.
| Improve this Doc View Source

Hex(in ImmutableArray<Byte>)

Renders a hexadecimal string in lowercase from a System.Byte array.

Declaration
[Pure]
public static string Hex(in ImmutableArray<byte> bytes)
Parameters
Type Name Description
ImmutableArray<System.Byte> bytes

A System.Byte array to renders the corresponding hexadecimal string.
Returns
Type Description
System.String

A hexadecimal string which encodes the given bytes.
See Also
| Improve this Doc View Source

Hex(Byte[])

Renders a hexadecimal string in lowercase from a System.Byte array.

Declaration
[Pure]
public static string Hex(byte[] bytes)
Parameters
Type Name Description
System.Byte[] bytes

A System.Byte array to renders the corresponding hexadecimal string.
Returns
Type Description
System.String

A hexadecimal string which encodes the given bytes.
See Also
| Improve this Doc View Source

ParseHex(String)

Converts a hexadecimal string to a mutable System.Byte array.

Declaration
[Pure]
public static byte[] ParseHex(string hex)
Parameters
Type Name Description
System.String hex

A System.String which encodes System.Bytes in hexadecimal. Its length must be zero or an even number. It must not be null.
Returns
Type Description
System.Byte[]

A System.Byte array that the given hex string represented in hexadecimal. It lengthens the half of the given hex string.
Exceptions
Type Condition
System.ArgumentOutOfRangeException

Thrown when the length of the given hex string is an odd number.
System.FormatException

Thrown when the given hex string is not a valid hexadecimal string.
See Also
| Improve this Doc View Source

ParseHexToImmutable(String)

Converts a hexadecimal string to an immutable System.Byte array.

Declaration
[Pure]
public static ImmutableArray<byte> ParseHexToImmutable(string hex)
Parameters
Type Name Description
System.String hex

A System.String which encodes System.Bytes in hexadecimal. Its length must be zero or an even number. It must not be null.
Returns
Type Description
ImmutableArray<System.Byte>

A System.Byte array that the given hex string represented in hexadecimal.
Exceptions
Type Condition
System.ArgumentNullException

Thrown when the given hex string is null.
System.ArgumentOutOfRangeException

Thrown when the length of the given hex string is an odd number.
System.FormatException

Thrown when the given hex string is not a valid hexadecimal string.
See Also
| Improve this Doc View Source

Satisfies(IReadOnlyList<Byte>, Int64)

Tests if a hash digest is less than the target computed for the given difficulty).

Declaration
[Pure]
public static bool Satisfies(IReadOnlyList<byte> hashDigest, long difficulty)
Parameters
Type Name Description
System.Collections.Generic.IReadOnlyList<System.Byte> hashDigest

A hash digest to test.
System.Int64 difficulty

The difficulty to compute target number.
Returns
Type Description
System.Boolean

true only if a digest is less than the target computed for the given difficulty). If difficulty is 0 it always returns true.
| Improve this Doc View Source

TimingSafelyCompare(IReadOnlyList<Byte>, IReadOnlyList<Byte>)

Timing safe comparison of two byte arrays.

Declaration
[Pure]
public static bool TimingSafelyCompare(IReadOnlyList<byte> left, IReadOnlyList<byte> right)
Parameters
Type Name Description
System.Collections.Generic.IReadOnlyList<System.Byte> left

A byte array.
System.Collections.Generic.IReadOnlyList<System.Byte> right

Another byte array.
Returns
Type Description
System.Boolean

true iff two byte arrays have the exactly same contents.
Remarks

In case of two byte arrays do not have the same length, it tries to keep the timing dependent on the length of the shorter one.