strchrnul(3)

💖 NAME 💖

okay so bestie, this is strchrnul — it does a string search for a character or a NUL, no cap ✨

---

📚 LIBRARY 📚

Standard C library (that's libc, link it with -lc) 🫶

---

✨ SYNOPSIS ✨

#define _GNU_SOURCE  /* See feature_test_macros(7) */
#include <string.h>

char *strchrnul(const char *s, int c);

heads up babe, you literally need that _GNU_SOURCE define — it's not optional, she's required 💅

---

🌸 DESCRIPTION 🌸

so strchrnul() is giving strchr(3) energy, right, EXCEPT — plot twist — if c is not found in s, she doesn't return NULL. Nope. She returns a pointer to the null byte at the end of s. iconic behaviour honestly 👑

She's equivalent to both of these expressions, like pick your fave:

strchr(s, c) ?: strnul(s)
s + strcspn(s, (char [2]){c, '\0'})

---

🎀 RETURN VALUE 🎀

she returns a pointer to the matched character, OR — if the character isn't found — a pointer to the null byte at the end of s. that's it, that's the whole vibe 🦋

---

💅 ATTRIBUTES 💅

for the whole explanation of what these terms even mean, go peek at attributes(7) bestie:

• strchrnul() — Thread safety: MT-Safe 🔥

---

👑 STANDARDS 👑

GNU. periodt.

---

🕰️ HISTORY 🕰️

she's been around: glibc 2.1.1, FreeBSD 10, NetBSD 8. a true veteran 💜

---

🌈 SEE ALSO 🌈

string(3), strchr(3), strnul(3), strcspn(3), strspn(3)

---

okay that's the whole page, bestie, you're so welcome 💖 this was Linux man-pages 6.20, dated 2026-02-25, and yes she ate, no crumbs left 🎀✨🦋