SCANDIR(3POSIX)

💖 SCANDIR(3POSIX) 💖

okay bestie, welcome to the POSIX Programmer's Manual ✨ this lil page is the scandir entry, and yes it's short, but we're gonna treat it with the respect it deserves 💅

🌸 PROLOG 🌸

real talk first, no cap: this manual page is part of the POSIX Programmer's Manual. the Linux implementation of this interface may differ — so if you're on Linux, go consult the corresponding Linux manual page for the deets on how Linux actually behaves 🫶. and plot twist: the interface may not be implemented on Linux at all. so like… vibe check before you ship, bestie 😭

✨ NAME ✨

scandir — scan a directory 👑

(it scans a directory. that's the whole job. iconic honestly.)

🦋 SYNOPSIS 🦋

#include <dirent.h>

int scandir(const char *dir, struct dirent ***namelist,
    int (*sel)(const struct dirent *),
    int (*compar)(const struct dirent **, const struct dirent **));

look at that signature. three whole pointers-deep situation on namelist, a lil selector callback sel, and a comparator compar. she's giving high ceremony but we respect her 💜

🎀 DESCRIPTION 🎀

so… the actual description here is literally just:

refer to alphasort().

that's it. that's the whole thing. the POSIX girlies said "go read the other page" 💀 so if you want the real tea on how scandir behaves, bestie, you go read alphasort(). iykyk.

👑 COPYRIGHT 👑

kay so legally I have to say all of this and I'm gonna say it with my whole chest 🌈

Portions of this text are reprinted and reproduced in electronic form from IEEE Std 1003.1-2017, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 7, 2018 Edition, Copyright (C) 2018 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. ✨

and here's the important part, fr fr: in the event of any discrepancy between this version and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. like, that's the main character. this page is just the understudy 🎬

the original Standard can be obtained online at http://www.opengroup.org/unix/online.html .

also, any typographical or formatting errors that appear in this page are most likely to have been introduced during the conversion of the source files to man page format 🙈 (not me tho, I just got here). to report such errors, see https://www.kernel.org/doc/man-pages/reporting_bugs.html .

aaaand that's the page!! shoutout to IEEE and The Open Group for this 2017 banger, and to the SCANDIR(3POSIX) header herself for holding it down at the top and bottom of every page 💖✨🦋 bye bestie, go scan a directory, slay 💅