sock_dataready(3z)

💖 sock_dataready(3z) 💖

okay bestie, pull up a chair, because we're talking about sock_dataready(3z) — a lil function from the z88dk Programmer's Manual that answers the most iconic question in all of networking: "is there mail for me??" 📬✨

---

✨ NAME ✨

sock_dataready — test whether a network connection has incoming data 🦋

---

✨ SYNOPSIS ✨

#include <net/socket.h>

size_t sock_dataready(SOCKET *s);

---

✨ DESCRIPTION ✨

So the parameter s is a descriptor to an open socket — and not just any socket, a socket you made with sock_open(3z) or sock_listen(3z). 💅 like, it has to already exist, bestie, we're not manifesting sockets out of thin air.

The sock_dataready() function tests whether a socket has data waiting to be read by the user program. that's it. that's the whole job. it's giving receptionist checking if you have a package 📦 — it does not hand you the package, it just tells you one is there. so lowkey essential before you go reading, no cap.

---

✨ RETURN VALUE ✨

sock_dataready() returns the amount of data waiting in the input queue. 🔥 so like, a number. the actual size of the pile of goodies sitting in the queue. zero means nothing's there, so don't go reading and act surprised, okay? 😭

---

✨ SEE ALSO ✨

• sock_read(3z) — the one that actually takes the data, iykyk 🫶

---

✨ AUTHOR ✨

Dominic Morris <dom@jb.man.ac.uk> — the icon, the legend, the moment 👑

---

mwah 💋 that's the whole page! z88dk Programmer's Manual, dated 18 February 2000 — yeah bestie, this one is vintage vintage, a true Y2K relic 🎀✨ go forth and check your sockets before you read from them, periodt 💅