Specio::Library::Builtins

Section: User Contributed Perl Documentation (3)
Updated: 2021-01-31
Page Index

NAME

Specio::Library::Builtins - Implements type constraint objects for Perl's built-in types

VERSION

version 0.47

DESCRIPTION

This library provides a set of types parallel to those provided by Moose.

The types are in the following hierarchy

  Item
      Bool
      Maybe (of `a)
      Undef
      Defined
          Value
              Str
                  Num
                      Int
                  ClassName
          Ref
              ScalarRef (of `a)
              ArrayRef (of `a)
              HashRef (of `a)
              CodeRef
              RegexpRef
              GlobRef
              FileHandle
              Object

Item

Accepts any value

Bool

Accepts a non-reference that is "undef", an empty string, 0, or 1. It also accepts any object which overloads boolification.

Maybe (of `a)

A parameterizable type which accepts "undef" or the type "`a". If not parameterized this type will accept any value.

Undef

Only accepts "undef".

Value

Accepts any non-reference value.

Str

Accepts any non-reference value or an object which overloads stringification.

Num

Accepts nearly the same values as "Scalar::Util::looks_like_number", but does not accept numbers with leading or trailing spaces, infinities, or NaN. Also accepts an object which overloads numification.

Int

Accepts any integer value, or an object which overloads numification and numifies to an integer.

ClassName

Accepts any value which passes "Str" where the string is a loaded package.

Ref

Accepts any reference.

ScalarRef (of `a)

Accepts a scalar reference or an object which overloads scalar dereferencing. If parameterized, the dereferenced value must be of type "`a".

ArrayRef (of `a)

Accepts a array reference or an object which overloads array dereferencing. If parameterized, the values in the arrayref must be of type "`a".

HashRef (of `a)

Accepts a hash reference or an object which overloads hash dereferencing. If parameterized, the values in the hashref must be of type "`a".

CodeRef

Accepts a code (sub) reference or an object which overloads code dereferencing.

RegexpRef

Accepts a regex object created by "qr//" or an object which overloads regex interpolation.

GlobRef

Accepts a glob reference or an object which overloads glob dereferencing.

FileHandle

Accepts a glob reference which is an open file handle, any "IO::Handle" Object or subclass, or an object which overloads glob dereferencing and returns a glob reference which is an open file handle.

Object

Accepts any blessed object.

SUPPORT

Bugs may be submitted at <https://github.com/houseabsolute/Specio/issues>.

I am also usually active on IRC as 'autarch' on "irc://irc.perl.org".

SOURCE

The source code repository for Specio can be found at <https://github.com/houseabsolute/Specio>.

AUTHOR

Dave Rolsky <autarch@urth.org>

COPYRIGHT AND LICENSE

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)

The full text of the license can be found in the LICENSE file included with this distribution.