Função PHP preg_match()

Autor：Eve Cole Data da Última Atualização：2024-12-28 15:48:01

A função preg_last_error é usada para realizar uma correspondência de expressão regular.

gramática

 int preg_match (string $padrão, string $subject [, array &$matches [, int $flags = 0 [, int $offset = 0 ]]] )

Pesquisa no assunto uma correspondência da expressão regular dada pelo padrão.

Descrição do parâmetro:

$pattern: O padrão a ser pesquisado, em formato de string.

$assunto: string de entrada.

$matches: Se o parâmetro matches for fornecido, ele será preenchido com os resultados da pesquisa. $matches[0] conterá o texto correspondido pelo padrão completo, $matches[1] conterá o texto correspondido pelo primeiro subgrupo de captura e assim por diante.

$flags: flags podem ser definidos com os seguintes valores de flag:

PREG_OFFSET_CAPTURE: Se este sinalizador for passado, o deslocamento da string (em relação à string de destino) será anexado ao retorno para cada ocorrência de uma correspondência. Nota: Isso alterará a matriz preenchida no parâmetro matches para que cada elemento se torne uma string onde o 0º elemento é a string correspondente e o primeiro elemento é o deslocamento da string correspondente na string de destino subject .

offset: Normalmente, a pesquisa começa no início da string de destino. O parâmetro opcional offset é usado para especificar o início da pesquisa a partir de um ponto desconhecido na string de destino (a unidade é bytes).

valor de retorno

Retorna o número de correspondências do padrão. Seu valor será 0 (sem correspondência) ou 1 porque preg_match() irá parar de pesquisar após a primeira correspondência. preg_match_all() difere disso porque procura o assunto até chegar ao final. Se ocorrer um erro, preg_match() retorna FALSE.

Exemplo

Encontre a string de texto "php":

<?php // A marca "i" após o separador de padrões é uma pesquisa que não diferencia maiúsculas de minúsculas se ( preg_match ( " /php/i " , " PHP é a linguagem de script web preferida. " ) ) { eco " A string correspondente php foi encontrada. " ; outro { eco " Nenhuma string correspondente encontrada no php. " } ; ?>

O resultado da execução é o seguinte:

 Encontre a string correspondente php.

Encontre a palavra "palavra"

<?php /* O b no padrão marca um limite de palavra, portanto apenas a palavra independente "web" será correspondida, e não * parte da palavra como "webbing" ou "cobweb" */ se ( preg_match ( " /bwebb/i " , " PHP é a linguagem de script da web preferida. " ) ) { eco " Encontre a string correspondente. n " } outro { eco " Nenhuma string correspondente encontrada. n " } se ( preg_match ( " /bwebb/i " , " PHP é a linguagem de script de site preferida. " ) ) { eco " Encontre a string correspondente. n " } outro { eco " Nenhuma string correspondente encontrada. n " } ?>

O resultado da execução é o seguinte:

 String correspondente encontrada. Nenhuma string correspondente encontrada.

Obtenha o nome de domínio no URL

<?php // Obtém o nome do host da URL preg_match ( ' @^(?:http://) ? ([ ^ /]+)@i ' , " http://www.codercto.com/index.html " , $ matches ) ; [ 1 ] ; // Obtém as duas últimas partes do nome do host preg_match ( ' /[^.]+.[^.]+$/ ' , $host , $ matches ) ; " nome de domínio é: {$matches[0]} n " ? >

O resultado da execução é o seguinte:

 nome de domínio é: codercto.com

Use subgrupos nomeados

<?php $str = ' foobar: 2008 ' ; preg_match ( ' /(?P<name>w+) : (?P<digit>d+)/ ' , $str , $ matches ) ; 5.2.2 (pcre 7.0) ou posterior, no entanto, para compatibilidade com versões anteriores, o método acima é o método de gravação recomendado */ . // preg_match('/(?<nome>w+): (?<dígito>d+)/', $str, $matches); print_r ( $ correspondências ) ;

O resultado da execução é o seguinte:

 Array( [0] => foobar: 2008 [nome] => foobar [1] => foobar [dígito] => 2008 [2] => 2008)