Data::Object::Number
Data-Object Number Class
use Data::Object::Number; my $number = Data::Object::Number->new(1_000_000);
This package provides routines for operating on Perl 5 numeric data.
This package inherits behaviors from:
Data::Object::Number::Base
This package integrates behaviors from:
Data::Object::Role::Dumpable
Data::Object::Role::Functable
Data::Object::Role::Throwable
This package uses type constraints defined by:
Data::Object::Library
This package implements the following methods.
abs() : Any
The abs method returns the absolute value of the number. This method returns a Data::Object::Number object.
# given 12 $number->abs; # 12 # given -12 $number->abs; # 12
atan2(Num $arg1) : NumObject
The atan2 method returns the arctangent of Y/X in the range -PI to PI This method returns a Data::Object::Float object.
# given 1 $number->atan2(1); # 0.785398163397448
cos() : NumObject
The cos method computes the cosine of the number (expressed in radians). This method returns a Data::Object::Float object.
# given 12 $number->cos; # 0.843853958732492
decr(Num $arg1) : NumObject
The decr method returns the numeric number decremented by 1. This method returns a data type object to be determined after execution.
# given 123456789 $number->decr; # 123456788
defined() : NumObject
The defined method returns true if the object represents a value that meets the criteria for being defined, otherwise it returns false. This method returns a Data::Object::Number object.
# given $number $number->defined; # 1
downto(Int $arg1) : ArrayObject
The downto method returns an array reference containing integer decreasing values down to and including the limit. This method returns a Data::Object::Array object.
# given 10 $number->downto(5); # [10,9,8,7,6,5]
eq(Any $arg1) : NumObject
The eq method performs a numeric equality operation. This method returns a Data::Object::Number object representing a boolean.
# given 12345 $number->eq(12346); # 0
exp() : NumObject
The exp method returns e (the natural logarithm base) to the power of the number. This method returns a Data::Object::Float object.
# given 0 $number->exp; # 1 # given 1 $number->exp; # 2.71828182845905 # given 1.5 $number->exp; # 4.48168907033806
ge(Any $arg1) : NumObject
The ge method returns true if the argument provided is greater-than or equal-to the value represented by the object. This method returns a Data::Object::Number object.
# given 0 $number->ge(0); # 1
gt(Any $arg1) : NumObject
The gt method performs a numeric greater-than comparison. This method returns a Data::Object::Number object representing a boolean.
# given 99 $number->gt(50); # 1
hex() : Str
The hex method returns a hex string representing the value of the number. This method returns a Data::Object::String object.
# given 175 $number->hex; # 0xaf
incr(Num $arg1) : NumObject
The incr method returns the numeric number incremented by 1. This method returns a data type object to be determined after execution.
# given 123456789 $number->incr; # 123456790
int() : IntObject
The int method returns the integer portion of the number. Do not use this method for rounding. This method returns a Data::Object::Number object.
# given 12.5 $number->int; # 12
le(Any $arg1) : NumObject
The le method returns true if the argument provided is less-than or equal-to the value represented by the object. This method returns a Data::Object::Number object.
# given 0 $number->le; # 0
log() : FloatObject
The log method returns the natural logarithm (base e) of the number. This method returns a Data::Object::Float object.
# given 12345 $number->log; # 9.42100640177928
lt(Any $arg1) : NumObject
The lt method performs a numeric less-than comparison. This method returns a Data::Object::Number object representing a boolean.
# given 86 $number->lt(88); # 1
mod() : NumObject
The mod method returns the division remainder of the number divided by the argment. This method returns a Data::Object::Number object.
# given 12 $number->mod(1); # 0 $number->mod(2); # 0 $number->mod(3); # 0 $number->mod(4); # 0 $number->mod(5); # 2
ne(Any $arg1) : NumObject
The ne method performs a numeric equality operation. This method returns a Data::Object::Number object representing a boolean.
# given -100 $number->ne(100); # 1
neg() : IntObject
The neg method returns a negative version of the number. This method returns a Data::Object::Integer object.
# given 12345 $number->neg; # -12345
pow() : NumObject
The pow method returns a number, the result of a math operation, which is the number to the power of the argument. This method returns a Data::Object::Number object.
# given 12345 $number->pow(3); # 1881365963625
sin() : IntObject
The sin method returns the sine of the number (expressed in radians). This method returns a data type object to be determined after execution.
# given 12345 $number->sin; # -0.993771636455681
sqrt(Int $arg1) : IntObject
The sqrt method returns the positive square root of the number. This method returns a data type object to be determined after execution.
# given 12345 $number->sqrt; # 111.108055513541
to(Int $arg1) : ArrayObject
The to method returns an array reference containing integer increasing or decreasing values to and including the limit in ascending or descending order based on the value of the floating-point object. This method returns a Data::Object::Array object.
# given 5 $number->to(9); # [5,6,7,8,9] $number->to(1); # [5,4,3,2,1]
upto(Int $arg1) : Any
The upto method returns an array reference containing integer increasing values up to and including the limit. This method returns a Data::Object::Array object.
# given 23 $number->upto(25); # [23,24,25]
Al Newkirk, +296
+296
Anthony Brummett, +10
+10
José Joaquín Atria, +1
+1
Al Newkirk, awncorp@cpan.org
awncorp@cpan.org
Copyright (C) 2011-2019, Al Newkirk, et al.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
GitHub
Projects
Milestones
Contributing
Issues
To get the most out of this distribution, consider reading the following:
Do
Data::Object
Data::Object::Class
Data::Object::ClassHas
Data::Object::Role
Data::Object::RoleHas
To install Do, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Do
CPAN shell
perl -MCPAN -e shell install Do
For more information on module installation, please visit the detailed CPAN module installation guide.