NE_GET_STATUS(3)

📦
version 0.37.1 · 8 versions
, in arch rolling

💅 NE_GET_STATUS(3) — neon API reference, bestie ✨

Okay so welcome to NE_GET_STATUS(3), the neon API reference page that’s literally here to help you retrieve HTTP response properties. Pull up a chair, bestie, we’re getting into it. 🎀

✨ NAME ✨

ne_get_status, ne_get_response_location, ne_get_response_retry_after — retrieve HTTP response properties. That’s the whole assignment, and it ate. 💅

🌸 SYNOPSIS 🌸

#include <ne_request.h>

const ne_status *ne_get_status(const ne_request *request);

ne_uri *ne_get_response_location(ne_request *request);

time_t ne_get_response_retry_after(ne_request *request);

💖 DESCRIPTION 💖

Okay so ne_get_status returns a pointer to the HTTP status object that gives the result of a request. Lowkey important: the object returned only becomes valid once the request has been successfully dispatched — and by “successfully” we mean the return value of ne_request_dispatch or ne_begin_request was zero. Periodt. ✨

If the response includes a Location header, ne_get_response_location parses and resolves the URI-reference relative to the request target. If a fragment ("#fragment") is applicable to the request target, it can be passed as an argument to allow appropriate relative resolution. Cute, right? 💅

ne_get_response_retry_after parses any Retry-After header included in the response. If the header value uses a relative time, it is interpreted relative to the time the function was invoked, rather than the time the response was received — so the function should be used directly after dispatching the request. Not me warning you about timing, but yes, timing matters bestie. 😭

🫶 RETURN VALUE 🫶

  • ne_get_status — returns a pointer to the HTTP status object giving the result of a request. This pointer is valid until the associated request object is destroyed. Slay, but don’t hold it past its lifespan. 💀
  • ne_get_response_location — returns a malloc-allocated ne_uri object, or NULL if either the URI in the Location header could not be parsed or the Location header was not present. 🦋
  • ne_get_response_retry_after — returns a time_t value, or zero if either no Retry-After header was included or the header value could not be parsed. 🔥

🌈 EXAMPLES 🌈

Display the response status code of applying the HEAD method to some resource. Main character example incoming: 💖

ne_request *req = ne_request_create(sess, "HEAD", "/foo/bar");
if (ne_request_dispatch(req))
   /* handle errors... */
else
   printf("Response status code was %d\n", ne_get_status(req)->code);
ne_request_destroy(req);

⭐ HISTORY ⭐

ne_get_response_location is available in neon 0.34.0 and later. Not ancient, but iconic. 👑

👀 SEE ALSO 👀

Copyright © 2001-2026 Joe Orton

Signed off with love: source/version neon, date 03/20/2026 — mwah 💋🎀

📦 where this page comes from