CKTIS / PHP
preg_match()
Busca la primera coincidencia.
Versión: PHP 8.4; repository runtime, production runtime not attested
Sintaxis
preg_match(string $pattern, string $subject, array &$matches = null, int $flags = 0, int $offset = 0): int|falseBusca la primera coincidencia. Devuelve 1 si la encuentra, 0 si no existe y false si falla la compilación o ejecución. El índice cero contiene toda la coincidencia. PREG_OFFSET_CAPTURE añade la posición en bytes incluso en UTF-8. El parámetro $offset también cuenta bytes. Con el modificador u una posición dentro de un carácter UTF-8 da false y PREG_BAD_UTF8_OFFSET_ERROR.
Firma
preg_match(string $pattern, string $subject, array &$matches = null, int $flags = 0, int $offset = 0): int|false
Salida del ejemplo
[1,[["A42",3],["42",4]],0]
[false,true]
Ejemplos
<?php
$input="é A42"; $found=preg_match("~A(\\d+)~u",$input,$m,PREG_OFFSET_CAPTURE);
echo json_encode([$found,$m,preg_match("~Z~",$input)]);
$bad=preg_match("~.~u","é",$matches,0,1); echo "\n",json_encode([$bad,preg_last_error()===PREG_BAD_UTF8_OFFSET_ERROR]);
Resultado
[1,[["A42",3],["42",4]],0] [false,true]