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

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.