this routine searches the given array for the given scalar value and stops at the first value match found
parameters: <array reference> <scalar>
returns 1 if an element with the given scalar value was found else 0

this routine searches the given array and any hierarchy of referenced arrays for the given scalar value and stops at the first value match found
parameters: <array reference> <scalar>
returns 1 if an element with the given scalar value was found else 0

this routine searches the given hash for the given scalar value and stops at the first value match found
parameters: <hash reference> <scalar>
returns 1 if an element with the given scalar value was found else 0

this routine searches the given hash and any hierarchy of referenced hashes for the given scalar value and stops at the first value match found
parameters: <hash reference> <scalar>
returns 1 if an element with the given scalar value was found else 0

this routine searches the given hash/array and any hierarchy of referenced hashes/arrays for the given scalar value and stops at the first value match found
this routine should be used for mixed data structures of arrays and hashes.
parameters: <reference to an array or a hash> <scalar>
returns 1 if an element with the given scalar value was found else 0

This module provides routines to search content of n-dimensional arrays and/or hashes for given values.
These routines are useful for people who often test existence of specific values in complex data structures returned by other routines.
Since there are currently no such built-in functions to search arrays/hashes, one can save time by using this module.