fnmatch
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
fnmatch — Перевірка збігу імені файлу із шаблоном
Опис
fnmatch(string $pattern, string $filename, int $flags = 0): bool
fnmatch() перевіряє, чи збігається переданий параметр filename із зазначеним шаблоном підстановок оболонки pattern
Список параметрів
pattern
Шаблон встановлення оболонки операційної системи.
filename
Перевірений рядок. Ця функція особливо корисна для імен файлів, але також може бути використана зі звичайними рядками.
Середньостатистичний користувач знайомий з підстановками оболонки, як мінімум з найпростішими з них. '?'и'*', так що використання fnmatch() замість preg_match() для пошуку в частині користувача сайту може бути набагато зручніше для користувачів, які не є програмістами.
flags
Значением параметраflags може бути будь-яка комбінація наступних прапорів, об'єднаних за допомогою бінарного оператора АБО (|)
Перелік можливих прапорів для функції fnmatch()
Флаг | Опис |
|---|---|
FNM_NOESCAPE | Вимкнути екранування зворотних слішів. |
FNM_PATHNAME | Слєш у рядку збігається тільки зі слєшем у вказаному шаблоні. |
FNM_PERIOD | Ведуча точка в рядку повинна точно збігатися з точкою у вказаному шаблоні. |
FNM_CASEFOLD | Збіг без урахування регістру. Є частиною розширення GNU. |
Значення, що повертаються
При збігу повертає true, інакше повертає false
Приклади
Приклад #1 Перевіряє відповідність кольору шаблону підстановки
Примітки
Увага
На даний момент ця функція недоступна на POSIX-сумісних системах, за винятком Windows.
Дивіться також
- glob() - Знаходить файлові шляхи, що збігаються із шаблоном
- preg_match() - Виконує перевірку на відповідність регулярному виразу
- sscanf() - Розбирає рядок відповідно до заданого формату
- printf() - Виводить відформатований рядок
- sprintf() - Повертає відформатований рядок