---
name: "Furl::Headers"
section: "3pm"
platform: "linux"
package: "libfurl-perl"
version: "3.14-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Furl::Headers"
---

# Furl::Headers(3pm)

HTTP Headers object

## NAME

Furl::Headers - HTTP Headers object

## SYNOPSIS

## CONSTRUCTOR

- my $headers = Furl::Headers-\>new(\\%headers);

  The constructor takes one argument. It is a hashref. Every key of hashref must be lower-cased.

  The format of the argument is like following:

  ```
      +{
          'content-length' => [30],
          'set-cookies'    => ['auth_token=; path=/; expires=Thu, 01 Jan 1970 00:00:00 GMT', '_twitter_sess=JKLJBNBLKSFJBLKSJBLKSJLKJFLSDJFjkDKFUFIOSDUFSDVjOTUzNzUwNTE2%250AZWFiMWRiNDZhMDcwOWEwMWQ5IgpmbGFzaElDOidBY3Rpb25Db250cm9sbGVy%250AOjpGbGFzaDo6Rmxhc2hIYXNoewAGOgpAdXNlZHsA--d9ce07496a22525bc178jlkhafklsdjflajfl411; domain=.twitter.com; path=/'],
      }
  ```

## INSTANCE METHODS

- my @values = $headers-\>header($key);

  Get the header value in array.

- my $values\_joined = $headers-\>header($key);

  Get the header value in scalar. This is not a first value of header. This is same as:

  ```
      my $values = join(", ", $headers->header($key))
  ```

- $headers-\>header($key, $val);

  - $headers-\>header($key, \\@val);

  Set the new value of headers.

- $headers-\>remove\_header($key);

  Delete key from headers.

- my @h = $headers-\>**flatten()**;

  Gets pairs of keys and values.

- my @keys = $headers-\>**keys()**;

  - my @keys = $headers-\>**header\_field\_names()**;

  Returns keys of headers in array. The return value do not contains duplicated value.

- my $str = $headers-\>**as\_string()**;

  Return the header fields as a formatted MIME header.

- my $val = $headers-\>**referer()**

  - my $val = $headers-\>**expires()**

  - my $val = $headers-\>**last\_modified()**

  - my $val = $headers-\>**if\_modified\_since()**

  - my $val = $headers-\>**content\_type()**

  - my $val = $headers-\>**content\_length()**

  - my $val = $headers-\>**content\_encoding()**

  These methods are shortcut for popular headers.

- $headers-\>**clone()**;

  Returns a copy of this "Furl::Headers" object.

## SEE ALSO

HTTP::Headers