---
name: each
status: documented
runtime: pp
source: src/runtime/pp/aggregate.rs
---
```{index} single: each; Perl built-in (pp runtime)
```

# each

## Synopsis

```perl
while (my ($k, $v) = each %hash) { ... }
while (my $k = each %hash) { ... }    # scalar context: key only
```

## Description

Returns the next key-value pair from a hash's internal iterator.

Advances the hash's internal iterator and returns the next entry.
In list context, pushes a `(key, value)` pair. In scalar context,
returns only the key. When the iterator is exhausted, returns an
empty list (list context) or `undef` (scalar context), and the
iterator resets automatically for the next traversal.

Note: `keys` and `values` reset the same internal iterator, so
calling them during an `each` loop will restart iteration.

## See also

keys, values, exists, delete