DC_DESCRIPTOR_ITERATOR(3)

🌸 NAME 🌸

okay bestie, welcome to the Library Functions Manual page for DC_DESCRIPTOR_ITERATOR(3) 💖. This is all about dc_descriptor_iterator_new — get all supported dive computers ✨.

💖 LIBRARY 💖

library “libdivecomputer” 🫶 — that’s the whole vibe.

✨ SYNOPSIS ✨

       #include <libdivecomputer/descriptor.h>

       dc_status_t
       dc_descriptor_iterator_new(dc_iterator_t **iterator,
           dc_descriptor_t *descriptor);

🦋 DESCRIPTION 🦋

So dc_descriptor_iterator_new gets all the descriptors available to library “libdivecomputer”. No cap, that’s the whole job 💅.

If the return value is DC_STATUS_SUCCESS, it must be matched with dc_iterator_free(3) — periodt. Then the dc_iterator_next(3) function must be used to iterate over the iterator. And bestie, you must use dc_descriptor_free(3) on the returned descriptor value. Cleanup is main character energy, okay? 🎀

🎀 RETURN VALUES 🎀

On success this returns DC_STATUS_SUCCESS and fills in the iterator pointer. That’s the tea ☕✨.

🔥 EXAMPLES 🔥

This code iterates over all descriptors, prints the vendor, then frees the iterator. It does no error checking — literally none, bestie 🙈.

       dc_descriptor_iterator_new(&iter, context));
       while (dc_iterator_next(iter, &desc) == DC_STATUS_SUCCESS) {
               printf("%s\n", dc_descriptor_get_vendor(desc));
               dc_descriptor_free(desc);
       }
       dc_iterator_free(iter);

👑 SEE ALSO 👑

• dc_descriptor_free(3)
• dc_iterator_free(3)
• dc_iterator_next(3)

💜 AUTHORS 💜

The library “libdivecomputer” library was written by Jef Driesen, jef@libdivecomputer.org. The manpages were written by Kristaps Dzonsons, kristaps@bsd.lv. Absolute icons 👑✨.

xoxo, your Debian bestie 💅 — this page is dated January 5, 2017, and the footer title is DC_DESCRIPTOR_ITERATOR(3) 🌈.