pos - find or set the offset for the last/next m//g search


NAME

pos - find or set the offset for the last/next m//g search


SYNOPSIS

pos SCALAR

pos


DESCRIPTION

Returns the offset of where the last m//g search left off for the variable in question ($_ is used when the variable is not specified). Note that 0 is a valid match offset. undef indicates that the search position is reset (usually due to match failure, but can also be because no match has yet been performed on the scalar). pos directly accesses the location used by the regexp engine to store the offset, so assigning to pos will change that offset, and so will also influence the \G zero-width assertion in regular expressions. Because a failed m//gc match doesn't reset the offset, the return from pos won't change either in this case. See the perlre manpage and the perlop manpage.

 pos - find or set the offset for the last/next m//g search