java.util.regex
클래스 Pattern

java.lang.Object 
  java.util.regex.Pattern

모든 구현된 인터페이스:

Serializable

public final class Pattern
extends Object 
implements Serializable 

컴파일 끝난 정규 표현입니다.

정규 표현은 캐릭터 라인으로서 지정해, 이 클래스의 인스턴스에 컴파일 할 필요가 있습니다. 생성된 패턴은, Matcher 객체를 작성하기 위해서 사용됩니다. 이 객체는 임의 문자 순서 곳의 정규 표현을 성냥 할 수 있습니다. 성냥을 실행했을 때 상태는 모두 정규 표현 엔진에 포함됩니다. 이 때문에 복수의 정규 표현 엔진이 같은 패턴을 공유할 수 있습니다.

표준적인 calling sequence는 다음과 같이 됩니다.

 Pattern p = Pattern. compile ("a*b");
 Matcher m = p. matcher ("aaaaab");
 boolean b = m. matches ();

이 클래스에 정의한 matches 메서드를 사용하면, 정규 표현은 한 번 사용하는 것만으로 끝납니다. 이 메서드를 1회 호출하는 것만으로 표현이 컴파일 되어 입력 순서와의 성냥을 합니다. 다음의 문장은 전술의 3개의 문장과 같습니다.

 boolean b = Pattern.matches("a*b", "aaaaab");

다만, 성냥을 반복하는 경우는 컴파일 끝난 패턴을 재이용할 수 없기 때문에 효율이 저하합니다.

이 클래스의 인스턴스는 불변이기 때문에 복수의 thread로 동시에 사용할 수 있습니다. Matcher 클래스의 인스턴스는 복수 thread에서의 동시 사용에 대응하고 있습니다.

정규 표현 구문의 요약

구문	매치 대상
문자
x	문자 x
\\	backslash 문자
\0n	8 진수 0n를 가지는 문자 (0 <= n <= 7)
\0nn	8 진수 0nn를 가지는 문자 (0 <= n <= 7)
\0mnn	8 진수 0mnn를 가지는 문자 (0 <= m <= 3, 0 <= n <= 7)
\xhh	16 진수 0xhh를 가지는 문자
\uhhhh	16 진수 0xhhhh를 가지는 문자
\t	탭 문자 ('\u0009')
\n	개행 문자 ('\u000A')
\r	왕복대 리턴 문자 ('\u000D')
\f	용지 보내 문자 ('\u000C')
\a	경고 (벨) 문자 ('\u0007')
\e	이스케이프 문자 ('\u001B')
\cx	x에 대응하는 제어 문자
문자 클래스
[abc]	a, b, 또는 c (단순 클래스)
[^abc]	a, b, c 이외의 문자 (부정)
[a-zA-Z]	a ~ z 또는 A ~ Z (범위)
[a-d[m-p]]	a ~ d, 또는 m ~ p: [a-dm-p] (결합)
[a-z&&[def]]	d, e, f (교차)
[a-z&&[^bc]]	b와 c를 제외하는 a ~ z: [ad-z] (감산)
[a-z&&[^m-p]]	m ~ p를 제외하는 a ~ z: [a-lq-z] (감산)
정의 끝난 문자 클래스
.	임의의 문자 (줄 끝 기호와 성냥 하는 경우도 있다)
\d	숫자: [0-9]
\D	숫자 이외: [^0-9]
\s	공백 문자: [ \t\n\x0B\f\r]
\S	비공백 문자: [^\s]
\w	단어 구성 문자: [a-zA-Z_0-9]
\W	비단어 문자: [^\w]
POSIX 문자 클래스 (US-ASCII 마셔)
\p{Lower}	소문자의 영문자: [a-z]
\p{Upper}	대문자의 영문자: [A-Z]
\p{ASCII}	모든 ASCII 문자: [\x00-\x7F]
\p{Alpha}	영문자: [\p{Lower}\p{Upper}]
\p{Digit}	10 진수자: [0-9]
\p{Alnum}	영숫자: [\p{Alpha}\p{Digit}]
\p{Punct}	구두점 문자: ! "#$%&'()*+,-. /:;<=>? @[\]^_`{|}~ 언젠가
\p{Graph}	표시할 수 있는 문자: [\p{Alnum}\p{Punct}]
\p{Print}	프린트 가능 문자: [\p{Graph}\x20]
\p{Blank}	공백 또는 탭: [ \t]
\p{Cntrl}	제어 문자: [\x00-\x1F\x7F]
\p{XDigit}	16 진수자: [0-9a-fA-F]
\p{Space}	공백 문자: [ \t\n\x0B\f\r]
java.lang.Character 클래스 (단순한 java 문자 타입)
\p{javaLowerCase}	java.lang.Character.isLowerCase()와 등가
\p{javaUpperCase}	java.lang.Character.isUpperCase()과 등가
\p{javaWhitespace}	java.lang.Character.isWhitespace()와 등가
\p{javaMirrored}	java.lang.Character.isMirrored()와 등가
Unicode 블록과 카테고리의 클래스
\p{InGreek}	희랍어 블록의 문자 (단순블록)
\p{Lu}	대문자 (단순카테고리)
\p{Sc}	통화 기호
\P{InGreek}	희랍어 블록 이외의 문자 (부정)
[\p{L}&&[^\p{Lu}]]	대문자 이외의 문자 (감산)
경계 정규 표현 엔진
^	행의 선두
$	행의 말미
\b	단어 경계
\B	비단어 경계
\A	입력의 선두
\G	전회의 성냥의 말미
\Z	마지막줄 끝 기호가 있는 경우는 그것을 제외한 입력의 말미
\z	입력의 말미
최장 일치 수량자
X?	X, 1 또는 0 회
X*	X, 0 회 이상
X+	X, 1회 이상
X{n}	X, n 회
X{n,}	X, n 회이상
X{n, m}	X, n 회이상, m 회이하
최단 일치 수량자
X??	X, 1 또는 0 회
X*?	X, 0 회 이상
X+?	X, 1회 이상
X{n}?	X, n 회
X{n,}?	X, n 회이상
X{n, m}?	X, n 회이상, m 회이하
탐욕인 수량자
X? +	X, 1 또는 0 회
X*+	X, 0 회 이상
X++	X, 1회 이상
X{n}+	X, n 회
X{n,}+	X, n 회이상
X{n, m}+	X, n 회이상, m 회이하
논리 연산자
XY	X 직후에 Y
X|Y	X 또는 Y
(X)	X, 상대방 참조를 실시하는 정규 표현 그룹
전방 참조
\n	매치한 n 번째의 상대방 참조를 실시하는 정규 표현 그룹
인용
\	정규 표현은 아니지만, 다음의 문자를 이스케이프 하는
\Q	정규 표현은 아니지만, \E 까지의 모든 문자를 이스케이프 하는
\E	정규 표현은 아니지만, \Q로 개시된 인용을 이스케이프 해
특수한 구문 (상대방 참조를 실시하지 않는다)
(? :X)	X, 상대방 참조를 실시하지 않는 정규 표현 그룹
(? idmsux-idmsux)	정규 표현은 아니지만, 매치 플래그의 온/오프를 바꾼다
(? idmsux-idmsux:X)	X, 지정된 플래그를 온/오프로 한상대방 참조를 실시하지 않는 정규 표현 그룹
(? =X)	X, 폭제로의 긍정 예측
(?!X)	X, 폭제로의 부정 예측
(? <=X)	X, 폭제로의 긍정 후 읽기
(? <! X)	X, 폭제로의 부정 후 읽기
(? >X)	X, 독립한상대방 참조를 실시하지 않는 정규 표현 그룹

backslash, 이스케이프 및 인용

backslash 문자 ('\')는 전술의 겉(표)에 정의되고 있는 구문을 이스케이프 합니다. 또, 지정하지 않았던 경우는 이스케이프되어 있지 않다고 해석되는 캐릭터 라인을 인용합니다. 예를 들어 정규 표현 \\ 은 1개의 backslash와 성냥 해, \{는 왼쪽 괄호와 성냥 합니다.

영문자의 전에 backslash를 사용했을 때에 그 영문자가 이스케이프 구문이 아닌 경우는 에러가 됩니다. 이러한 패턴은 정규 표현 언어의 향후의 확장에 예약되고 있습니다. 영문자 이외의 문자의 경우는 그 문자가 이스케이프 구문에 포함될지 어떨지에 관계없이, backslash를 지정할 수 있습니다.

Java 언어 사양에서는 Java 원시 코드의 캐릭터 라인 리터럴에 포함되는 backslash는 Unicode 이스케이프등의 문자 이스케이프로서 유효하다라고 해석됩니다. 이 때문에 backslash가 Java 바이트 코드 컴파일러에 의해 해석되지 않게 하려면, 정규 표현을 나타내는 캐릭터 라인 리터럴내에서 backslash를 2개 계속할 필요가 있습니다. 예를 들어 캐릭터 라인 리터럴 "\b"는 정규 표현이라고 해석되면, 백 스페이스 1 문자와 성냥 됩니다. 그러나, "\\b"는 단어 경계와 성냥 됩니다. 또, 캐릭터 라인 리터럴 "\(hello\)" 은 부당하게 되어, 컴파일시 에러가 발생합니다. 캐릭터 라인 (hello) 과 성냥 되려면, 캐릭터 라인 리터럴 "\\(hello\\)"을 사용할 필요가 있습니다.

문자 클래스

문자 클래스는 다른 문자 클래스내로 지정하거나 결합 연산자 (암묵적)나 교차 연산자 (&&)를 사용해 작성할 수 있습니다 . 결합 연산자는 1개 이상의 오퍼랜드 클래스에 포함되는 모든 문자를 포함한 클래스를 나타냅니다. 교차 연산자는 2개의 오퍼랜드 클래스에 포함되는 모든 문자를 포함한 클래스를 나타냅니다.

문자 클래스 연산자는 다음의 순서로 우선 순위가 높아집니다.

1	리터럴 이스케이프	\x
2	그룹화	[...]
3	범위	a-z
4	결합	[a-e][i-u]
5	교차	[a-z&&[aeiou]]

실제로는 다른 메타캐라크타세트는 문자 클래스의 외부가 아니고 내부에 존재하는 것에 유의해 주세요. 예를 들어 정규 표현 . 는 문자 클래스 내부에서는 그 특수한 미를 잃습니다만, 표현 - 은 범위를 나타내는 메타캐라크타가 됩니다.

줄 끝 기호

「줄 끝 기호」란 입력 문자 순서의 행의 말미를 지정할 경우에 사용하는 1 문자 또는 2 문자의 문자 순서입니다. 다음의 문자가 줄 끝 기호로서 인식됩니다.

• 개행 문자 ('\n')
• 직후에 개행 문자가 붙은 왕복대 리턴 문자 ("\r\n")
• 단독의 왕복대 리턴 문자 ('\r')
• 다음 행 문자 ('\u0085')
• 행 단락 문자 ('\u2028')
• 단락 단락 문자 ('\u2029)

UNIX_LINES 모드가 유효한 경우는 개행 문자만이 줄 끝 기호로서 인식됩니다.

정규 표현 . 는 DOTALL 플래그가 지정되어 있지 않은 경우, 줄 끝 기호 이외의 모든 문자와 성냥 합니다.

디폴트에서는 정규 표현 ^ 및 $ 하행말 기호를 무시해, 입력 순서 전체의 각각 선두와 말미인 만큼 성냥 합니다. MULTILINE 모드가 활성화 되면, ^는 입력의 선두 및 입력의 말미를 제외한 모든 줄 끝 기호의 후에 성냥 합니다. MULTILINE 모드의 경우, $ 하행말 기호의 직전, 또는 입력 순서의 말미에 성냥 합니다.

정규 표현 그룹과 상대방 참조

상대방 참조를 실시하는 정규 표현 그룹에는 왼쪽에서 우측향에 왼쪽환괄호를 세는 것에의해 번호를 붙일 수 있습니다. 예를 들어 표현 ((A)(B(C)))는 다음의 4개의 그룹으로 분류됩니다.

1	((A)(B(C)))
2	(A)
3	(B(C))
4	(C)

그룹 0 은 항상 표현 전체를 나타냅니다.

상대방 참조를 실시하는 정규 표현 그룹이 이와 같이 분류되고 나서, 입력 순서의 각 부분 순서가 이러한 그룹과 성냥 되어 성냥 할 때마다 부분 순서가 보존됩니다. 정규 표현 그룹의 부분 순서는 전방 참조로서 표현내에서 나중에 사용할 수 있겠습니다. 또, 매치 조작이 완료하면, 정규 표현 엔진으로부터 꺼낼 수도 있습니다.

그룹과 입력 순서가 성냥 되면, 그 그룹과 마지막에 성냥 한 부분 순서가 항상 상대방 참조됩니다. 수량자를 지정했을 경우는 그룹이 한번 더 평가됩니다. 2번째의 평가가 실패했을 경우에서도, 그 전에 상대방 참조된 값이 있는 경우는 그 값이 보관 유지됩니다. 예를 들어 캐릭터 라인 "aba"를 표현 (a(b)? )+ (와)과 성냥 했을 경우는 그룹 2 로 설정된 "b"가 보관 유지됩니다. 상대방 참조된 모든 입력은 각 매값이 시작되기 전에 파기됩니다.

(? 그리고 시작되는 그룹은 순수한 「상대방 참조되지 않는 정규 표현」그룹에서 텍스트를 상대방 참조하지 않고, 그룹 전체에 카운트 되지 않습니다.

Unicode 지원

이 클래스는 「Unicode Technical Standard #18: Unicode Regular Expression Guidelines」 (Unicode 테크니컬 스탠다드 No. 18: Unicode 정규 표현 가이드 라인) 및, 릴리스 2.1 「Canonical Equivalents」 (표준 등가)을 참조하십시오.

Java 원시 코드에서는 \u2014 등의 Unicode escape sequence는 「Java 언어 사양」의 3.3에 근거해 처리됩니다. 이러한 escape sequence는 정규 표현 파서에 의해 직접 구현되기 때문에 파일 또는 키보드로부터 읽어들인 표현 안에서도 Unicode 이스케이프를 사용할 수 있습니다. 즉, 캐릭터 라인 "\u2014"와 "\\u2014"는 등가가 아닙니다만, 같은 패턴에 컴파일 되어 16 진수 0x2014 문자와 성냥 합니다.

Unicode 블록 및 카테고리는 Perl와 같게 \p 및 \P 구문으로 기술합니다. 입력에 프로퍼티 prop가 포함되는 경우, \p{prop}는 성냥 합니다만, \P{prop}는 성냥 하지 않습니다. 블록에는 InMongolian와 같이, 접두사 In를 지정합니다. 카테고리에는 접두사 Is를 지정할 수도 있습니다. \p{L}와 \p{IsL}는 Unicode 문자의 카테고리를 나타냅니다. 블록과 카테고리는 문자 클래스의 내부 및 외부의 어느 쪽에도 사용할 수 있습니다.

지원 되고 있는 카테고리는 Character 클래스에서 지정된 버전의 The Unicode Standard에 기재되어 있습니다. 카테고리명에 대해서는 Unicode 표준에 규준과 정보가 정의되고 있습니다. Pattern 지원하는 블록명은, UnicodeBlock.forName 에 의해 받아들여져 정의되는 유효한 블록명입니다.

methodname 메서드 (비추천의 메서드를 제외하다)인 java.lang.Character boolean와 같게 기능하는 카테고리는 지정된 프로퍼티가 이름 javamethodname를 가지는 동일한 \p{prop} 구문 전체로 사용 가능합니다.

Perl 5 라는 비교

Pattern 엔진은 Perl 5 로 같이, 정렬 된 대체에 대한 종래의 NFA 베이스의 매칭을 실행합니다.

이 클래스에서 지원 되어 있지 않은 Perl 구문

• 조건부 구문 (? {X}) 및 (? (조건)X|Y)

• 매입 코드 구문 (? {코드}) 및 (??{코드})

• 매입 코멘트 구문 (? #코멘트)

• 프리프로세스 연산 \l \u, \L, \U

이 클래스에서 지원 되고 있지만, Perl 로 지원 되어 있지 않은 구문

• 탐욕인 수량자. 가능한 한 긴 캐릭터 라인과 성냥 한다. 퇴보 (백 트럭) 하면 정규 표현 전체의 성냥이 성공할 때에도, 퇴보 하지 않는다

• 문자 클래스의 결합과 교차 (전술)

Perl와 의 큰 차이점

• Perl 에서는 \1 ~ \9는 항상 전방 참조라고 해석된다. 9를 넘는 숫자가 backslash로 이스케이프 되고 있을 때는 대응하는 수의 부분 패턴이 존재하는 경우, 전방 참조로 간주해진다. 존재하지 않는 경우는 8 진수의 이스케이프 (가능한 경우)로 간주해진다. 이 클래스에서는 8 진수의 이스케이프는 항상 제로로 시작된다. \1 ~ \9는 항상 전방 참조라고 해석된다. 그것보다 큰 숫자는 정규 표현의 그 개소에 대응하는 수의 부분 패턴이 존재하는 경우는 전방 참조로 간주해진다. 존재하지 않는 경우는 그 숫자가 기존의 그룹 번호 이하가 되는지, 1 자리수의 숫자가 될 때까지, 자리수가 줄여진다

• Perl 에서는 마지막 성냥이 종료한 장소로부터 성냥의 재개를 요구할 때는 g 플래그를 사용한다. 이 기능은, Matcher 클래스에 의해 암묵적으로 제공된다. find 메서드를 반복해 호출하면, 정규 표현 엔진이 리셋 되지 않는 한, 마지막 성냥이 종료한 장소로부터 매치 조작이 재개한다

• Perl 에서는 표현의 최상정도에 파묻힌 플래그가 표현 전체에 적용된다. 이 클래스의 매입 플래그는 파묻힌 장소에 관계없이, 그 개소에서만 유효하게 된다. 플래그가 그룹내에 파묻히고 있는 경우는 Perl와 같게 그룹의 최후로 복원된다

• Perl 에서는 표현 *a 등이 부정한 매치 구문이나 표현 abc] 등의 매달려 괄호를 허용 하고 있어, 그것들을 리터럴로 간주한다. 이 클래스에서도 매달려 괄호는 받아들이지만,+,?, * 등의 매달려 메타캐라크타는 허용 하지 않고, 그것들이 발견되었을 경우는 PatternSyntaxException를 Throw 한다

정규 표현 구문의 동작의 상세한 것에 대하여는 「Mastering Regular Expressions, 2nd Edition」 (Jeffrey E. F. Friedl 저, O'Reilly and Associates, 2002 년) 을 참조하십시오.

도입된 버전 :

1.4

관련 항목:

String.split(String, int), String.split(String), 직렬화 된 형식

필드 개요

static int	CANON_EQ 표준 등가를 유효하게 합니다.
static int	CASE_INSENSITIVE 대문자와 소문자를 구별하지 않는 매칭을 유효하게 합니다.
static int	COMMENTS 패턴내에서 공백과 코멘트를 사용할 수 있도록 합니다.
static int	DOTALL DOTALL 모드를 유효하게 합니다.
static int	LITERAL 패턴의 리터럴 구문 분석을 유효하게 합니다.
static int	MULTILINE 복수행 모드를 유효하게 합니다.
static int	UNICODE_CASE Unicode에 준거한 대문자와 소문자를 구별하지 않는 매칭을 유효하게 합니다.
static int	UNIX_LINES Unix 라인 모드를 유효하게 합니다.

메서드 개요

static Pattern	compile (String regex) 지정된 정규 표현을 패턴에 컴파일 합니다.
static Pattern	compile (String regex, int flags) 지정된 플래그를 사용해, 지정된 정규 표현을 패턴에 컴파일 합니다.
int	flags () 이 패턴의 매치 플래그를 리턴합니다.
Matcher	matcher (CharSequence input) 지정된 입력과 이 패턴을 성냥 하는 정규 표현 엔진을 작성합니다.
static boolean	matches (String regex, CharSequence input) 지정된 정규 표현을 컴파일 해, 지정된 입력과 그 정규 표현을 성냥 합니다.
String	pattern () 이 패턴의 컴파일원의 정규 표현을 리턴합니다.
static String	quote (String s) 지정된 String 리터럴 패턴 String를 리턴합니다.
String []	split (CharSequence input) 이 패턴의 성냥에 기반해 지정된 입력 순서를 분할합니다.
String []	split (CharSequence input, int limit) 이 패턴의 성냥에 기반해 지정된 입력 순서를 분할합니다.
String	toString () 이 패턴의 캐릭터 라인 표현을 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

필드의 상세

UNIX_LINES

public static final int UNIX_LINES

Unix 라인 모드를 유효하게 합니다.

이 모드에서는 '\n' 줄 끝 기호 이외는 . , ^, $ 동작에서는 인식되지 않습니다.

Unix 라인 모드는 매입 플래그 표현 (? d)를 사용해 유효하게 할 수도 있습니다.

관련 항목:

정수 필드값

CASE_INSENSITIVE

public static final int CASE_INSENSITIVE

대문자와 소문자를 구별하지 않는 매칭을 유효하게 합니다.

디폴트에서는 대문자와 소문자를 구별하지 않는 매칭에서는 US-ASCII 캐릭터셋의 문자만이 성냥 하는 것을 전제로 하고 있습니다. Unicode에 준거한 대문자와 소문자를 구별하지 않는 매칭을 유효하게 하려면, UNICODE_CASE 플래그를 이 플래그와 조합해 지정합니다.

대문자와 소문자를 구별하지 않는 매칭은 매입 플래그 표현 (? i)를 사용해 유효하게 할 수도 있습니다.

이 플래그를 지정하면, 퍼포먼스가 조금 저하하는 경우가 있습니다.

관련 항목:

정수 필드값

COMMENTS

public static final int COMMENTS

패턴내에서 공백과 코멘트를 사용할 수 있도록 합니다.

이 모드에서는 공백은 무시되어#로 시작되는 매입 코멘트는 줄 끝까지 무시됩니다.

코멘트 모드는 매입 플래그 표현 (? x)를 사용해 유효하게 할 수도 있습니다.

관련 항목:

정수 필드값

MULTILINE

public static final int MULTILINE

복수행 모드를 유효하게 합니다.

복수행 모드에서는 표현 ^ 과 $는 각각 줄 끝 기호 또는 입력 순서의 말미의 직후 또는 직전에 성냥 합니다. 디폴트에서는 이러한 표현은 입력 순서 전체의 선두와 말미에만 성냥 합니다.

복수행 모드는 매입 플래그 표현 (? m)를 사용해 유효하게 할 수도 있습니다.

관련 항목:

정수 필드값

LITERAL

public static final int LITERAL

패턴의 리터럴 구문 분석을 유효하게 합니다.

이 플래그가 가리키는 경우, 패턴을 지정하는 입력 캐릭터 라인은 리터럴 문자의 순서로서 처리됩니다. 입력 순서내의 메타캐라크타 또는 escape sequence에 특별한 미는 부여되지 않습니다.

CASE_INSENSITIVE 및 UNICODE_CASE 플래그를 이 플래그와 함께 사용하면, 매칭에 대한 영향이 유지됩니다. 다른 플래그는 불필요하게 됩니다.

리터럴 구문 분석을 유효하게하기 위한 매입 플래그 문자는 없습니다.

관련 항목:

정수 필드값

DOTALL

public static final int DOTALL

DOTALL 모드를 유효하게 합니다.

DOTALL 모드에서는 표현 . 하행말 기호를 포함한 임의의 문자에 성냥 합니다. 디폴트에서는 이 표현은 줄 끝 기호에 성냥 하지 않습니다.

DOTALL 모드는 매입 플래그 표현 (? s)를 사용해 유효하게 할 수도 있습니다 (s는 「단일행」모드의 Mnemonics에서 Perl 에서는 DOTALL 모드로 불린다).

관련 항목:

정수 필드값

UNICODE_CASE

public static final int UNICODE_CASE

Unicode에 준거한 대문자와 소문자를 구별하지 않는 매칭을 유효하게 합니다.

이 플래그와 CASE_INSENSITIVE 플래그를 동시에 지정했을 경우는 Unicode 표준에 준거한 대문자와 소문자를 구별하지 않는 매칭을 합니다. 디폴트의 대문자와 소문자를 구별하지 않는 매칭에서는 US-ASCII 캐릭터셋의 문자만이 성냥 합니다.

Unicode에 준거한 대문자와 소문자를 구별하지 않는 매칭은 매입 플래그 표현 (? u)를 사용해 유효하게 할 수도 있습니다.

이 플래그를 지정하면, 퍼포먼스가 저하하는 경우가 있습니다.

관련 항목:

정수 필드값

CANON_EQ

public static final int CANON_EQ

표준 등가를 유효하게 합니다.

이 플래그를 지정했을 때는 2개의 문자의 완전한 표준 분해가 성냥 했을 경우에 한정해, 그러한 문자가 성냥 한다고 보입니다. 예를 들어이 플래그를 지정하면, 표현 "a\u030A"는 캐릭터 라인 "? "에 성냥 합니다. 디폴트의 매칭에서는 표준 등가가 고려되지 않습니다.

표준 등가를 유효하게하기 위한 매입 플래그 문자는 없습니다.

이 플래그를 지정하면, 퍼포먼스가 저하하는 경우가 있습니다.

관련 항목:

정수 필드값

메서드의 상세

compile

public static Pattern  compile(String  regex)

지정된 정규 표현을 패턴에 컴파일 합니다.

파라미터:

regex - 컴파일 되는 표현

예외:

PatternSyntaxException - 표현의 구문이 무효인 경우

compile

public static Pattern  compile(String  regex,
                              int flags)

지정된 플래그를 사용해, 지정된 정규 표현을 패턴에 컴파일 합니다.

파라미터:

regex - 컴파일 되는 표현

flags - 매치 플래그. CASE_INSENSITIVE, MULTILINE, DOTALL, UNICODE_CASE, CANON_EQ를 포함한 비트 마스크

예외:

IllegalArgumentException - 정의된 매치 플래그에 대응하지 않는 비트값이 flags로 설정되었을 경우

PatternSyntaxException - 표현의 구문이 무효인 경우

pattern

public String  pattern()

이 패턴의 컴파일원의 정규 표현을 리턴합니다.

반환값:

이 패턴의 컴파일원

toString

public String  toString()

이 패턴의 캐릭터 라인 표현을 리턴합니다. 이것은 이 패턴의 컴파일원의 정규 표현입니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 패턴의 캐릭터 라인 표현

도입된 버전 :

1.5

matcher

public Matcher  matcher(CharSequence  input)

지정된 입력과 이 패턴을 성냥 하는 정규 표현 엔진을 작성합니다.

파라미터:

input - 매치되는 문자 순서

반환값:

이 패턴의 새로운 정규 표현 엔진

flags

public int flags()

이 패턴의 매치 플래그를 리턴합니다.

반환값:

이 패턴이 컴파일 되었을 때에 지정된 매치 플래그

matches

public static boolean matches(String  regex,
                              CharSequence  input)

지정된 정규 표현을 컴파일 해, 지정된 입력과 그 정규 표현을 성냥 합니다.

이 메서드를 다음의 형식에서 호출하면, 상기의 동작을 합니다.

 Pattern.matches(regex, input);

상기의 메서드는 다음의 표현과 같게 동작합니다.

 Pattern.compile(regex). matcher(input). matches()

패턴을 반복해 사용하는 경우는 그 패턴을 컴파일의해 재이용한 (분)편이, 매회 이 메서드를 호출하는 것보다도 효율적입니다.

파라미터:

regex - 컴파일 되는 표현

input - 매치되는 문자 순서

예외:

PatternSyntaxException - 표현의 구문이 무효인 경우

split

public String [] split(CharSequence  input,
                      int limit)

이 패턴의 성냥에 기반해 지정된 입력 순서를 분할합니다.

이 메서드로부터 리턴된 배열은 입력 순서의 부분 캐릭터 라인으로 구성됩니다. 이러한 부분 캐릭터 라인은 이 패턴과 성냥 하는 다른 부분 순서에 의해 분할된 캐릭터 라인인가 입력 순서의 종료에 의해 분할된 캐릭터 라인입니다. 배열내의 부분 캐릭터 라인은 입력 순서내에서 발생한 차례로 줄지어 있습니다. 이 패턴이 입력 순서의 부분 순서에 성냥 하지 않는 경우, 리턴된 배열은 1개의 요소, 즉 캐릭터 라인 형식의 입력 순서만으로 구성됩니다.

limit 파라미터는 이 패턴의 적용 회수, 즉, 리턴된 배열의 길이를 제어합니다. 제한 n가 제로보다 큰 경우, 이 패턴은 n - 1회아래의 회수가 적용되어 배열의 길이는 n 이하가 됩니다. 배열의 마지막 엔트리에는 마지막에 성냥 한 단락 문자 이후의 입력 순서가 모두 포함됩니다. n가 잘못된 값 의 경우, 이 패턴의 적용 회수와 배열의 길이는 제한되지 않습니다. n가 제로의 경우, 이 패턴의 적용 회수와 배열의 길이는 제한됩니다만, 후속의 비어있는 캐릭터 라인은 파기됩니다.

예를 들어 입력 순서 "boo:and:foo"는 이러한 파라미터에 의해 다음과 같이 분할됩니다.

정규 표현	제한	결과
:	2	{ "boo", "and:foo" }
:	5	{ "boo", "and", "foo" }
:	-2	{ "boo", "and", "foo" }
o	5	{ "b", "", ":and:f", "", "" }
o	-2	{ "b", "", ":and:f", "", "" }
o	0	{ "b", "", ":and:f" }

파라미터:

input - 분할되는 문자 순서

limit - 결과의의해 귀의치 (전술대로)

반환값:

캐릭터 라인의 배열. 이 패턴의 성냥에 근거해 분할된 입력 순서로부터 작성된다

split

public String [] split(CharSequence  input)

이 패턴의 성냥에 기반해 지정된 입력 순서를 분할합니다.

이 메서드는 limit 인수를 제로로의해 split 메서드를 호출했을 경우와 같게 입력 순서를 분할합니다. 즉, 리턴된 배열에는 후속의 비어있는 캐릭터 라인은 포함되지 않습니다.

예를 들어 입력 순서 "boo:and:foo"는 이러한 표현에 의해 다음과 같이 분할됩니다.

정규 표현	결과
:	{ "boo", "and", "foo" }
o	{ "b", "", ":and:f" }

파라미터:

input - 분할되는 문자 순서

반환값:

캐릭터 라인의 배열. 이 패턴의 성냥에 근거해 분할된 입력 순서로부터 작성된다

quote

public static String  quote(String  s)

지정된 String 리터럴 패턴 String를 리턴합니다.

이 메서드는 리터럴 패턴인것 같이 캐릭터 라인 s에 성냥 하는 Pattern 작성에 사용 가능한 String를 생성합니다.

입력 순서내의 메타캐라크타 또는 escape sequence에 특별한 미는 없습니다.

파라미터:

s - 리터럴화하는 캐릭터 라인

반환값:

리터럴 캐릭터 라인 치환

도입된 버전 :

1.5