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

NAME

Set::Relation::V2 - Bundled second implementation of Set::Relation role

VERSION

This document describes Set::Relation::V2 version 0.13.1 for Perl 5.

SYNOPSIS

See the SYNOPSIS of Set::Relation, which represents this file also.

DESCRIPTION

Set::Relation::V2 provides the second complete implementation of the Set::Relation role, following Set::Relation::V1, and it does not implement the Set::Relation::Mutable role. This newer version is the one you should be using in practice, rather than the older one, since it should have better performance.

There are 2 main differences that Set::Relation::V2 has from Set::Relation::V1. The first is that V2 provides immutable objects while V1 provides mutable objects. The second is that V2 is lazy and will defer any tests for duplicate tuples as late as possible, while V1 is eager and will test for duplicate tuples as early as possible; V2 will also respect true $allow_dup_tuples arguments, while V1 will ignore them. Besides those 2 matters and their associated large differences in performance profiles, V2 is essentially the same as V1, including that relation tuples are internally represented by Perl Hashes.

INTERFACE

Set::Relation::V2 composes the Set::Relation role declared in the Set::Relation file.

DIAGNOSTICS

This documentation is pending.

CONFIGURATION AND ENVIRONMENT

This documentation is pending.

DEPENDENCIES

This file requires any version of Perl 5.x.y that is at least 5.8.1.

It also requires these Perl 5 packages that are available both bundled with Perl 5.8.1+ and on CPAN: Carp-ver(1.01..*), Scalar::Util-ver(1.13..*).

It also requires these Perl 5 packages that are available both bundled with Perl 5.25.1+ and on CPAN: List::Util-ver(1.45..*).

INCOMPATIBILITIES

None reported.

SEE ALSO

Go to Set::Relation for the majority of both distribution-internal and external references.

BUGS AND LIMITATIONS

This documentation is pending.

AUTHOR

Darren Duncan (darren@DarrenDuncan.net)

LICENSE AND COPYRIGHT

Set::Relation is Copyright © 2006-2016, Muldis Data Systems, Inc.

See the LICENSE AND COPYRIGHT of Set::Relation for details.

ACKNOWLEDGEMENTS

The ACKNOWLEDGEMENTS in Set::Relation apply to this file too.