| PackageDescription | 'Params::Util' provides a basic set of importable functions that makes
checking parameters a hell of a lot easier
While they can be (and are) used in other contexts, the main point behind
this module is that the functions *both* Do What You Mean, and Do The Right
Thing, so they are most useful when you are getting params passed into your
code from someone and/or somewhere else and you can't really trust the
quality.
Thus, 'Params::Util' is of most use at the edges of your API, where params
and data are coming in from outside your code.
The functions provided by 'Params::Util' check in the most strictly correct
manner known, are documented as thoroughly as possible so their exact
behaviour is clear, and heavily tested so make sure they are not fooled by
weird data and Really Bad Things.
To use, simply load the module providing the functions you want to use as
arguments (as shown in the SYNOPSIS).
To aid in maintainability, 'Params::Util' will *never* export by default.
You must explicitly name the functions you want to export, or use the
':ALL' param to just have it export everything (although this is not
recommended if you have any _FOO functions yourself with which future
additions to 'Params::Util' may clash) |