fnmatch

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

fnmatchDosya ismi belirtilen kalıpla eşleşiyor mu diye bakar

Açıklama

fnmatch(string $kalıp, string $dosyaismi, int $seçenekler = 0): bool

fnmatch() işlevi, belirtilen dosyaismi'nin belirtilen dosya kalıbı ile eşleşip eşleşmediğine bakar.

Bağımsız Değişkenler

kalıp

Eşleştirilecek kalıp. Normalde kalıp '?' ve '*' gibi kabuk dosya kalıplarıdır.

kalıp olarak kullanılabilecek kabuk dosya kalıpları:
Kalıp Açıklama
? Herhangi bir tek karakterle eşleşir. Örneğin "file?.txt" kalıbı "file1.txt" ve "fileA.txt" ile eşleşir ama "file10.txt" ile eşleşmez.
* Sıfır ya da daha fazla karakterle eşleşir. Örneğin, "foo*.xml" kalıbı "foo.xml" ve "foobar.xml" ile eşleşir.
[ ] Bir veya daha fazla karakter aralığı belirtmekte kullanılır. Örneğin, "index.php[45]" kalıbı "index.php4" ve "index.php5" ile eşleşir, ama "index.phpt" ile eşleşmez. Çok kullanılan aralıklar: [0-9], [a-z] ve [A-Z]. Ayrıca, [0-9a-zABC] biçeminde birden fazla aralık da belirtilebilir
! Köşeli ayraçlar içinde karakterleri olumsuzlamakta kullanılır. Örneğin, "[!A-Z]*.html" kalıbı "demo.html" ile eşleşir ama "Demo.html" ile eşleşmez.
\ Özel karakterleri öncelemekte kullanılır. Örneğin, "Name\?" kalıbı "Name?" ile eşleşir ama "Names" ile eşleşmez.

dosyaismi

Sınanacak dizge. İşlev özellikle dosya isimleri için yararlı olsa da sıradan dizgeler için de kullanılabilir.

Ortalama bir kullanıcı, kabuk dosya ismi kalıplarını veya bunların en basit biçimleri olan '?' ve '*' karakterlerini kullanabilir. Bu bakımdan, programcı olmayan kullanıcılar için preg_match() yerine fnmatch() kullanımı daha uygun olabilir.

seçenekler

Belirtilebilecek seçenekler:

fnmatch() işlevinin seçenekler bağımsız değişkeninde belirtilebilecek seçenekler
Seçenek Açıklama
FNM_NOESCAPE \ karakteri kalıplarda özel olarak ele alınmaz. Normalde, \ kendinden sonraki karakteri önceler; bu seçenek etkinse bu özellik kapatılır, böylece sadece kendisiyle eşleşebilir. Önceleme etkin olduğunda, \? kalıbı sadece ? karakteri ile eşleşir, çünkü kalıp içindeki soru işareti sıradan bir karakter gibi işlem görür. Eğer FNM_NOESCAPE seçeneği etkinse, \ sıradan bir karakterdir.
FNM_PATHNAME Bu POSIX.2 ile gelen bir FNM_FILE_NAME takma ismidir.
FNM_PERIOD

. karakteri dosya isimlerinin başında ise özel olarak ele alınır. Bu seçenek etkinse ve . karakteri dizge dizgesinin ilk karakteri ise kalıp ile eşleşemez.

FNM_PERIOD ve FNM_FILE_NAME birlikte belirtilmişse, . karakterinin dizge dizgesinin başında olmasının yanında / karakterini izlediği durumda da eşleşme sağlanır. (Kabuk FNM_PERIOD ve FNM_FILE_NAME seçeneklerini dosya isimleriyle eşleşme ararken birlikte kullanır.)

FNM_CASEFOLD dizge ile kalıp karşılaştırılırken harf büyüklüğüne bakılmaz.

Dönen Değerler

Eşleşme sağlanmışsa true aksi takdirde false.

Örnekler

Örnek 1 - Bir renk isminin bir kabuk dosya kalıbıyla eşleştirilmesi

<?php
if (fnmatch("*gr[ae]y", $color)) {
echo
"grinin bir tonu ...";
}
?>

Notlar

Uyarı

Bu işlev şimdilik POSIX uyumlu olmayan sistemlerde kullanılamamaktadır, Windows hariç.

Ayrıca Bakınız

  • glob() - Bir kalıpla eşleşen dosya yollarını bulur
  • preg_match() - Bir düzenli ifadeyi eşleştirmeye çalışır
  • sscanf() - Girdi dizgesini belli bir biçeme göre yorumlar
  • printf() - Biçemli bir dizge çıktılar
  • sprintf() - Biçemli bir dizge döndürür