STRZAP(3pub)

📦 version 0.40, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ STRZAP(3pub) ✨

okay so bestie, welcome to the strzap page from the C Programmer's Manual 💖 this one's a lil function from publib and she is tiny but she is mighty, fr fr.

🌸 NAME 🌸

strzap — remove pattern from beginning of string, if it is there 🎀

like. if the pattern is there, she zaps it. if it's not there, she does nothing. no drama, no notes. 💅

🦋 SYNOPSIS 🦋

#include <publib.h>
int strzap(char *str, const char *pat);

that's it. that's the whole vibe. one header, one function, two args. iconic. ✨

💜 DESCRIPTION 💜

so here's the tea ☕ strzap compares the beginning of str with all of pat, and if they are the same, it removes the beginning from str.

the way that it literally just looks at the front of your string and checks "hey, is this the pattern?" — and if yes? gone. removed. no cap. the beginning of str gets yeeted and what's left is what comes after the pattern. 🫶

if they're not the same, she simply does not touch anything. main character energy: unbothered, moisturized, in her lane. 🌈

🔥 RETURN VALUE 🔥

  • strzap returns non-zero if it removed anything
  • returns 0 if not

so like, check the return value if you wanna know whether the zap actually happened. it's giving "receipts". 🧚

👑 SEE ALSO 👑

(yes bestie, there's a sibling function that zaps from the end. go look at strendzap(3) if that's your thing. iykyk 😭)

💖 AUTHOR 💖

Lars Wirzenius (lars.wirzenius@helsinki.fi) — thank you for this lil gem, king 👑

⚠️ reminder bestie: strzap modifies str in place when it zaps, so don't be passing in anything you can't/shouldn't change. the manpage doesn't say more than that, so i'm not gonna make stuff up. periodt. 💀

and that's the whole page, fr fr 💜 this was Publib, from the C Programmer's Manual — STRZAP(3pub), mwah, slay, go zap some strings bestie 💅✨🎀

📦 where this page comes from