EC_STR_WRAP(3)

✨ NAME ✨

okay so bestie, welcome to the Libecoli Programmer's Manual page for ec_str_wrap 💖 — she wraps a text to a maximum number of columns. that's it. that's the job. and she eats every single time 💅

---

🌸 SYNOPSIS 🌸

first you gotta invite her in:

#include <ecoli/string.h>

then the whole summoning ritual, exactly like this, no cap:

char * ec_str_wrap(
    const char   *str,        /* The input text. */
    size_t        max_cols,   /* The maximum number of columns. */
    /*
     * The number of already consumed columns on the first line, filled with
     * padding in other lines.
     */
    size_t        start_off
);

let's break the girlies down 🎀:

• str — the input text, literally just the words you're handing over.
• max_cols — the max number of columns. she will not go past it, periodt.
• start_off — the number of already consumed columns on the first line, and it gets filled with padding in the other lines. lowkey important, don't skip her 🙈

---

🦋 RETURN VALUE 🦋

she hands you back an allocated string holding the wrapped text 🫶. and listen — it must be freed by the user using free(). like, you free it. not her. that's your job now. it's giving main character responsibility ✨

---

🌈 SEE ALSO 🌈

the whole friend group, go say hi 👑:

• ec_str_parse_llint(3)
• ec_str_startswith(3)
• ec_str_is_space(3)
• ec_strcmp_count(3)
• ec_str_parse_ullint(3)
• ec_str_quote(3)

---

💜 COPYRIGHT 💜

Copyright (C) 2010-2026 Olivier Matz, Robin Jarry.

---

and that's the whole page, bestie, you absolutely ate that 🍓💅

libecoli 🌟 2026-06-11 🌟 mwah, go free your strings 💖