WriteInt v0.1.0

Package: Format

Signature

func WriteInt(
    builder: *StringBuilder,
    value: int64
);

Parameters

There is one overload rather than one per width: a narrower signed value widens to int64 on the way in, which loses nothing, so WriteInt(@builder, x as int64) covers every signed type.

Remarks

Writes a minus sign for a negative value and then the digits, with no plus sign on a positive one. Zero is the single digit 0.

Nothing is allocated here beyond whatever growth the builder needs, which is the point: ToString allocates a String per value, and a caller who is already accumulating would only free it again. The digits go straight into the block the builder already has.

The most negative int64 has no positive counterpart in its own type — negating -9223372036854775808 overflows straight back to itself — so the magnitude is taken as a uint64, and that value prints in full like any other.

Example

import Format::WriteInt;
import Text::StringBuilder;

func Main() -> int {
    var builder = StringBuilder::New();
    builder.Append("offset ");
    WriteInt(@builder, -42i64);
    builder.Append(" of ");
    WriteInt(@builder, 100i64);

    var line = builder.IntoString(); // "offset -42 of 100"

    line.Free();
    return 0;
}

See also

• Format — the package overview
• WriteUint — the same, without a sign to write
• ToString — the digits in a String of their own
• Text::StringBuilder — the builder being appended to