Types::Standard::StrMatch(3) User Contributed Perl Documentation Types::Standard::StrMatch(3)

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

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";

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

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

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"

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 { ... } };

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

Types::Standard.

Toby Inkster <tobyink@cpan.org>.

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.

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.

2025-07-14 perl v5.42.0