---
name: "ne_response_header_iterate"
section: "3"
platform: "linux"
package: "libneon27-dev"
version: "0.34.2-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/ne_get_response_header"
---

# ne\_response\_header\_iterate(3)

functions to access response headers

Part of [ne\_get\_response\_header(3)](/ne_get_response_header/3.md).

## NAME

ne\_get\_response\_header, ne\_response\_header\_iterate - functions to access response headers

## SYNOPSIS

```
#include <ne_request.h>
```

**const char \*ne\_get\_response\_header(ne\_request \****request***, const char \****name***);**

**void \*ne\_response\_header\_iterate(ne\_request \****request***, void \****cursor***, const char \*\****name***, const char \*\****value***);**

## DESCRIPTION

To retrieve the value of a response header field, the **ne\_get\_response\_header** function can be used, and is given the name of the header to return.

To iterate over all the response headers returned, the **ne\_response\_header\_iterate** function can be used. This function takes a *cursor* parameter which should be NULL to retrieve the first header. The function stores the name and value of the next header header in the *name* and *value* parameters, and returns a new cursor pointer which can be passed to **ne\_response\_header\_iterate** to retrieve the next header.

## RETURN VALUE

**ne\_get\_response\_header** returns a string, or NULL if no header with that name was given. If used during request processing, the return value pointer is valid only until the next call to **ne\_begin\_request**, or else, until the request object is destroyed.

Likewise, the cursor, names, and values returned by **ne\_response\_header\_iterate** are only valid until the next call to **ne\_begin\_request** or until the request object is destroyed.

## EXAMPLES

The following code will output the value of the Last-Modified header for a resource:

```
ne_request *req = ne_request_create(sess, "GET", "/foo.txt");
if (ne_request_dispatch(req) == NE_OK) {
    const char *mtime = ne_get_response_header(req, "Last-Modified");
    if (mtime) {
        printf("/foo.txt has last-modified value %s\n", mtime);
    }
}
ne_request_destroy(req);
```

## SEE ALSO

ne\_request\_create, ne\_request\_destroy.

## COPYRIGHT

Copyright © 2001-2024 Joe Orton\