NAME

Data::Range::Compare::Stream::CallBack - Dynamic compare support plugin

SYNOPSIS

use Data::Range::Compare::Stream::CallBack qw(%HELPER);

# create the factory instance we will hand around
my $factory_instance=new Data::Range::Compare::Stream::CallBack(\%HELPER);

DESCRIPTION

This module module provides a dynamic method of supporting diffrent data types without the need to subclass Data::Range::Compare::Stream. Note: this class does in fact subclass Data::Range::Compare::Stream.

Exports

%HELPER is exported by default.

%HELPER is a hash that contains 3 anonymous functions.

our %HELPER=(
  sub_one=>sub { $_[0] - 1 },
  add_one=>sub { $_[0] + 1 },
  cmp_values=>sub { $_[0] <=> $_[1] },
);

OO Methods

This section covers the OO Methods in the package.

• my $range=new Data::Range::Compare::Stream::CallBack(\%HELPER,$range_start,$range_end);

• my $range=new Data::Range::Compare::Stream::CallBack(\%HELPER$range_start,$range_end,$data);

• my $factory_instance=new Data::Range::Compare::Stream::CallBack(\%HELPER);

  Object constructor: Creates a new instance of Data::Range::Compare::Stream.

  Arguments an their meanings:

  \%HELPER  -- Required.
    This hash ref use used to handle comparison, addition and subtraction
  
  $range_start -- Required
    Represents the start of this given range
  
  $range_end -- Required
    Represents the end of this range.
  
  $data -- Optional
    Used to tag this range with your data

• my $new_value=$range->sub_one($value);

  Computes and returns the object that came before this $value. This function uses the helper->{sub_one} code ref to handle the call.

• my $new_value=$range->add_one($value)

  Computes and returns the object that comes after this $value. This function uses the $helper->{add_one} code ref to handle the call.

• my $cmp=$range->cmp_values($value_a,$value_b)

  Returns -1,0,1 similar to <=> or cmp. This function uses the $helper->{cmp_values} code ref to handle the call.

• my $range=$factory_instance->factory(0,1);

• my $range=$factory_instance->factory(0,1,$data);

  Given an instance of Data::Range::Compare::Stream::CallBack, this function is used to create a new range object that will also contain the related %HELPER function.

SEE ALSO

Data::Range::Compare::Stream::Cookbook

AUTHOR

Michael Shipper

Source-Forge Project

As of version 0.001 the Project has been moved to Source-Forge.net

Data Range Compare https://sourceforge.net/projects/data-range-comp/

COPYRIGHT

Copyright 2011 Michael Shipper. All rights reserved.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.