fstrcolli(3)

💖 fstrcolli(3) 💖

okay bestie, this one lives in the Library Functions Manual, section 3 (that's the "C library functions" shelf, iykyk) ✨

---

🌸 NAME 🌸

fstrcolli — fuzzy comparison of two strings using the current locale

---

✨ SYNOPSIS ✨

#include <fstrcmp.h>
#define FSTRCMP_IDENTICAL
#define FSTRCMP_THRESHOLD
#define FSTRCMP_ERROR
int fstrcolli(const char *string1, const char *string2);

---

🦋 DESCRIPTION 🦋

so the strcolli() function compares the two strings string1 and string2. (the manpage literally spells it sting1, no shade, typo era, it means string1 🫶)

the comparison is based on strings interpreted as appropriate for the program's current locale, for category LC_CTYPE. so like, locale girlies, this one's for you 💅

---

🎀 RETURN VALUE 🎀

fstrcolli hands back an int value between 0 and FSTRCMPI_IDENTICAL. here's the vibe check on what those numbers mean:

• 0 — the strings are utterly unalike. not a single crumb in common. 💀
• FSTRCMPI_IDENTICAL — the strings are identical. periodt, twins, matching outfits 👯
• more than FSTRCMPI_THRESHOLD (which lies between 0 and FSTRCMPI_IDENTICAL) — most people would consider that "similar" 🌈 like, not the same girl but definitely cousins
• FSTRCMPI_ERROR (always negative) — this one means a malloc(3) or mbstowcs(3) failure happened. red flag, abort mission, the allocation did not slay 😭

heads up: the #defines up in the synopsis are spelled FSTRCMP_IDENTICAL, FSTRCMP_THRESHOLD and FSTRCMP_ERROR, while the return value section talks about FSTRCMPI_IDENTICAL, FSTRCMPI_THRESHOLD and FSTRCMPI_ERROR. that's just how the page is written, bestie — I'm not touching it, not my job, I just report the lore 📋

---

🔥 SEE ALSO 🔥

• fstrcmpi(3) — fuzzy comparison of two strings
• fstrcoll(3) — fuzzy comparison of two strings using the current locale
• strcoll(3) — compare two strings using the current locale
• mbstowcs(3) — convert a multibyte string to a wide-character string

---

👑 COPYRIGHT 👑

• fstrcmp version 0.7
• Copyright (C) 2009 Peter Miller
• Peter Miller <pmiller@opensource.org.au>

the comparison code is derived from the fuzzy comparison functions in GNU Gettext 0.17. and those GNU Gettext comparison functions were, in turn, derived from GNU Diff 2.7.

• Copyright (C) 1988-2009 Free Software Foundation

---

okay that's the whole page, we ate and left no crumbs 🍓💅 this was fstrcolli(3) from fstrcmp version 0.7, copyright vibes going all the way back to 2009 (and the Free Software Foundation holding it down since 1988) — stay fuzzy, stay slay, bye bestie 🧚💜