BREAKLINE(3)

🌸 BREAKLINE(3) — Schily´s LIBRARY FUNCTIONS 🌸

okay bestie, welcome to the breakline page 💅 this one lives in Schily´s LIBRARY FUNCTIONS and it's honestly such a vibe once you get it.

---

✨ NAME ✨

breakline() — breaks a buffer into fields 🎀

---

🦋 SYNOPSIS 🦋

int breakline(buf, delim, array, max)
char *buf;
char delim;
char *array[];
int max;

---

💖 DESCRIPTION 💖

so here's the tea ☕: breakline() takes the buffer buf and chops it into fields, with the character delim doing the dividing ✂️ and while it's at it, it replaces every occurrence of delim inside buf with the NULL character ('\0') — lowkey destructive but in a cute way 🫶.

Then it fills in array with pointers to the beginning of each field in the buffer. max says how many entries you get to fill in that array, no more, no cap 🧢.

and if buf doesn't have enough fields to go around? the extra entries in array just point to an empty string. everyone gets a seat bestie, even the empties 💀✨

---

👑 RETURNS 👑

returns the number of fields actually in the buffer — but never more than max, obviously. periodt 🌈

---

🍓 EXAMPLES 🍓

okay icon, say you've got this:

char *buf = "a:bc:d:efg";
char *array[10];

breakline(buf, ':', array, 10);

now the : are replaced by '\0' and boom 💥:

array[0] = "a";
array[1] = "bc";
array[2] = "d"
array[3] = "efg";
array[4] ... array[9] = "";

look at that. iconic behaviour honestly 🧚💜

---

🎀 SEE ALSO 🎀

• findline(3)

---

bestie reminder: this page is from Schily´s LIBRARY FUNCTIONS, written by Joerg Schilling, dated 2022/09/09 — go off and break some lines responsibly 💖 slay ✨🦋