/ 
Data-GUID-0.00
River stage three • 37 direct dependents • 101 total dependents
/ Data::GUID

NAME

Data::GUID - globally unique identifiers

VERSION

version 0.00

$Id: /my/cs/projects/guid/trunk/lib/Data/GUID.pm 19169 2006-02-25T22:24:28.475209Z rjbs  $

SYNOPSIS

use Data::GUID;

my $guid = Data::GUID->new;

my $string = $guid->as_string; # or "$guid"

my $other_guid = Data::GUID->from_string($string);

if (($guid <=> $other_guid) == 0) {
  print "They're the same!\n";
}

DESCRIPTION

Data::GUID provides a simple interface for generating and using globally unique identifiers.

GETTING A NEW GUID

new 

my $guid = Data::GUID->new;

This method returns a new globally unique identifier.

GUIDS FROM STRINGS

These method returns a new Data::GUID object for the given GUID value.

from_string 

my $guid = Data::GUID->from_string("B0470602-A64B-11DA-8632-93EBF1C0E05A");

from_hex 

# note that a hex value is a string with out hyphens and with a leading 0x
my $guid = Data::GUID->from_string("0xB0470602A64B11DA863293EBF1C0E05A");

from_base64 

my $guid = Data::GUID->from_string("sEcGAqZLEdqGMpPr8cDgWg==");

GUIDS INTO STRINGS

These methods return string representations of a GUID.

as_string

This method is also used to stringify Data::GUID objects.

as_hex

as_base64

OTHER METHODS

as_binary

This method returns the packed binary representation of the GUID.

compare_to_guid

This method compares a GUID to another GUID and returns -1, 0, or 1, as do other comparison routines.

AUTHOR

Ricardo SIGNES, <rjbs@cpan.org>

TODO

  • add namespace support

  • remove dependency on wretched Data::UUID

BUGS

Please report any bugs or feature requests to bug-data-guid@rt.cpan.org, or through the web interface at http://rt.cpan.org. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

COPYRIGHT

Copyright 2006 Ricardo Signes, All Rights Reserved.

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