NAME

SuperSplit::Obj - Provides object interface to SuperSplit

SYNOPSIS

 use SuperSplit::Obj;
 
 #example: split on newlines and whitespace and print
 #the same data joined on tabs and whitespace. The split works on STDIN
 #
 $s = SuperSplit::Obj->new();
 $s->stdin();
 $array = $s->split();
 #
 #use filehandle, filename to open or string:
 $s->handle( $fh );
 $s->open( "<$filename" );
 $s->text( $string );
 #
 #use separators
 $s->sep( @separator_array );
 #use limits
 $s->limits( @limit_array );
 #split everything, and join it using @sep
 $s->splitjoin( @sep );
 

DESCRIPTION

This module just provides an object-interface to the SuperSplit module. You initialize it using the input specifiers, and optionally the separator and/or LIMIT separators. The behavior is just like the supersplit_hashref method of the SuperSplit module.

new()

Initialises the object and retuns it, aka just what you expect from a simple object constructor.

stdin()

Tells the object to use STDIN to obtain data. STDIN is read right away.

handle( $fh )

Tells the object to use the filehandle $fh for input. $fh is read right away, and left open in case you want to "seek" in perlfunc.

open( ">$filename" )

Tells the object to get data from the argument using an open statement. It returns the opened and read filehandle, or undef if something went wrong.

string( $string )

Tells the object to use the string for data input.

sep( @separator_array )

Uses the given array as separators. Synonyms: separator(); separators().

limit( @limit_array )

Uses the given array as LIMITs. Synonyms: lim(); limits().

split()

Perform the actual multi-dimensional splitting using earlier provided arguments. It returns a multi-dimensional array.

join( @args )

Behaves exactly like the superjoin method. So you don't even need to use the constructor before calling it.

splitjoin( @args )

This method combines the previous two. It first splits like the split method, and than joins the resulting array with the provided arguments, passing them to superjoin.

AUTHOR

Jeroen Elassaiss-Schaap.

LICENSE

Perl/ artisitic license

STATUS

Alpha