The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Fsdb::Support::DelayPassComments - support for buffering comments

SYNOPSIS

Buffer and send out comments

FUNCTIONS

new

    $filter->{_delay_pass_comments} = new Fsdb::Support::DelayPassComments;

or more likely, one uses it indirectly with Fsdb::Filter and Fsdb::IO::Reader:

    $self->{_in} = finish_io_options('input', -comment_handler => create_delay_pass_comments_sub);
    $self->{_out} = new Fsdb::IO::Writer(...);
    ...
    # in Fsdb::Filter
    $self->{_delay_comments}->flush($self->{_out};

Creates a buffer for comments that will run with bounded memory usage. New requires the output stream, a Fsdb::IO::Writer object. Fsdb::Filter will dump these after all other output.

enqueue

    $dpc->enqueue($comment [, $other_comments...])

Save up the $COMMENT.

spill_to_disk

    $dpc->spill_to_disk

Internal: switch from in-memory caching to disk caching.

flush

    $dpc->flush($output_fsdb);

Dump all saved comments to the saved Fsdb::IO::Writer, or if $OUTPUT_FSDB is undef, then to stdout.