Method TryBeginWriteBits

TryBeginWriteBits(int)

Allows faster serialization by batching bounds checking. When you know you will be writing multiple fields back-to-back and you know the total size, you can call TryBeginWriteBits() once on the total size, and then follow it with calls to WriteBit() or WriteBits().

Bitwise write operations will throw OverflowException in editor and development builds if you go past the point you've marked using TryBeginWriteBits(). In release builds, OverflowException will not be thrown for performance reasons, since the point of using TryBeginWrite is to avoid bounds checking in the following operations in release builds. Instead, attempting to write past the marked position in release builds will write to random memory and cause undefined behavior, likely including instability and crashes.

Declaration

public bool TryBeginWriteBits(int bitCount)

Parameters

Type	Name	Description
int	bitCount	Number of bits you want to write, in total

Returns

Type	Description
bool	True if you can write, false if that would exceed buffer bounds