diff --git a/reference/pcre/constants.xml b/reference/pcre/constants.xml index 717b333c0..612c0f642 100644 --- a/reference/pcre/constants.xml +++ b/reference/pcre/constants.xml @@ -1,6 +1,6 @@ - + @@ -102,6 +102,11 @@ incluir los subpatrones sin coincidencia en $matches con un valor a &null;. Sin esta constante, los subpatrones sin coincidencia son devueltos con una cadena vacía, como si la coincidencia estuviera vacía. Definir esta constante permite distinguir estos dos casos. + Con preg_match, los subpatrones sin coincidencia + finales son omitidos por completo de $matches a menos + que se utilice esta bandera; a partir de PHP 7.4.0, la bandera los reporta + como &null;, de modo que $matches siempre tenga el + mismo tamaño. 7.2.0 diff --git a/reference/pcre/functions/preg-match.xml b/reference/pcre/functions/preg-match.xml index 73f9f17d9..06124e9f4 100644 --- a/reference/pcre/functions/preg-match.xml +++ b/reference/pcre/functions/preg-match.xml @@ -1,6 +1,6 @@ - + @@ -122,8 +122,12 @@ Array PREG_UNMATCHED_AS_NULL - Si este flag es pasado, los subpatrones no coincidentes son reportados como &null;; - de lo contrario son reportados como una string vacía. + Si este flag es pasado, los subpatrones no coincidentes son reportados + como &null; y son siempre incluidos en los resultados (incluyendo los + finales). Sin este flag, los subpatrones no coincidentes que son + seguidos por un subpatrón coincidente son reportados como una + string vacía, mientras que los subpatrones no + coincidentes finales son omitidos por completo de los resultados. ]]> @@ -158,6 +168,22 @@ array(4) { [3]=> string(1) "c" } +array(2) { + [0]=> + string(1) "a" + [1]=> + string(1) "a" +} +array(4) { + [0]=> + string(1) "a" + [1]=> + string(1) "a" + [2]=> + NULL + [3]=> + NULL +} ]]> @@ -275,6 +301,18 @@ Array + + 7.4.0 + + Cuando se utiliza el flag PREG_UNMATCHED_AS_NULL, + los grupos de captura no coincidentes finales ahora también son + incluidos en el resultado con el valor &null; (o + [null, -1] cuando + PREG_OFFSET_CAPTURE también es utilizado), de modo + que $matches siempre tenga el mismo tamaño. + Anteriormente, eran omitidos. + + 7.2.0