TomOutputTranscript class

A program's output, bounded.

Bounded is the point. A runaway loop that prints is exactly the case a transcript must not turn into an out-of-memory, and it is also the commonest reason somebody reads one. So the cap is a fact the reader is told rather than a silent truncation: droppedLines says how many lines went unretained, and whatever shows the transcript has to say so.

Constructors

TomOutputTranscript({List<TomOutputLine> lines = const [], int droppedLines = 0})
const

Properties

droppedLines → int
How many lines were produced beyond the bound and never retained.
final
hashCode → int
The hash code for this object.
no setterinherited
isEmpty → bool
no setter
isNotEmpty → bool
no setter
lines → List<TomOutputLine>
The retained lines, oldest first.
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
truncated → bool
no setter

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited

Static Methods

clip(String text) → String
text, clipped to maxLineLength with the clipping stated in the line itself — so a reader who sees a suspiciously round line knows why.

Constants

empty → const TomOutputTranscript
maxLineLength → const int
The per-line ceiling. A single line can be arbitrarily long — a program that prints a whole document makes one — and a transcript that kept it would defeat maxLines with one write.
maxLines → const int
The default line ceiling. Large enough that an ordinary debugging session never meets it, small enough that a runaway stays in the low megabytes.