NUTSCAN_IP_RANGES_IT(3)           NUT Manual           NUTSCAN_IP_RANGES_IT(3)

NAME
       nutscan_ip_ranges_iter_inc - Proceed with iteration of an IP address
       range using a `nutscan_ip_range_list_iter_t` structure.

SYNOPSIS
               #include <nut-scan.h>

               char * nutscan_ip_ranges_iter_inc(nutscan_ip_range_list_iter_t *irliter);

DESCRIPTION
       The nutscan_ip_ranges_iter_inc() function can walk an iterator from the
       specified nutscan_ip_range_list_iter_t helper object, prepared by
       nutscan_ip_ranges_iter_init(3) from a nutscan_ip_range_list_t
       structure.

       This function skips work if:

       o   the structure pointer is NULL (NULL is returned);

       o   the structure pointer's ip_range list is NULL (NULL is returned),

       o   the structure pointer's ip_range_iter pointer is NULL (NULL is
           returned).

       Returns the next IP address from the currently iterated registered IP
       address range, or switches iteration to the next range if no addresses
       remained in the current one. The caller SHOULD NOT free this string
       while iterating.

NOTES
       Technically, the function is currently defined in nutscan-ip.h file.

SEE ALSO
       nutscan_init_ip_ranges(3), nutscan_free_ip_ranges(3),
       nutscan_cidr_to_ip(3), nutscan_ip_ranges_iter_init(3)

Network UPS Tools 2.8.3           05/29/2025           NUTSCAN_IP_RANGES_IT(3)