POE::F...TTPHead(3pm)

✨ NAME ✨

ok so bestie, this is POE::Filter::HTTPHead — it's a Perl filter (a POE::Filter-family one, hence the <pink>...Head(3pm)</pink> situation) whose whole personality is filtering data as HTTP::Response objects. 💅

---

🌸 VERSION 🌸

This is version 0.949, bestie. Write it down. 🎀

---

🦋 SYNOPSYS 🦋

ok so here's the vibe, code and all, no edits:

  $filter = POE::Filter::HTTPHead->new();
  $arrayref_of_response_objects =
    $filter->get($arrayref_of_raw_chunks_from_driver);

  $arrayref_of_leftovers = $filter->get_pending();

look at her. main character energy fr fr. ✨

---

💖 DESCRIPTION 💖

so like, the HTTPHead filter takes stream data that's got the right format and turns it into an HTTP::Response object. that's literally its job. 🫶

and listen — in an all-POE world, this thing would sit on the other end of a connection as POE::Filter::HTTPD. like, they're the two ends of the same yapping session, iykyk. 🌈

🍓 new

creates a new filter to parse HTTP headers. takes no parameters (she needs nothing from you, she's self-sufficient 💅) and returns a shiny new POE::Filter::HTTPHead object. slay.

---

⭐ METHODS ⭐

for the documentation of the public API, go check POE::Filter. that's where the tea is. 🍵

🧚 get_pending

returns unparsed data that's still pending in this filter's input buffer. like, the leftovers she hasn't gotten to yet. 💀

it's used by POE::Wheel objects so they can seamlessly switch between filters. seamless. iconic. no drama. ✨

the details live in the POE::Filter documentation — go read it, bestie, I'm not making stuff up.

---

👑 SEE ALSO

• POE::Filter — the public API docs live here, fr
• POE::Filter::HTTPD — the other end of the connection in an all-POE world 🫶
• HTTP::Response — the object this filter produces

---

ok that's the whole page, no notes. 🎀

this gorgeous little doc ships with version 0.949, and the page itself was generated by perl v5.36.0 on 2022-11-19. she's got history, she's got lore, she's that girl. love her, use her, hydrate, and always read your POE::Filter docs. mwah. 💖🌸✨