backFillBuffers

@JvmField
val backFillBuffers: Boolean(source)

When the functions Encoder.encodeToString, Encoder.encodeToCharArray, Encoder.encodeBuffered, Encoder.encodeBufferedAsync, Decoder.decodeBuffered, and Decoder.decodeBufferedAsync are utilized, they may allocate an appropriate medium (a buffer) to store encoded/decoded data (e.g. a StringBuilder, CharArray, or ByteArray). Depending on the underlying operation, such as an array over-allocation due to encodeOutMaxSize or decodeOutMaxSize, those initially allocated buffers may not be returned as the function's result. Prior versions of this library always back-filled them with 0 or the null character \u0000, but that can be computationally expensive for large datasets and potentially unnecessary if data is known to not be sensitive in nature.

If true, any non-result buffer allocations are back-filled before being de-referenced by function return. If false, back-filling is skipped.