---
name: "HTTP::Headers::ActionPack::LinkHeader"
section: "3pm"
platform: "linux"
package: "libhttp-headers-actionpack-perl"
version: "0.09-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/HTTP::Headers::ActionPack::LinkHeader"
---

# HTTP::Headers::ActionPack::LinkHeader(3pm)

A Link

## NAME

HTTP::Headers::ActionPack::LinkHeader - A Link

## VERSION

version 0.09

## SYNOPSIS

```
  use HTTP::Headers::ActionPack::LinkHeader;
  # build from string
  my $link = HTTP::Headers::ActionPack::LinkHeader->new_from_string(
      '<http://example.com/TheBook/chapter2>;rel="previous";title="previous chapter"'
  );
  # normal constructor
  my $link = HTTP::Headers::ActionPack::LinkHeader->new(
      '<http://example.com/TheBook/chapter2>' => (
          rel   => "previous",
          title => "previous chapter"
      )
  );
  # normal constructor, and <> around link are optional
  my $link = HTTP::Headers::ActionPack::LinkHeader->new(
      'http://example.com/TheBook/chapter2' => (
          rel   => "previous",
          title => "previous chapter"
      )
  );
```

## DESCRIPTION

This is an object which represents an HTTP Link header. It is most often used as a member of a HTTP::Headers::ActionPack::LinkList object.

## METHODS

- "href"

  - "new\_from\_string ( $link\_header\_string )"

  This will take an HTTP header Link string and parse it into and object.

- "as\_string"

  This stringifies the link respecting the parameter order.

  NOTE: This will canonicalize the header such that it will add a space between each semicolon and quotes and unquotes all headers appropriately.

## AUTHOR

Stevan Little \<stevan.little@iinteractive.com\>

## CONTRIBUTORS

- •

  Andrew Nelson \<anelson@cpan.org\>

- •

  Dave Rolsky \<autarch@urth.org\>

- •

  Florian Ragwitz \<rafl@debian.org\>

- •

  Jesse Luehrs \<doy@tozt.net\>

- •

  Karen Etheridge \<ether@cpan.org\>

## COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Infinity Interactive, Inc..

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