Simple, compact and correct param-checking functions
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)