gd_framenum_subset64(3)

💖 gd_framenum_subset64 💖

okay bestie, so gd_framenum_subset64 is a manual page from GETDATA, and it's all about doing a reverse look-up on a monotonic Dirfile field, but with largefile support. yes she's fancy. 💅

✨ NAME ✨

gd_framenum_subset64 — perform a reverse look-up on a monotonic Dirfile field, with largefile support.

🌸 SYNOPSIS 🌸

#define GD_64BIT_API
#include <getdata.h>

double gd_framenum_subset64(DIRFILE *dirfile, const char *field_code,
       double value, gd_off64_t field_start, gd_off64_t field_end);

like, copy that exactly, don't freestyle it 🫶

🦋 DESCRIPTION 🦋

so this version of gd_framenum_subset(3) uses a 64-bit offset type (gd_off64_t) — wherever one is actually available — and it does that regardless of the size of off_t. the way it just does not care about off_t's whole situation. iconic honestly. 👑

lowkey important: it's only guaranteed to be available if GD_64BIT_API is defined before including getdata.h. so define it first, bestie, or don't come crying to me 😭

and here's the vibe: if off_t is a 64-bit type, then this function will be the same as gd_framenum_subset(3). otherwise, gd_framenum_subset(3) will be a version of this function which uses a 32-bit off_t. it's giving "same function, different era" ✨

🌈 SEE ALSO 🌈

• gd_framenum_subset(3)
• feature_test_macros(7)

Version 0.10.0 🌸 25 December 2016 — that's the source and the date, and that's the whole page, bestie. go do a reverse look-up, you got this. mwah 💋🫶🎀