Download regex - download do código-fonte regex

regex

Outras categorias

3.1.1

Baixar

Tornando o regex ótimo novamente

As funções preg_* integradas do PHP requerem alguns padrões estranhos, como passar variáveis por referência e tratar valores false ou null como erros. spatie/regex fornece uma interface mais limpa para preg_match , preg_match_all , preg_replace e preg_replace_callback .

 use Spatie  Regex  Regex ;

// Using `match`
Regex:: match ( ' /a/ ' , ' abc ' ); // `MatchResult` object
Regex:: match ( ' /a/ ' , ' abc ' )-> hasMatch (); // true
Regex:: match ( ' /a/ ' , ' abc ' )-> result (); // 'a'

// Capturing groups with `match`
Regex:: match ( ' /a(b)/ ' , ' abc ' )-> result (); // 'ab'
Regex:: match ( ' /a(b)/ ' , ' abc ' )-> group ( 1 ); // 'b'

// Setting defaults
Regex:: match ( ' /a(b)/ ' , ' xyz ' )-> resultOr ( ' default ' ); // 'default'
Regex:: match ( ' /a(b)/ ' , ' xyz ' )-> groupOr ( 1 , ' default ' ); // 'default'

// Using `matchAll`
Regex:: matchAll ( ' /a/ ' , ' abcabc ' )-> hasMatch (); // true
Regex:: matchAll ( ' /a/ ' , ' abcabc ' )-> results (); // Array of `MatchResult` objects

// Using replace
Regex:: replace ( ' /a/ ' , ' b ' , ' abc ' )-> result (); // 'bbc' ;
Regex:: replace ( ' /a/ ' , function ( MatchResult $ result ) {
    return $ result -> result () . ' Hello! ' ;
}, ' abc ' )-> result (); // 'aHello!bc' ;

Spatie é uma agência de webdesign com sede em Antuérpia, Bélgica. Você encontrará uma visão geral de todos os nossos projetos de código aberto em nosso site.

Apoie-nos

Investimos muitos recursos na criação dos melhores pacotes de código aberto. Você pode nos apoiar comprando um de nossos produtos pagos.

Agradecemos muito que você nos envie um cartão postal de sua cidade natal, mencionando qual(is) de nossos pacotes você está usando. Você encontrará nosso endereço em nossa página de contato. Publicamos todos os cartões postais recebidos em nosso mural virtual de cartões postais.

Instalação

Você pode instalar o pacote via compositor:

composer require spatie/regex

Uso

Combinando um padrão uma vez

Corresponde a um padrão em um assunto. Retorna um objeto MatchResult para a primeira correspondência.

 / * *
 * @ param string $ pattern
 * @ param string $ subject
 *
 * @ return  Spatie  Regex  MatchResult
 * /
Regex:: match (string $ pattern , string $ subject ): MatchResult

`MatchResult::hasMatch(): bool`

Verifica se o padrão corresponde ao assunto.

Regex:: match ( ' /abc/ ' , ' abc ' )-> hasMatch (); // true
Regex:: match ( ' /def/ ' , ' abc ' )-> hasMatch (); // false

`MatchResult::result(): string`

Retorne a correspondência completa que foi feita. Retorna null se nenhuma correspondência foi feita.

Regex:: match ( ' /abc/ ' , ' abc ' )-> result (); // 'abc'
Regex:: match ( ' /def/ ' , ' abc ' )-> result (); // null

`MatchResult::group(int $id): string`

Retorna o conteúdo de um grupo capturado (com um índice baseado em 1). Lança uma exceção RegexFailed se o grupo não existir.

Regex:: match ( ' /a(b)c/ ' , ' abc ' )-> group ( 1 ); // 'b'
Regex:: match ( ' /a(b)c/ ' , ' abc ' )-> group ( 2 ); // `RegexFailed` exception

Correspondendo todas as ocorrências de um padrão

Corresponde a um padrão em um assunto. Retorna um objeto MatchAllResult contendo todas as correspondências.

 / * *
 * @ param string $ pattern
 * @ param string $ subject
 *
 * @ return  Spatie  Regex  MatchAllResult
 * /
public static function matchAll( string $ pattern , string $ subject ): MatchAllResult

`MatchAllResult::hasMatch(): bool`

Verifica se o padrão corresponde ao assunto.

Regex:: matchAll ( ' /abc/ ' , ' abc ' )-> hasMatch (); // true
Regex:: matchAll ( ' /abc/ ' , ' abcabc ' )-> hasMatch (); // true
Regex:: matchAll ( ' /def/ ' , ' abc ' )-> hasMatch (); // false

`MatchAllResult::results(): array`

Retorna uma matriz de objetos MatchResult .

 $ results = Regex:: matchAll ( ' /ab([a-z])/ ' , ' abcabd ' )-> results ();

$ results [ 0 ]-> result (); // 'abc'
$ results [ 0 ]-> group ( 1 ); // 'c'
$ results [ 1 ]-> result (); // 'abd'
$ results [ 1 ]-> group ( 1 ); // 'd'

Substituindo um padrão em um assunto

Substitui um padrão em um assunto. Retorna um objeto ReplaceResult .

 / * *
 * @ param string | array $ pattern
 * @ param string | array | callable $ replacement
 * @ param string | array $ subject
 * @ param int $ limit
 *
 * @ return  Spatie  Regex  ReplaceResult
 * /
public static function replace( $ pattern , $ replacement , $ subject , $ limit = - 1 ): ReplaceResult

`ReplaceResult::result(): mixed`

Regex:: replace ( ' /a/ ' , ' b ' , ' abc ' )-> result (); // 'bbc'

Regex::replace também funciona com callables. O callable receberá uma instância MatchResult como argumento.

Regex:: replace ( ' /a/ ' , function ( MatchResult $ matchResult ) {
    return str_repeat ( $ matchResult -> result (), 2 );
}, ' abc ' )-> result (); // 'aabc'

Padrões, substituições e assuntos também podem ser matrizes. Regex::replace se comporta exatamente como preg_replace nesses casos.

Tratamento de erros

Se algo der errado em um método Regex , uma exceção RegexFailed será lançada. Não há necessidade de verificar preg_last_error() .

Teste

$ composer test

Registro de alterações

Consulte CHANGELOG para obter mais informações sobre o que mudou recentemente.

Contribuindo

Consulte CONTRIBUINDO para obter detalhes.

Vulnerabilidades de segurança

Revise nossa política de segurança sobre como relatar vulnerabilidades de segurança.

Cartões postais

Você é livre para usar este pacote, mas se ele chegar ao seu ambiente de produção, agradecemos muito que você nos envie um cartão postal de sua cidade natal, mencionando quais de nossos pacotes você está usando.

Nosso endereço é: Spatie, Kruikstraat 22, 2018 Antuérpia, Bélgica.

Publicamos todos os cartões postais recebidos no site da nossa empresa.