Construct a new number. The arguments are the value,
the anonymous array of flecks that make up the flex,
followed by an anonymous hash of other arguments.
The flex will default to [0..9] and the other arguments
will default to an empty hash.
If a value is passed it can be an existing Math::Fleximal or (as above) a string that can be parsed with the current flex.
The possible keys to the optional arguments are:
The parsing of a string into flecks is case sensitive. Also possibly ambiguous parses are not handled very well.
|dup||Copy an existing number. This copy may be worked with without changing the existing number. If dup is passed a value, the new instance will have that value instead.|
This sets the internal value and returns the object.
You can either pass the new value an existing instance (which may be in another base) or a string. When passed a string it first strips whitespace. After that it accepts an optional +-, followed by a series of flecks (there must be at least one) for the first to last digits. It will be confused if the leading fleck starts with + or - and no sign is included.
|to_str||Returns the string representation of the current value using the current flex. This always includes a sign, with no white space in front of the sign.|
|base_10||Returns the internal value in a base 10 representation. The numbers returned may be larger than Perls usual integer representation can handle.|
|change_flex||Takes a new flex and converts the current to that. Will implicitly change base if needed.|
|add||Adds one or more numbers to the current one and returns the answer in the current representation. The numbers may be objects in any base, or strings of the current representation.|
|mul||Multiplies one or more numbers to the current one and returns the answer in the current representation. The numbers may be objects in any base, or strings of the current representation.|
|subtr||Subtracts one or more numbers from the current one and returns the answer in the current representation. The numbers may be objects in any base, or strings of the current representation.|
|div||Divides one or more numbers from the current one and returns the answer in the current representation. In list context it will return the answer and an array of remainders in the current representation. The remainders will be positive and less than the absolute value of the denominator. The numbers may be objects in any base, or strings of the current representation.|
|gcd||Takes one or more numbers and calculates the gcd of this and the entire list.|
Does the divisions as div does and returns only the
remainders. In scalar context only the last remainder
is returned. Thus the following returns the
|cmp||Pass another number, returns -1 if it is smaller than the other number, 0 if they are equal, and 1 if it is larger. (Much like cmp does with strings.)|
|one||Returns 1 in the current flex.|
|zero||Returns 0 in the current flex.|
This will fail if you are trying to work in bases of size more than 30,000 or so.
Only a slight effort is made to resolve potential ambiguities in the parsing of a string into flecks.
Copyright 2000-2001, Ben Tilly (<email@example.com>)
Math::Fleximal may be copied and distributed on the same terms as Perl itself.
|perl v5.20.3||MATH::FLEXIMAL (3)||2005-04-10|