Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


InvalidateMask(ulong)

Invalidate all properties stored from multiple documents that match a document key mask.
Read time 1 minuteLast updated 12 days ago

Definition

public void InvalidateMask(ulong documentKeyMask)

Parameters

documentKeyMask

A document key mask.

Remarks

This operation is slower than the simpler PropertyDatabase.Invalidate since we cannot rely on a binary search to find all keys that match the mask.
// Store properties of multiple documents.for (ulong i = 0; i < 10; ++i){ for (var j = 0; j < 10; ++j) propertyDatabase.Store(i, PropertyDatabase.CreatePropertyHash($"prop{j}"), $"value{j}");}// Invalidate all documents that match any set bits of the mask.ulong invalidatedDocumentMask = 2;propertyDatabase.InvalidateMask(invalidatedDocumentMask);// The invalidated documents can no longer be retrieved.for (ulong i = 0; i < 10; ++i){ if ((i & invalidatedDocumentMask) == 0) continue; if (propertyDatabase.TryLoad(i, out IEnumerable<object> invalidatedDocumentValues)) Assert.Fail("TryLoad should have failed to retrieve the invalidated document values.");}
Additional Resources: PropertyDatabase.CreateDocumentKey.