You are viewing the version of this documentation from Perl 5.36.2. View the latest version
@{^CAPTURE}

An array which exposes the contents of the capture buffers, if any, of the last successful pattern match, not counting patterns matched in nested blocks that have been exited already.

Note that the 0 index of @{^CAPTURE} is equivalent to $1, the 1 index is equivalent to $2, etc.

if ("foal"=~/(.)(.)(.)(.)/) {
    print join "-", @{^CAPTURE};
}

should output "f-o-a-l".

See also "$<digits> ($1, $2, ...)", "%{^CAPTURE}" and "%{^CAPTURE_ALL}".

Note that unlike most other regex magic variables there is no single letter equivalent to @{^CAPTURE}. Also be aware that when interpolating subscripts of this array you must use the demarcated variable form, for instance

print "${^CAPTURE[0]}"

see "Demarcated variable names using braces" in perldata for more information on this form and its uses.

This variable was added in 5.25.7