Version: 2020.3
LanguageEnglish
  • C#

How do you use documentation throughout your workflow? Share your experience with us by taking this survey.

Hash128

struct in UnityEngine

/

Implemented in:UnityEngine.CoreModule

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Description

Represents a 128-bit hash value.

Use Hash128 to uniquely identify a piece of data. A 128-bit hash value has an extremely low probability of hash collisions, so you can assume that if the hash values of two pieces of data are identical, then the data is identical too. For example, to quickly determine whether texture pixel contents have changed, or if they are identical between several textures, you can use Texture.imageContentsHash.

To compute the hash values for some data, use the Hash128.Compute function. To compute the hash values incrementally for several pieces of data, use Hash128.Append.

using UnityEngine;

public class ExampleScript : MonoBehaviour { void Start() { var hash = new Hash128(); hash.Append(42); hash.Append(13.0f); hash.Append("Hello"); hash.Append(new int[] {1, 2, 3, 4, 5}); // prints "2d6e582c3fcfb4b8f3c16650a75dc37b" Debug.Log(hash.ToString()); } }

The hash algorithm used to compute Hash128 values is SpookyHash V2. Note that while this hash algorithm is quite fast to compute and has good hash distribution qualities, it is not a cryptographic hash function.

Properties

isValidReturns true is the hash value is valid. (Read Only)

Constructors

Hash128Directly initialize a Hash128 with a 128-bit value.

Public Methods

AppendHash new input data and combine with the current hash value.
ToStringConvert a Hash128 to string.

Static Methods

ComputeCompute a hash of input data.
ParseConvert a hex-encoded string into Hash128 value.