1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198
|
package Class::Meta::Types::Numeric;
# $Id: Numeric.pm 3937 2008-05-22 03:04:22Z david $
=head1 NAME
Class::Meta::Types::Numeric - Numeric data types
=head1 SYNOPSIS
package MyApp::Thingy;
use strict;
use Class::Meta;
use Class::Meta::Types::Numeric;
# OR...
# use Class::Meta::Types::Numeric 'affordance';
# OR...
# use Class::Meta::Types::Numeric 'semi-affordance';
BEGIN {
# Create a Class::Meta object for this class.
my $cm = Class::Meta->new( key => 'thingy' );
# Add an integer attribute.
$cm->add_attribute( name => 'age',
type => 'integer' );
$cm->build;
}
=head1 DESCRIPTION
This module provides numeric data types for use with Class::Meta attributes.
Simply load it, then pass the name of one of its types to the
C<add_attribute()> method of a Class::Meta object to create attributes of the
numeric data type. See L<Class::Meta::Type|Class::Meta::Type> for more
information on using and creating data types.
The validation checks for Class::Meta::Types::Numeric are provided by the
Data::Types module. Consult its documentation to find out what it considers to
be a number and what's not.
The data types created by Class::Meta::Types::Numeric are:
=over
=item whole
A whole number. That is, a positive integer.
=item integer
=item int
An integer number.
=item decimal
=item dec
A decimal number.
=item real
A real number.
=item float
A floating point number.
=back
=cut
use strict;
use Class::Meta::Type;
use Data::Types ();
our $VERSION = '0.63';
# This code ref builds value checkers.
my $mk_chk = sub {
my ($code, $type) = @_;
return [
sub {
return unless defined $_[0];
$code->($_[0])
or $_[2]->class->handle_error("Value '$_[0]' is not a valid "
. "$type");
}
];
};
##############################################################################
sub import {
my ($pkg, $builder) = @_;
$builder ||= 'default';
return if eval { Class::Meta::Type->new('whole') };
Class::Meta::Type->add(
key => "whole",
name => "Whole Number",
desc => "Whole number",
builder => $builder,
check => $mk_chk->(\&Data::Types::is_whole, 'whole number'),
);
Class::Meta::Type->add(
key => "integer",
name => "Integer",
desc => "Integer",
alias => 'int',
builder => $builder,
check => $mk_chk->(\&Data::Types::is_int, 'integer'),
);
Class::Meta::Type->add(
key => "decimal",
name => "Decimal Number",
desc => "Decimal number",
alias => 'dec',
builder => $builder,
check => $mk_chk->(\&Data::Types::is_decimal, 'decimal number'),
);
Class::Meta::Type->add(
key => "real",
name => "Real Number",
desc => "Real number",
builder => $builder,
check => $mk_chk->(\&Data::Types::is_real, 'real number'),
);
Class::Meta::Type->add(
key => "float",
name => "Floating Point Number",
desc => "Floating point number",
builder => $builder,
check => $mk_chk->(\&Data::Types::is_float, 'floating point number'),
);
}
1;
__END__
=head1 SUPPORT
This module is stored in an open repository at the following address:
L<https://svn.kineticode.com/Class-Meta/trunk/>
Patches against Class::Meta are welcome. Please send bug reports to
<bug-class-meta@rt.cpan.org>.
=head1 AUTHOR
David Wheeler <david@kineticode.com>
=head1 SEE ALSO
Other classes of interest within the Class::Meta distribution include:
=over 4
=item L<Class::Meta|Class::Meta>
This class contains most of the documentation you need to get started with
Class::Meta.
=item L<Class::Meta::Type|Class::Meta::Type>
This class manages the creation of data types.
=item L<Class::Meta::Attribute|Class::Meta::Attribute>
This class manages Class::Meta class attributes, all of which are based on
data types.
=back
Other data type modules:
=over 4
=item L<Class::Meta::Types::Perl|Class::Meta::Types::Perl>
=item L<Class::Meta::Types::String|Class::Meta::Types::String>
=item L<Class::Meta::Types::Boolean|Class::Meta::Types::Boolean>
=back
=head1 COPYRIGHT AND LICENSE
Copyright (c) 2002-2008, David Wheeler. Some Rights Reserved.
This module is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.
=cut
|