NAME

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

SYNOPSIS

Note
Two NUT websites

This version of the page reflects NUT release v2.8.3 with codebase commited c0acf09af at 2025-04-21T23:59:59+00:00

Options, features and capabilities in current development (and future releases) are detailed on the main site and may differ from ones described here.

 
        #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:

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

  • the structure pointer’s ip_range list is NULL (NULL is returned),

  • 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)