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.