Examples.SensorData Struct Reference

Simple example showing how a struct can participate in the SystemEx hashing system using IHashable<SensorData>. More...

Inheritance diagram for Examples.SensorData:

Collaboration diagram for Examples.SensorData:

Public Member Functions
	SensorData ()
	Initializes the struct with example values.
FixedVector< byte >	ToBytes ()
	Converts this struct into a deterministic byte sequence.
override int	GetHashCode ()
	Computes a 32‑bit hash for this struct.
ulong	GetHashCodeLong ()
	Computes a 64‑bit hash for this struct.

Public Attributes
int	Id
	Example fields that will be included in the hash.
float	Value

Detailed Description

Simple example showing how a struct can participate in the SystemEx hashing system using IHashable<SensorData>.

This demonstrates:

• How to attach a hash algorithm using the HashAlgorithm attribute
• How to provide a deterministic byte representation via ToBytes()
• How HashFactory computes 32‑bit and 64‑bit hashes for structs

Constructor & Destructor Documentation

SensorData()

Examples.SensorData.SensorData

(

)

Initializes the struct with example values.

                             {
            Id = 748;
            Value = 1.00928f;
        }

Member Function Documentation

GetHashCode()

override int Examples.SensorData.GetHashCode

(

)

Computes a 32‑bit hash for this struct.

How it works:

1. HashFactory reads the HashAlgorithm attribute on this struct.
2. It creates the specified hasher (BernsteinHash).
3. It calls ToBytes() to get the raw data.
4. It computes a 32‑bit hash using the given seed.

If the hash result is non‑zero, it is returned. Otherwise, the fallback is the default .NET hash code.

                                           {
            var x =  HashFactory.Hash32(this, RandUtils.RandUInt(uint.MinValue, uint.MaxValue, Endian.System) );
            if ( x.Value != 0 ) return (int)x.Value;
 
            return base.GetHashCode();
        }

GetHashCodeLong()

ulong Examples.SensorData.GetHashCodeLong

(

)

Computes a 64‑bit hash for this struct.

This works exactly like GetHashCode(), but produces a 64‑bit value. If the computed hash is zero, the method returns 0 as a fallback.

                                        {
            var x =  HashFactory.Hash64(this, RandUtils.RandUInt(uint.MinValue, uint.MaxValue, Endian.System) );
            if ( x.Value != 0 ) return x.Value;
 
            return 0;
        }

ToBytes()

FixedVector< byte > Examples.SensorData.ToBytes

(

)

Converts this struct into a deterministic byte sequence.

Important notes for beginners:

• The order of fields must never change.
• The endianness must be chosen intentionally.
• The size must always stay the same (here: 8 bytes).

HashFactory will use these bytes as input for the selected hash algorithm.

Implements SystemEx.Hash.IHashable< T >.

                                            {
            var b = new FixedVector<byte>(8);
 
 
            // Convert the integer field into 4 bytes.
            // Endian.System means: use the machine's native endianness.
            b.ReplaceRange(0, Id.ToBytes(Endian.System));
 
            // Convert the float field into 4 bytes.
            // Here we intentionally use BigEndian to show that each field
            // can choose its own byte order if needed.
            b.ReplaceRange(4, Value.ToBytes(Endian.BigEndian));
 
            return b;
        }

Member Data Documentation

Id

int Examples.SensorData.Id

Example fields that will be included in the hash.

---

The documentation for this struct was generated from the following file:

• ExampleHasher.cs