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

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