NAME

dc_irda_iterator_new — Create an iterator to enumerate the IrDA devices.

LIBRARY

library “libdivecomputer”

SYNOPSIS

#include <libdivecomputer/irda.h>

dc_status_t
dc_irda_iterator_new(dc_iterator_t **iterator, dc_context_t *context, dc_descriptor_t *descriptor);

DESCRIPTION

Iterates through the available IrDA devices which matches the given descriptor. Accepts a context opened with dc_context_new(3) and a descriptor usually found by searching through dc_descriptor_iterator(3).

On returning DC_STATUS_SUCCESS the iterator will be set to an dc_iterator_t which can be used to iterate the available IrDA devices using dc_iterator_next(3).

The value type of the iterator is of type dc_irda_device_t. This value can be used in functions to extract information about this specific IrDA device, namely dc_irda_device_get_name(3) and dc_irda_device_get_address(3). When done the IrDA device needs to be freed with dc_irda_device_free(3).

After iterating the iterator needs to be freed using dc_iterator_free(3).

RETURN VALUES

Returns DC_STATUS_SUCCESS on success, or another dc_status_t code on failure.

On DC_STATUS_SUCCESS the returned iterator needs to be freed when done using dc_iterator_free(3).

AUTHORS

The library “libdivecomputer” library was written by Jef Driesen, jef@libdivecomputer.org.
This manpage is written by
Vincent Hagen, vinnie@script4web.nl.