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

# [NAME](#NAME)

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

# [SYNOPSIS](#SYNOPSIS)

```
  use Types::Standard -types;
  
  # Normal way to validate a reference to a string.
  #
  ScalarRef->of( Str )->assert_valid( \ "foo" );
  
  use Types::Standard::ScalarRef StrRef => { of => Str },
  
  # Exported shortcut
  #
  assert_StrRef \ "foo";
```

# [STATUS](#STATUS)

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

# [DESCRIPTION](#DESCRIPTION)

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

## [Exports](#Exports)

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

```
  use Types::Standard 'Str';
  use Types::Standard::ScalarRef StrRef => { of => Str };
```

This will export the following functions into your namespace:

"StrRef"

[is\_StrRef( $value )](#is_StrRef%28)

[assert\_StrRef( $value )](#assert_StrRef%28)

[to\_StrRef( $value )](#to_StrRef%28)

Multiple types can be exported at once:

```
  use Types::Standard -types;
  use Types::Standard::ScalarRef (
    IntRef  => { of => Int },
    StrRef  => { of => Str },
  );
  
  assert_IntRef \42;   # should not die
```

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

```
  use Types::Standard::ScalarRef MyThing => { of => Str, where => sub { ... } };
```

# [BUGS](#BUGS)

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

# [SEE ALSO](#SEE_ALSO)

Types::Standard.

# [AUTHOR](#AUTHOR)

Toby Inkster <tobyink@cpan.org>.

# [COPYRIGHT AND LICENCE](#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](#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.

2026-10-25 perl v5.44.0

---

Document: Types::Standard::ScalarRef(3pm) from perl-type-tiny 2.010001-r4 (Chainguard OS)
Source: https://github.com/tobyink/p5-type-tiny