TAP::Parser::Iterator



TAP::Parser::Iterator

NAME
VERSION
SYNOPSIS
DESCRIPTION
METHODS
SUBCLASSING
SEE ALSO

NAME

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

VERSION

Version 3.23

SYNOPSIS

  # 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     { ... }

DESCRIPTION

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

METHODS

Class Methods
"new"

Create an iterator. Provided by TAP::Object.

Instance Methods
"next"

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

Iterate through it, of course.

"next_raw"

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.

"handle_unicode"

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.

"get_select_handles"

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.

"wait"

Note: this method is abstract and should be overridden.

 my $wait_status = $iter−>wait;

Return the "wait" status for this iterator.

"exit"

Note: this method is abstract and should be overridden.

 my $wait_status = $iter−>exit;

Return the "exit" status for this iterator.

SUBCLASSING

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

You must override the abstract methods as noted above.

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

SEE ALSO

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



More Linux Commands

manpages/gnutls_sign_callback_set.3.html
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_

manpages/smi_render.3.html
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

manpages/vfs_prealloc.8.html
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

manpages/git-stash.1.html
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

manpages/realloc.3.html
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

manpages/FcPatternEqualSubset.3.html
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

manpages/gnutls_x509_crt_get_signature.3.html
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

manpages/gnutls_db_set_ptr.3.html
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

manpages/grub2-mkrelpath.1.html
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

manpages/va_copy.3.html
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

manpages/Tk_PhotoGetSize.3.html
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

manpages/fprintf.3.html
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.