plucky (3) Badger::Data::Type.3pm.gz

Provided by: libbadger-perl_0.16-3_all bug

NAME

       Badger::Data::Type - base class for data types

DESCRIPTION

       This module implements a base class for data types.

CONFIGURATION OPTIONS

   name
       An optional name for the data type.

   namespace
       An optional namespace for the data type.

   base
       An optional base data type.

   facets
       An optional list of validation facets.

METHODS

       The following methods are defined in addition to those inherited from the Badger::Base base class.

   init()
       This is aliased to the init_type() method.

   init_type($config)
       This is the initialisation method for a data type.  It is called automatically when a data type object is
       created via the new() method inherited from the Badger::Base base class.

   name()
       Returns the name of the data type as specified via the name configuration option.  If no name was
       specified then an automatically generated name is returned based on the class name with the
       "Badger::Data::Type" prefix removed and all "::" sequences replaced with periods, e.g. a data type
       "Badger::Data::Type::Foo::Bar" would yield a name of "Foo.Bar".

   namespace()
       Returns the namespace for the data type, or "undef" is none is defined.

   base()
       Returns the base data type, or "undef" is none is defined.

   facets()
       Returns a reference to a list of validation facets defined for the data type.

   simple()
       This constant method always returns the value 0.  Subclasses representing simple data types should re-
       define this to return the value 1.

   complex()
       This constant method always returns the value 0.  Subclasses representing complex data types should re-
       define this to return the value 1.

   constrain($facet, @args)
       Applies a new validation facet to the data type.

   validate($value_ref)
       Validates the value passed by reference as the first argument.  It calls the "validate()" method of each
       of the validation facets in turn.

AUTHOR

       Andy Wardley <http://wardley.org/>

       Copyright (C) 2008-2012 Andy Wardley.  All Rights Reserved.

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

SEE ALSO

       Badger::Base