/ 
Math-Int64-0.07
River stage two • 28 direct dependents • 86 total dependents
/ Math::Int64

NAME

Math::Int64 - Manipulate 64 bits integers in Perl

SYNOPSIS

use Math::Int64 qw(int64);

my $i = int64(1);
my $j = $i << 40;
my $k = int64("12345678901234567890");
print($i + $j * 1000000);

DESCRIPTION

This module adds support for 64 bit integers, signed and unsigned, to Perl.

EXPORTABLE FUNCTIONS

int64()
int64($value)

Creates a new int64 value and initializes it to $value, where $value can be a Perl number or a string containing a number.

For instance:

$i = int64(34);
$j = int64("-123454321234543212345");

$k = int64(1234567698478483938988988); # wrong!!!
                                       #  the unquoted number would
                                       #  be converted first to a
                                       #  real number causing it to
                                       #  loose some precision.

Once the int64 number is created it can be manipulated as any other Perl value supporting all the standard operations (addition, negation, multiplication, postincrement, etc.).

net_to_int64($str)

Converts an 8 bytes string containing an int64 in network order to the internal representation used by this module.

int64_to_net($int64)

Returns an 8 bytes string with the representation of the int64 value in network order.

native_to_int64($str)
int64_to_native($int64)

similar to net_to_int64 and int64_to_net, but using the native CPU order.

int64_to_number($int64)

returns the optimum representation of the int64 value using Perl internal types (IV, UV or NV). Precision could be lost.

For instance:

for my $l (10, 20, 30, 40, 50, 60) {
  my $i = int64(1) << $l;
  my $n = int64_to_number($i);
  print "int64:$i => perl:$n\n";
}
uint64
uint64_to_number
net_to_uint64
uint64_to_net
native_to_uint64
uint64_to_native

These functions are similar to their int64 counterparts, but manipulate 64 bit unsigned integers.

BUGS AND SUPPORT

At this moment, this module requires int64 support from the C compiler. Also, it doesn't take any advantage of perls with 64 bit IVs.

For bug reports, feature requests or just help using this module, use the RT system at http://rt.cpan.org or send my and email or both!

The source code of this module is hosted at GitHub: http://github.com/salva/p5-Math-Int64.

SEE ALSO

Other modules that allow Perl to support larger integers or numbers are Math::BigInt, Math::BigRat and Math::Big, Math::BigInt::BitVect, Math::BigInt::Pari and Math::BigInt::GMP.

COPYRIGHT AND LICENSE

Copyright © 2007, 2009 by Salvador Fandiño (sfandino@yahoo.com)

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.