TAP::Parser::Iterator − Base class for TAP source iterators


Version 3.23


  # to subclass:
  use vars qw(@ISA);
  use TAP::Parser::Iterator ();
  @ISA = qw(TAP::Parser::Iterator);
  sub _initialize {
    # see TAP::Object...
  sub next_raw { ... }
  sub wait     { ... }
  sub exit     { ... }


This is a simple iterator base class that defines TAP::Parser’s iterator API . Iterators are typically created from TAP::Parser::SourceHandlers.


Class Methods

Create an iterator. Provided by TAP::Object.

Instance Methods

 while ( my $item = $iter−>next ) { ... }

Iterate through it, of course.


Note: this method is abstract and should be overridden.

 while ( my $item = $iter−>next_raw ) { ... }

Iterate raw input without applying any fixes for quirky input syntax.


If necessary switch the input stream to handle unicode. This only has any effect for I/O handle based streams.

The default implementation does nothing.


Return a list of filehandles that may be used upstream in a select() call to signal that this Iterator is ready. Iterators that are not handle-based should return an empty list.

The default implementation does nothing.


Note: this method is abstract and should be overridden.

 my $wait_status = $iter−>wait;

Return the "wait" status for this iterator.


Note: this method is abstract and should be overridden.

 my $wait_status = $iter−>exit;

Return the "exit" status for this iterator.


Please see " SUBCLASSING " in TAP::Parser for a subclassing overview.

You must override the abstract methods as noted above.

TAP::Parser::Iterator::Array is probably the easiest example to follow. There’s not much point repeating it here.


TAP::Object, TAP::Parser, TAP::Parser::Iterator::Array, TAP::Parser::Iterator::Stream, TAP::Parser::Iterator::Process,

More Linux Commands

gnutls_sign_callback_set(3) - API function - Linux man page
Set the callback function. The function must have this prototype: typedef int (*gnutls_sign_func) (gnutls_session_t session, void *userdata, gnutls_certificate_

smi_render(3) - SMI data and MIB data rendering routines....
These functions provide can be used to render OIDs, values of MIB data, or names of MIB nodes or types. The smiRenderOID() function renders an OID given by its

vfs_prealloc(8) - preallocate matching files to a predetermi
This VFS module is part of the samba(7) suite. The vfs_prealloc VFS module preallocates files to a specified size each time a new file is created. This is usefu

git-stash(1) - Stash the changes in a dirty working director
Use git stash when you want to record the current state of the working directory and the index, but want to go back to a clean working directory. The command sa

realloc(3) - Allocate and free dynamic memory (Man Page)....
The malloc() function allocates size bytes and returns a pointer to the allocated memory. The memory is not initialized. If size is 0, then malloc() returns eit

FcPatternEqualSubset(3) - Compare portions of patterns......
Returns whether pa and pb have exactly the same values for all of the objects in os. VERSION Fontconfig version 2.8.0 FcPatternEqualSubset.3 (Library - Linux ma

gnutls_x509_crt_get_signature(3) - API function (Man Page)
This function will extract the signature field of a certificate. RETURNS On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. and a n

gnutls_db_set_ptr(3) - API function - Linux manual page.....
Sets the pointer that will be provided to db store, retrieve and delete functions, as the first argument. REPORTING BUGS Report bugs to <bug-gnutls@gnu.org>. Gn

grub2-mkrelpath(1) make a system path relative to its root
Transform a system filename into GRUB one. -r, --relative use relative path on btrfs -?, --help give this help list --usage give a short usage message -V, --ver

va_copy(3) - variable argument lists - Linux manual page....
A function may be called with a varying number of arguments of varying types. The include file <stdarg.h> declares a type va_list and defines three macros for s

Tk_PhotoGetSize(3) - manipulate the image data stored in a p
Tk_FindPhoto returns an opaque handle that is used to identify a particular photo image to the other procedures. The parameter is the name of the image, that is

fprintf(3) - formatted output conversion - Linux man page...
The functions in the printf() family produce output according to a format as described below. The functions printf() and vprintf() write output to stdout, the s

We can't live, work or learn in freedom unless the software we use is free.