NAME

KinoSearch::Util::ToolSet - strict, warnings, and more

PRIVATE CLASS

This is a private class and the interface may change radically and without warning. Do not use it on its own.

SYNOPSIS

    use KinoSearch::Util::ToolSet;

DESCRIPTION

KinoSearch::Util::ToolSet uses David Golden's ToolSet module to create a default environment and replace several lines of code at the top of each module with one. The line...

    use KinoSearch::Util::ToolSet;

... is effectively an alias for...

    use strict;   # strict and warnings really are turned on!
    use warnings;
    use bytes; no bytes;
    use Carp qw( carp croak cluck confess );
    use Scalar::Util qw( 
                         refaddr
                         blessed 
                         dualvar 
                         isweak 
                         refaddr 
                         reftype 
                         tainted 
                         weaken 
                         isvstring 
                         looks_like_number 
                         );
    use KinoSearch qw( K_DEBUG kdump );
    use KinoSearch::Util::VerifyArgs qw( verify_args a_isa_b );

Two issues deserve special attention.

First, the use bytes; no bytes; combo ensures that subroutines within the bytes:: namespace, such as bytes::length, will be available, while still keeping character semantics enabled by default -- so regexes work as expected, etc.

Second, the use KinoSearch line does a LOT more than it appears to at first glance -- it loads ALL of the XS routines in the entire KinoSearch suite. See KinoSearch::Docs::DevGuide for an explanation.

COPYRIGHT

Copyright 2005-2006 Marvin Humphrey

LICENSE, DISCLAIMER, BUGS, etc.

See KinoSearch version 0.05_03.