Data.UUID

Haskell bindings to libuuid. The library libuuid is available as a part of e2fsprogs: http://e2fsprogs.sourceforge.net/.

This library is useful for creating, comparing, parsing and printing Universally Unique Identifiers. See http://en.wikipedia.org/wiki/UUID for the general idea.

Documentation

data UUID

The UUID type. Represents 128-bits of identification.

Instances

Eq UUID

Data UUID

Ord UUID

Read UUID

Show UUID

Typeable UUID

Storable UUID

fromString :: String -> Maybe UUID

If the passed in String can be parsed as a UUID, it will be. The hyphens may not be omitted. Example:

  fromString "c2cc10e1-57d6-4b6f-9899-38d972112d8c"

Hex digits may be upper or lower-case.

toString :: UUID -> String

Returns a String representation of the passed in UUID. Hex digits occuring in the output will be either upper or lower-case depending on system defaults and locale.

toStringUpper :: UUID -> String

Returns a String representation of the passed in UUID. Hex digits occuring in the output will be upper-case.

toStringLower :: UUID -> String

Returns a String representation of the passed in UUID. Hex digits occuring in the output will be lower-case.

generate :: IO UUID

Creates a new UUID. If /dev/urandom is available, it will be used. Otherwise a UUID will be generated based on the current time and the hardware MAC address, if available.

generateRandom :: IO UUID

Create a new UUID. If /dev/urandom is available, it will be used. Otherwise a psuedorandom generator will be used.

generateTime :: IO UUID

Create a new UUID. The UUID will be generated based on the current time and the hardware MAC address, if available.

null :: UUID -> Bool

Returns True if the passed-in UUID is the null UUID.