(PHP 4, PHP 5, PHP 7)
preg_match — 정규표현식 매치를 수행
$pattern
, string $subject
[, array &$matches
[, int $flags
[, int $offset
]]] )
pattern
에 주어진 정규표현식을
subject
에서 찾습니다.
pattern
탐색할 패턴 문자열.
subject
입력 문자열.
matches
matches
가 주어지면, 검색 결과를 채워넣습니다.
$matches[0]는 전체 패턴 텍스트가 들어가고,
$matches[1]부터 괄호로 둘러싸인 서브 패턴을
채워넣습니다.
flags
flags
는 다음과 같은 플래그를 사용할 수 있습니다:
PREG_OFFSET_CAPTURE
offset
일반적으로, 검색은 목표 문자열의 처음에서 시작합니다. 선택적인 인수
offset
으로 검색을 시작할 다른 위치를 지정할 수
있습니다. (바이트 단위)
Note:
offset
을 사용하는 것은 preg_match()의 주제 문자열로 substr($subject, $offset)을 사용하는 것과 다릅니다.pattern
에 ^, $, (?<=x) 등의 단정을 포함할 수 있기 때문입니다. 비교:<?php
$subject = "abcdef";
$pattern = '/^def/';
preg_match($pattern, $subject, $matches, PREG_OFFSET_CAPTURE, 3);
print_r($matches);
?>위 예제의 출력:
Array ( )반면 이 예제는
<?php
$subject = "abcdef";
$pattern = '/^def/';
preg_match($pattern, substr($subject,3), $matches, PREG_OFFSET_CAPTURE);
print_r($matches);
?>다음 결과가 됩니다
Array ( [0] => Array ( [0] => def [1] => 0 ) )
preg_match()는 pattern
이
매치된 횟수를 반환합니다. 이는 0(매치 없음)이나 1입니다.
preg_match()는 처음 매치 후에 검색을 중지하기
때문입니다. 대조적으로, preg_match_all()는
subject
의 끝까지 계속해서 실행합니다.
에러가 발생하면, preg_match()는 FALSE
를 반환합니다.
버전 | 설명 |
---|---|
4.3.3 |
offset 인수 추가
|
4.3.0 |
PREG_OFFSET_CAPTURE 플래그 추가
|
4.3.0 |
flags 인수 추가
|
Example #1 문자열 "php" 찾기
<?php
// 패턴 구분자 뒤의 "i"는 대소문자를 구별하지 않게 합니다.
if (preg_match("/php/i", "PHP is the web scripting language of choice.")) {
echo "발견하였습니다.";
} else {
echo "발견하지 못했습니다.";
}
?>
Example #2 단어 "Web" 찾기
<?php
/* 패턴에서 \b는 단어를 지시합니다. 단어 "web"만 매치하고,
* "webbing"이나 "cobweb" 등의 부분적인 경우에는 매치하지 않습니다. */
if (preg_match("/\bweb\b/i", "PHP is the web scripting language of choice.")) {
echo "발견하였습니다.";
} else {
echo "발견하지 못했습니다.";
}
if (preg_match("/\bweb\b/i", "PHP is the website scripting language of choice.")) {
echo "발견하였습니다.";
} else {
echo "발견하지 못했습니다.";
}
?>
Example #3 URL에서 도메인 이름 얻기
<?php
// URL에서 호스트 이름 얻기
preg_match('@^(?:http://)?([^/]+)@i',
"http://www.php.net/index.html", $matches);
$host = $matches[1];
// 호스트 이름에서 마지막 두 세그멘트 얻기
preg_match('/[^.]+\.[^.]+$/', $host, $matches);
echo "도메인 이름은: {$matches[0]}\n";
?>
위 예제의 출력:
도메인 이름은: php.net
Example #4 이름 있는 서브패턴 사용하기
<?php
$str = 'foobar: 2008';
preg_match('/(?<name>\w+): (?<digit>\d+/', $str, $matches);
print_r($matches);
?>
위 예제의 출력:
Array ( [0] => foobar: 2008 [name] => foobar [1] => foobar [digit] => 2008 [2] => 2008 )