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}]
\p{Blank}	공백 또는 탭: [ \t]
\p{Cntrl}	제어 캐릭터: [\x00-\x1F\x7F]
\p{XDigit}	16 진수자: [0-9a-fA-F]
\p{Space}	공백 캐릭터: [ \t\n\x0B\f\r]
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 캐릭터의 캐릭터 순차 순서입니다. 다음의 캐릭터가 줄 끝 기호로서 인식됩니다.

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

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

정규 표현 . (은)는 DOTALL 플래그가 지정되어 있지 않은 경우, 줄 끝 기호 이외의 모든 캐릭터와 성냥 됩니다.

정규 표현 그룹과 전방 참조

전방 참조를 실시하는 정규 표현 그룹에는 왼쪽에서 우측향에 왼쪽환괄호를 세는 것에 의해, 번호를 붙일 수 있습니다. 예를 들어, 표현 ((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 Report #18: Unicode Regular Expression Guidelines 에 준거하고 있어, 그 제 2 레벨을 구현하고 있습니다. 다만, 구문이 조금 다릅니다.

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 캐릭터의 카테고리를 나타냅니다. 블록과 카테고리는 캐릭터 클래스의 내부 및 외부의 어느 쪽에도 사용할 수 있습니다.

서포트되고 있는 Unicode 블록과 카테고리는 「The Unicode Standard, Version 3. 0」에 기재되어 있습니다. 블록명은 제 14 장과Unicode Character Database 의 파일 Blocks-3.txt 에 정의되고 있습니다. 다만, 공백은 삭제합니다. 예를 들어,"Basic Latin" 는 "BasicLatin" 가 됩니다. 카테고리명에 대해서는 Unicode 표준 (p. 88)의 표 4 ~ 5 에 규준과 정보가 정의되고 있습니다.

Perl 5 라는 비교

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

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

• 내장하기 코드 구문 (? {코드}) 및 (??{코드})

• 내장하기 코멘트 구문 (? #코멘트)

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

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

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

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

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

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

Perl 와의 큰 차이점

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

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

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

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

정규 표현 구문의 동작의 상세한 것에 대하여는 「Mastering Regular Expressions」 (Jeffrey E. F. Friedl 저, O'Reilly and Associates, 1997 년) 을 참조해 주세요.

도입된 버젼:

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	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 () 이 패턴의 컴파일원의 정규 표현을 돌려줍니다.
String []	split (CharSequence input) 이 패턴의 성냥에 근거해, 지정된 입력 순차 순서를 분할합니다.
String []	split (CharSequence input, int limit) 이 패턴의 성냥에 근거해, 지정된 입력 순차 순서를 분할합니다.

클래스 java.lang. Object 에서 상속받은 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , 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) 를 사용해 유효하게 할 수도 있습니다.

관련 항목:

정수 필드치

DOTALL

public static final int DOTALL

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

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

DOTALL 모드는 내장하기 플래그 표현 (? s) 를 사용해 유효하게 할 수도 있습니다 (s 는 「단일행」모드의 무릎 관절 모닛크에서, 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()

이 패턴의 컴파일원의 정규 표현을 돌려줍니다.

반환값:

이 패턴의 컴파일원

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 - 분할되는 캐릭터 순차 순서

반환값:

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