Clear

Forgets the contents but keeps the block.

Module: Text

Signature

func Clear(self);

Remarks

Sets Length back to 0 while leaving the block and its Capacity alone, so the builder can be filled again without a fresh allocation. This is what to reach for when a builder is reused in a loop.

The bytes are not erased, only forgotten — they sit in the block until they are overwritten, and no method will read them back. Use Free to release the block itself.

Example

import Text::StringBuilder;

var builder = StringBuilder::New();

for i in 0..3 {
    builder.Append("line");
    // ... use builder.Data() and builder.Length() here
    builder.Clear(); // ready for the next round, same block
}

builder.Free();

See also

• StringBuilder — the builder type
• Free — release the block rather than reuse it
• Capacity — the room this keeps hold of