---
name: "APR::UUID"
section: "3pm"
platform: "linux"
package: "libapache2-mod-perl2"
version: "2.0.13-2+b2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/APR::UUID"
---

# APR::UUID(3pm)

Perl API for manipulating APR UUIDs

## NAME

APR::UUID - Perl API for manipulating APR UUIDs

## Synopsis

```
  use APR::UUID ();

  # get a random UUID and format it as a string
  my $uuid = APR::UUID->new->format;
  # $uuid = e.g. 'd48889bb-d11d-b211-8567-ec81968c93c6';

  # same as the object returned by APR::UUID->new
  my $uuid_parsed = APR::UUID->parse($uuid);
```

## Description

`"APR::UUID"` is used to get and manipulate random UUIDs.

It allows you to `"create"` random UUIDs, which when `"formatted"` returns a string like:

```
  'd48889bb-d11d-b211-8567-ec81968c93c6';
```

which can be parsed back into the `"APR::UUID"` object with `parse()`.

## API

`"APR::UUID"` provides the following functions and/or methods:

### "format"

Convert an `"APR::UUID object"` object into a string presentation:

```
  my $uuid_str = $uuid->format;
```

- obj: $uuid ( "APR::UUID object" )

  - ret: $uuid\_str

  returns a string representation of the object (.e.g `'d48889bb-d11d-b211-8567-ec81968c93c6'`).

- since: 2.0.00

  ### "new"

Create a `"APR::UUID object"` using the random engine:

```
  my $uuid = APR::UUID->new;
```

- class: "APR::UUID" ( "APR::UUID class" )

  - ret: $uuid ( "APR::UUID object" )

  - since: 2.0.00

  ### "DESTROY"

```
  $uuid->DESTROY;
```

- obj: "APR::UUID" ( "APR::UUID object" )

  - ret: no return value

  - since: 2.0.00

  Do not call this method, it's designed to be only called by Perl when the variable goes out of scope. If you call it yourself you will get a segfault when perl will call DESTROY on its own.

### "parse"

Convert a UUID string into an `"APR::UUID` `object"` object:

```
  $uuid = APR::UUID->parse($uuid_str)
```

- arg1: $uuid\_str (string)

  UUID string (.e.g `'d48889bb-d11d-b211-8567-ec81968c93c6'`)

- ret: $uuid ( "APR::UUID object" )

  The new object.

- since: 2.0.00

  ## See Also

mod\_perl 2.0 documentation.

## Copyright

mod\_perl 2.0 and its core modules are copyrighted under The Apache Software License, Version 2.0.

## Authors

The mod\_perl development team and numerous contributors.