| UUID::URandom(3pm) | User Contributed Perl Documentation | UUID::URandom(3pm) |
UUID::URandom - UUIDs based on /dev/urandom or the Windows Crypto API
version 0.001
use UUID::URandom qw/create_uuid/;
my $uuid = create_uuid();
This module provides a portable, secure generator of RFC-4122 <https://tools.ietf.org/html/rfc4122> version 4 (random) UUIDs. It is a thin wrapper around Crypt::URandom to set the UUID version and variant bits required by the RFC.
No functions are exported by default.
my $uuid = create_uuid();
# "\x95\x5a\xe4\x96\x8b\xb2\x45\x0b\x9c\x7e\x99\xf5\x01\xdf\x90\xfe"
This returns a new UUID as a 16 byte 'binary' string.
my $uuid = create_uuid_hex();
# "955ae4968bb2450b9c7e99f501df90fe"
This returns a new UUID as a 32-byte hexadecimal string.
my $uuid = create_uuid_string();
# "955ae496-8bb2-450b-9c7e-99f501df90fe"
This returns a new UUID in the 36-byte RFC-4122 canonical string representation. (N.B. The canonical representation is lower-case.)
The underlying Crypt::URandom is believed to be fork and thread safe.
There are a number of other modules that provide version 4 UUIDs. Many rely on insecure or non-crypto-strength random number generators.
Please report any bugs or feature requests through the issue tracker at <https://github.com/dagolden/UUID-URandom/issues>. You will be notified automatically of any progress on your issue.
This is open source software. The code repository is available for public review and contribution under the terms of the license.
<https://github.com/dagolden/UUID-URandom>
git clone https://github.com/dagolden/UUID-URandom.git
David Golden <dagolden@cpan.org>
This software is Copyright (c) 2018 by David Golden.
This is free software, licensed under:
The Apache License, Version 2.0, January 2004
| 2022-11-19 | perl v5.36.0 |