---
name: "Devel::MAT::Tool::Find"
section: "3pm"
platform: "linux"
package: "libdevel-mat-perl"
version: "0.53-1+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Devel::MAT::Tool::Find"
---

# Devel::MAT::Tool::Find(3pm)

list SVs matching given criteria

## 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

### num

```
   pmat> find num
   SCALAR(UV) at 0x555555a1e9c0: 5
   SCALAR(UV) at 0x555555c4f1b0: 2
   SCALAR(UV) at 0x555555aa0dc0: 18446744073709551615
```

Prints a list of all the scalar SVs that have a numerical value, optionally filtering for only an exact value.

Takes the following named options:

- \--nv, --iv, --uv

  Find only numerical SVs of the given types. If no options present, any numerical SV will be found.

### 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.

### lexical

```
   pmat> find lexical $x
   UNDEF() at 0x56426e97c8b0: $x at depth 1 of CODE(PP) at 0x56426e97c5e0
   ...
```

Searches for SVs that are lexical variables of the given name.

### struct

```
   pmat> find struct Module::Name/Type
   C_STRUCT(Module::Name/Type) at 0x55e0c3017bf0: Module::Name/Type
   ...
```

Searches for SVs that are C structures of the given type name.

### magic

## AUTHOR

Paul Evans \<leonerd@leonerd.org.uk\>