---
name: "nutscan_ip_ranges_iter_inc"
section: "3"
platform: "linux"
package: "nut"
version: "2.8.5-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/nutscan_ip_ranges_iter_inc"
---

# nutscan\_ip\_ranges\_iter\_inc(3)

Proceed with iteration of an IP address range using a \`nutscan\_ip\_range\_list\_iter\_t\` structure.

## 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)](/nutscan_ip_ranges_iter_init/3.md) 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_init_ip_ranges/3.md), [**nutscan\_free\_ip\_ranges**(3)](/nutscan_free_ip_ranges/3.md), [**nutscan\_cidr\_to\_ip**(3)](/nutscan_cidr_to_ip/3.md), [**nutscan\_ip\_ranges\_iter\_init**(3)](/nutscan_ip_ranges_iter_init/3.md)