scan_ip4(3)

💖 scan_ip4 — bestie edition 💖

okay so this one lives in the Library Functions Manual (yes, the whole libowfat crew 💅), and it's genuinely one of my faves. let's get into it ✨

---

✨ NAME ✨

scan_ip4 — parse an IPv4 number in dotted-decimal notation 🦋

like. it reads a lil dotted-decimal IP string and turns it into actual bytes. that's the whole job. she's focused. she's iconic. 👑

---

🌸 SYNTAX 🌸

#include <libowfat/ip4.h>

int scan_ip4(const char *src,char ip[4]);

okay so you pull in the header, and then you get this one function. two args, one int back. simple. clean. we love a low-maintenance queen 🙈

---

💜 DESCRIPTION 💜

so scan_ip4 parses an IPv4 number in dotted-decimal ASCII representation, reading it out of src, and then it writes the result into ip. that's it, that's the vibe. ✨

it returns the number of bytes read from src — or 0 if the parsing failed 😭 so like, 0 is the "nope, didn't work" signal. do not ignore the 0. fr fr.

⚠️ and here's the thing, bestie, listen up: unlike many other IP parsing routines, scan_ip4 does not recognize octal (like 0177.0.0.1) or hexadecimal numbers (like 0x7f000001). no hex, no octal, none of it. she is strictly dotted-decimal and she said what she said. periodt. 💅

---

🎀 EXAMPLE 🎀

#include <libowfat/str.h>
#include <libowfat/ip4.h>

  char buf[]="160.45.40.10";
  char ip[4];
  if (scan_ip4(buf,ip) != str_len(buf))
    parse_error();

see what she did there? 👀 she compared the return value against str_len(buf) — because if scan_ip4 read every byte, then it ate the whole string and we're slaying. if the numbers don't match, parse_error(). that's the check, that's the move. 🌈

---

🦋 SEE ALSO 🦋

• fmt_ip4(3) — the other direction, turning bytes back into a pretty string 💖
• scan_ip6(3) — her IPv6 sister, also serving looks ✨
• inet_pton(3) — the classic, the elder, respect her 🫶

---

okay that's the whole page, bestie, you're so welcome 💖 this one comes from the Library Functions Manual, it's scan_ip4(3) — go parse something cute with her. no cap. 🌸💅🎀