NAME

Devel::MAT::Tool::Find - list SVs matching given criteria

DESCRIPTION

This Devel::MAT tool provides a command to search for SVs matching given criteria.

COMMANDS

find

   pmat> find io
   IO()=IO::File at 0x55a7e4d88760: ifileno=1 ofileno=1
   ...

Prints a list of all the SVs that match the given filter criteria.

Takes the following named options:

--count, -C

Just count the matching SVs and print the total

FILTERS

pv

   pmat> find pv "boot"
   SCALAR(PV) at 0x556e4737d968: "boot_Devel::MAT::Dumper"
   SCALAR(PV) at 0x556e4733a160: "boot_Cwd"
   ...

Prints a list of all the scalar SVs that have a PV (string value) matching the supplied pattern. Normally, the pattern is interpreted as a substring match, but the --eq and --regexp options can alter this.

Takes the following named options:

--eq

Interpret the pattern as a full string equality match, instead of substring.

--regexp, -r

Interpret the pattern as a regular expression, instead of a literal substring.

--ignorecase, -i

Match case-insensitively, for any of substring, equality or regexp match.

io

   pmat> find io
   IO()=IO::File at 0x55a7e4d88760: ifileno=1 ofileno=1
   ...

   pmat> find io -f 2
   IO()=IO::File at 0x55582b87f430: ifileno=2 ofileno=2

Searches for IO handles

Takes the following named options:

--fileno, -f INT

Match only IO handles associated with the given filenumber.

blessed

   pmat> find blessed Config
   HASH(26)=Config at 0x55bd56c28930

Searches for SVs blessed into the given package name.

AUTHOR

Paul Evans <leonerd@leonerd.org.uk>