Unduhan regex - pengunduhan kode sumber regex

regex

Kategori lainnya

3.1.1

Unduh

Menjadikan regex hebat lagi

Fungsi preg_* bawaan Php memerlukan beberapa pola aneh seperti meneruskan variabel dengan referensi dan memperlakukan nilai false atau null sebagai kesalahan. spatie/regex menyediakan antarmuka yang lebih bersih untuk preg_match , preg_match_all , preg_replace dan 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 adalah agen desain web yang berbasis di Antwerpen, Belgia. Anda akan menemukan ikhtisar semua proyek sumber terbuka kami di situs web kami.

Dukung kami

Kami menginvestasikan banyak sumber daya untuk menciptakan paket sumber terbuka terbaik di kelasnya. Anda dapat mendukung kami dengan membeli salah satu produk berbayar kami.

Kami sangat menghargai Anda mengirimi kami kartu pos dari kota asal Anda, yang menyebutkan paket kami mana yang Anda gunakan. Anda akan menemukan alamat kami di halaman kontak kami. Kami mempublikasikan semua kartu pos yang diterima di dinding kartu pos virtual kami.

Instalasi

Anda dapat menginstal paket melalui composer:

composer require spatie/regex

Penggunaan

Mencocokkan pola satu kali

Mencocokkan pola pada subjek. Mengembalikan objek MatchResult untuk kecocokan pertama.

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

`MatchResult::hasMatch(): bool`

Memeriksa apakah polanya cocok dengan subjeknya.

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

`MatchResult::result(): string`

Kembalikan pertandingan penuh yang telah dibuat. Mengembalikan null jika tidak ada kecocokan yang dilakukan.

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

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

Mengembalikan konten grup yang diambil (dengan indeks berbasis 1). Melempar pengecualian RegexFailed jika grup tidak ada.

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

Mencocokkan semua kemunculan suatu pola

Mencocokkan pola pada subjek. Mengembalikan objek MatchAllResult yang berisi semua kecocokan.

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

`MatchAllResult::hasMatch(): bool`

Memeriksa apakah polanya cocok dengan subjeknya.

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

`MatchAllResult::results(): array`

Mengembalikan array objek 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'

Mengganti pola pada subjek

Menggantikan pola dalam subjek. Mengembalikan objek 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 juga berfungsi dengan callable. Callable akan menerima instance MatchResult sebagai argumennya.

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

Pola, pengganti dan subjek juga bisa berupa array. Regex::replace berperilaku persis seperti preg_replace dalam kasus tersebut.

Penanganan kesalahan

Jika ada yang salah dalam metode Regex , pengecualian RegexFailed akan muncul. Tidak perlu memeriksa preg_last_error() .

Pengujian

$ composer test

log perubahan

Silakan lihat CHANGELOG untuk informasi lebih lanjut tentang apa yang berubah baru-baru ini.

Berkontribusi

Silakan lihat KONTRIBUSI untuk rinciannya.

Kerentanan Keamanan

Harap tinjau kebijakan keamanan kami tentang cara melaporkan kerentanan keamanan.

Peralatan kartu pos

Anda bebas menggunakan paket ini, namun jika paket ini masuk ke lingkungan produksi Anda, kami sangat menghargai Anda mengirimi kami kartu pos dari kota asal Anda, yang menyebutkan paket kami mana yang Anda gunakan.

Alamat kami adalah: Spatie, Kruikstraat 22, 2018 Antwerp, Belgia.

Kami mempublikasikan semua kartu pos yang diterima di situs web perusahaan kami.