iter

headers:iter(OPTIONAL_NAME)

Since: Version 2025.10.06-5ec871ab

The functionality described in this section requires version 2025.10.06-5ec871ab of KumoMTA, or a more recent version.

Produces an iterator over the headers. If OPTIONAL_NAME is omitted, all headers are iterated in the order in which they appear in the message. If OPTIONAL_NAME is specified, then all headers that equal the name, case insensitively, will be iterated in the order in which they appear in the message.

Iterating all headers

for hdr in headers:iter() do
  print('got header', hdr.name)
end

Iterating just the authentication results headers

for hdr in headers:iter 'Authentication-Results' do
  print('got auth result', hdr.name, hdr.value)
end