---
name: "Types::Standard::StrMatch"
section: "3pm"
platform: "linux"
package: "perl-type-tiny"
version: "2.010001-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Types::Standard::StrMatch"
---

# Types::Standard::StrMatch(3pm)

exporter utility for the StrMatch type constraint

## NAME

Types::Standard::StrMatch - exporter utility for the StrMatch type constraint

## SYNOPSIS

```
  use Types::Standard -types;

  # Normal way to validate a string against a regular expression.
  #
  StrMatch->of( qr/.../ )->assert_valid( "foo" );

  use Types::Standard::StrMatch Identifier => { re => qr/.../ },

  # Exported shortcut
  #
  assert_Identifier "foo";
```

## STATUS

This module is not covered by the Type-Tiny stability policy.

## DESCRIPTION

This is mostly internal code, but can also act as an exporter utility.

### Exports

Types::Standard::ScalarRef can be used experimentally as an exporter.

```
  use Types::Standard::StrMatch Identifier => { re => qr/.../ };
```

This will export the following functions into your namespace:

- "Identifier"

  - is\_Identifier( $value )

  - assert\_Identifier( $value )

  - to\_Identifier( $value )

  Multiple types can be exported at once:

```
  use Types::Standard -types;
  use Types::Standard::StrMatch (
    Identifier  => { re => qr/.../ },
    Url         => { re => qr/.../ },
         Email       => { re => qr/.../ },
  );

  assert_Email 'tobyink@example.net';   # should not die
```

It's possible to further constrain the string using `"where"`:

```
  use Types::Standard::StrMatch MyThing => { re => qr/.../, where => sub { ... } };
```

## BUGS

Please report any bugs to \<https://github.com/tobyink/p5-type-tiny/issues\>.

## SEE ALSO

Types::Standard.

## AUTHOR

Toby Inkster \<tobyink@cpan.org\>.

## COPYRIGHT AND LICENCE

This software is copyright (c) 2013-2025 by Toby Inkster.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

## DISCLAIMER OF WARRANTIES

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.