DC_DEVICE_FOREACH(3)

🌸 NAME 🌸

okay bestie, this is the DC_DEVICE_FOREACH(3) page from the Library Functions Manual 💅 and the name is literally: dc_device_foreach — iterate over dives in a dive computer. That’s the whole vibe: dive computer goes brrr, we walk through the dives ✨

🫶 LIBRARY 🫶

the library is “libdivecomputer” 💖

✨ SYNOPSIS ✨

       #include <libdivecomputer/device.h>

       typedef int
       (*dc_dive_callback_t)(const unsigned char *data, unsigned int size,
           const unsigned char *fingerprint, unsigned int fsize,
           void *userdata);

       dc_status_t
       dc_device_foreach(dc_device_t *device, dc_dive_callback_t callback,
           void *userdata);

💖 DESCRIPTION 💖

okay so iterate over all dives on device by calling callback with userdata. That’s the main character move 💅

Every single dive invokes callback with the dive data — which should be parsed with dc_parser_new(3) — and the binary fingerprint of the dive. no cap, both things show up 🫶

The fingerprint is lowkey iconic for this: you can use it to record the newest dive, and then on subsequent invocations stop processing when the same dive fingerprint is encountered. iykyk ✨

Your callback function must return non-zero to continue downloading dives, or zero to stop. That’s the rule, bestie 🎀

🔥 RETURN VALUES 🔥

This returns DC_STATUS_SUCCESS on success or one of several error values on error. If callback returns zero, this will not be reflected in the return value (usually DC_STATUS_SUCCESS). fr fr 💀

🦋 SEE ALSO 🦋

dc_parser_new(3)

👑 AUTHORS 👑

The library “libdivecomputer” library was written by Jef Driesen, jef@libdivecomputer.org. The manpages were written by Kristaps Dzonsons, kristaps@bsd.lv. iconic behavior, honestly 🌈

okay that’s the whole page! 💖 this one comes from Debian, dated January 5, 2017, and it’s DC_DEVICE_FOREACH(3) — slay, go read some dives bestie 🫶