JavaTM Platform
Standard Ed. 6

java.util.regex
���饹 Matcher

java.lang.Object
  ��̤��ĥ java.util.regex.Matcher
���٤Ƥμ������줿���󥿥ե�����:
MatchResult

public final class Matcher
extends Object
implements MatchResult

Pattern ���᤹�뤳�Ȥˤ�ä�java.lang.CharSequenceʸ�����������Υޥå�����Ԥ����󥸥�Ǥ���  

����ɽ�����󥸥�ϡ��ѥ������ matcher �᥽�åɤ�ƤӽФ����Ȥˤ�äƺ�������ޤ������ٺ�������ȡ����� 3 ����Υޥå����˻��ѤǤ��ޤ���

 

�����Υ᥽�åɤϡ��ޥå��������������ɤ����򼨤� boolean �ͤ��֤��ޤ����ޥå������������Ȥ��ϡ�����ɽ�����󥸥�ξ��֤�Ȳ񤹤�оܺ٤�����Ǥ��ޤ���  

�����������󥸥�ϡ��ΰ�פȸƤФ�����ϤΥ��֥��åȤǥޥå��򸡺����ޤ����ǥե���ȤǤϡ��ΰ�ˤ������������󥸥�����Ϥ��٤Ƥ��ޤޤ�ޤ����ΰ���ѹ��ˤ� region �᥽�åɤ��ΰ�ξȲ�ˤ� regionStart ����� regionEnd �᥽�åɤ���ѤǤ��ޤ����ΰ�ζ����ˤ�����Υѥ������������ˡ���ѹ��Ǥ��ޤ����ܺ٤ˤĤ��Ƥϡ�useAnchoringBounds ����� useTransparentBounds �򻲾Ȥ��Ƥ���������  

���Υ��饹�ˤϡ��ޥå�������ʬ�������󥹤򿷤���ʸ������ִ�����᥽�åɤ�������ޤ��� ������ʸ��������Ƥϡ�ɬ�פ˱����ƥޥå���̤��黻�ФǤ��ޤ���appendReplacement ����� appendTail �᥽�åɤ�Ʊ���˻��Ѥ���С��ޥå���̤�������ƴ�¸��ʸ����Хåե����˳�Ǽ�Ǥ��ޤ��� �ޤ���replaceAll �᥽�åɤ���Ѥ���С����ϥ���������ǥޥå�������ʬ�������󥹤����٤��ִ����줿ʸ���������Ǥ��ޤ���  

����ɽ�����󥸥������Ū�ʾ��֤Ȥ��ơ��Ǹ�����������ޥå��γ��ϥ���ǥå����Ƚ�λ����ǥå���������ޤ����ޤ����ѥ�����γ��������Ȥ�Ԥ�����ɽ�����롼���ˤ�ä��������Ȥ��줿������ʬ�������󥹤γ��ϥ���ǥå����Ƚ�λ����ǥå����䡢�������Ȥ��줿��ʬ�������󥹤����������Ѥ���ޤ����������Ȥ��줿��ʬ�������󥹤�ʸ����������֤��᥽�åɤ��Ѱդ���Ƥ��ޤ���  

����ɽ�����󥸥������Ū�ʾ��֤ν���ͤ��������Ƥ��ޤ��� �ޥå��������������ˤ��ΰ�����Ȳ񤷤褦�Ȥ���ȡ�IllegalStateException ������������ޤ�������ɽ�����󥸥������Ū�ʾ��֤ϡ��ޥå����Τ��Ӥ˷׻���ľ����ޤ���  

����ɽ�����󥸥�ΰ���Ū�ʾ��֤ˤϡ�����ʸ���������󥹤���ɲð��֡פ�����ޤ��� �ɲð��֤ν���ͤϥ����ǡ�appendReplacement �᥽�åɤˤ�äƹ�������ޤ���  

����ɽ�����󥸥��ꥻ�åȤ���ˤϡ�����ɽ�����󥸥�� reset() �᥽�åɤޤ��� reset(CharSequence) �᥽�å� (���������ϥ������󥹤�ɬ�פʾ��) ��ƤӽФ��ޤ�������ɽ�����󥸥��ꥻ�åȤ���ȡ���������Ū�ʾ��֤˴ؤ�������˴����졢�ɲð��֤����������ꤵ��ޤ���  

���Υ��饹�Υ��󥹥��󥹤ϡ�ʣ���Υ���åɤ��¹Ԥ��ƻ��Ѥ��뤳�ȤϤǤ��ޤ���

Ƴ�����줿�С������:
1.4

�᥽�åɤγ���
 Matcher appendReplacement(StringBuffer sb, String replacement)
          ��³�ɲ��ִ�����������ޤ���
 StringBuffer appendTail(StringBuffer sb)
          ��λ�ɲ��ִ�����������ޤ���
 int end()
          �Ǹ�˥ޥå�����ʸ���θ�Υ��ե��åȤ��֤��ޤ���
 int end(int group)
          ����Υޥå����ǻ��ꤵ�줿���롼�פˤ�ä��������Ȥ��줿��ʬ�������󥹤Ρ��ǽ�ʸ���θ�Υ��ե��åȤ��֤��ޤ���
 boolean find()
          ���ϥ������󥹤��餳�Υѥ�����ȥޥå����뼡����ʬ�������󥹤򸡺����ޤ���
 boolean find(int start)
          ��������ɽ�����󥸥��ꥻ�åȤ������ꤵ�줿����ǥå����ʹߤ����ϥ������󥹤��顢���Υѥ�����ȥޥå����뼡����ʬ�������󥹤򸡺����ޤ���
 String group()
          ����Υޥå��ǰ��פ���������ʬ�������󥹤��֤��ޤ���
 String group(int group)
          ����Υޥå����ǻ��ꤵ�줿���롼�פˤ�ä��������Ȥ��줿������ʬ�������󥹤��֤��ޤ���
 int groupCount()
          ��������ɽ�����󥸥�Υѥ�����˻��ꤵ��Ƥ����������Ȥ�Ԥ�����ɽ�����롼�פο����֤��ޤ���
 boolean hasAnchoringBounds()
          ��������ɽ�����󥸥���ΰ趭���Υ��󥫡�������䤤��碌�륯���꡼��Ф��ޤ���
 boolean hasTransparentBounds()
          ��������ɽ�����󥸥���ΰ趭����Ʃ���٤��䤤��碌�륯���꡼��Ф��ޤ���
 boolean hitEnd()
           ���������������󥸥󤬼¹Ԥ����Ǹ�Υޥå����ǡ����Ϥ��������������󥸥�ˤ��ҥåȤ������ˡ�true ���֤��ޤ���
 boolean lookingAt()
          ���ϥ������󥹤ȥѥ�����ȤΥޥå����ΰ����Ƭ����Ϥ�ޤ���
 boolean matches()
          �ΰ����Τ򤳤Υѥ�����ȥޥå����ޤ���
 Pattern pattern()
          ��������ɽ�����󥸥�ˤ�äƲ�ᤵ���ѥ�������֤��ޤ���
static String quoteReplacement(String s)
          ���ꤵ�줿 String �Υ�ƥ���ִ� String ���֤��ޤ���
 Matcher region(int start, int end)
          �����������󥸥���ΰ�����¤����ꤷ�ޤ���
 int regionEnd()
          ���������������󥸥���ΰ�ν�λ����ǥå��� (�����ͤ�ޤޤʤ�) ���ݡ��Ȥ��ޤ���
 int regionStart()
          ���������������󥸥���ΰ�γ��ϥ���ǥå������ݡ��Ȥ��ޤ���
 String replaceAll(String replacement)
          �ѥ�����ȥޥå��������ϥ������󥹤���ʬ�������󥹤򡢻��ꤵ�줿�ִ�ʸ������֤������ޤ���
 String replaceFirst(String replacement)
          �ѥ�����ȥޥå��������ϥ������󥹤���ʬ�������󥹤Τ������ǽ����ʬ�������󥹤���ꤵ�줿�ִ�ʸ������֤������ޤ���
 boolean requireEnd()
           ���¿�������Ϥ����Υޥå�����Υޥå����ѹ�������ǽ����������ˡ�true ���֤��ޤ���
 Matcher reset()
          ��������ɽ�����󥸥��ꥻ�åȤ��ޤ���
 Matcher reset(CharSequence input)
          ���������ϥ������󥹤���Ѥ��Ƥ�������ɽ�����󥸥��ꥻ�åȤ��ޤ���
 int start()
          ����Υޥå��γ��ϥ���ǥå������֤��ޤ���
 int start(int group)
          ����Υޥå����ǻ��ꤵ�줿���롼�פˤ�ä��������Ȥ��줿��ʬ�������󥹤Ρ����ϥ���ǥå������֤��ޤ���
 MatchResult toMatchResult()
          ��������ɽ�����󥸥�Υޥå����֤� MatchResult �Ȥ����֤��ޤ���
 String toString()
           ��������ɽ�����󥸥��ʸ����ɽ�����֤��ޤ���
 Matcher useAnchoringBounds(boolean b)
          ��������ɽ�����󥸥���ΰ趭���Υ��󥫡������ꤷ�ޤ���
 Matcher usePattern(Pattern newPattern)
          ���� Matcher ���ޥå������˻��Ѥ��� Pattern ���ѹ����ޤ���
 Matcher useTransparentBounds(boolean b)
          ��������ɽ�����󥸥���ΰ趭����Ʃ���٤����ꤷ�ޤ���
 
���饹 java.lang.Object ����Ѿ����줿�᥽�å�
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

�᥽�åɤξܺ�

pattern

public Pattern pattern()
��������ɽ�����󥸥�ˤ�äƲ�ᤵ���ѥ�������֤��ޤ���

�����:
��������ɽ�����󥸥�κ����оݤȤʤä��ѥ�����

toMatchResult

public MatchResult toMatchResult()
��������ɽ�����󥸥�Υޥå����֤� MatchResult �Ȥ����֤��ޤ�����̤ϡ����������������󥸥���Ф����³�����αƶ�������ޤ���

�����:
���������������󥸥�ξ��֤��ݻ����� MatchResult
Ƴ�����줿�С������:
1.5

usePattern

public Matcher usePattern(Pattern newPattern)
���� Matcher ���ޥå������˻��Ѥ��� Pattern ���ѹ����ޤ���  

���Υ᥽�åɤ���Ѥ���ȡ��Ǹ��ȯ�������ޥå��Υ��롼�פ˴ؤ�����󤬤�������ɽ�����󥸥󤫤鼺���ޤ��������������ɽ�����󥸥�ΰ��֤ϰݻ����졢�Ǹ���ɲð��֤ϱƶ�������ޤ���

�ѥ�᡼��:
newPattern - ��������ɽ�����󥸥󤬻��Ѥ��뿷���ѥ�����
�����:
��������ɽ�����󥸥�
�㳰:
IllegalArgumentException - newPattern �� null ��
Ƴ�����줿�С������:
1.5

reset

public Matcher reset()
��������ɽ�����󥸥��ꥻ�åȤ��ޤ���  

�����������󥸥��ꥻ�åȤ���ȡ�����Ū�ʾ��־��󤹤٤Ƥ��˴����졢�ɲð��֤����������ꤵ��ޤ��������������󥸥���ΰ�ϡ��ǥե���ȤǤ���ʸ�������������Τ����ꤵ��ޤ�����������ɽ�����󥸥���ΰ趭���Υ��󥫡������Ʃ���٤ϱƶ�������ޤ���

�����:
��������ɽ�����󥸥�

reset

public Matcher reset(CharSequence input)
���������ϥ������󥹤���Ѥ��Ƥ�������ɽ�����󥸥��ꥻ�åȤ��ޤ���  

�����������󥸥��ꥻ�åȤ���ȡ�����Ū�ʾ��־��󤹤٤Ƥ��˴����졢�ɲð��֤����������ꤵ��ޤ��������������󥸥���ΰ�ϡ��ǥե���ȤǤ���ʸ�������������Τ����ꤵ��ޤ�����������ɽ�����󥸥���ΰ趭���Υ��󥫡������Ʃ���٤ϱƶ�������ޤ���

�ѥ�᡼��:
input - ����������ʸ����������
�����:
��������ɽ�����󥸥�

start

public int start()
����Υޥå��γ��ϥ���ǥå������֤��ޤ���

���:
���󥿥ե����� MatchResult ��� start
�����:
�ޥå������ǽ��ʸ���Υ���ǥå���
�㳰:
IllegalStateException - �ޥå����ޤ���ߤ��Ƥ��ʤ���硢�ޤ�������Υޥå������Ԥ������

start

public int start(int group)
����Υޥå����ǻ��ꤵ�줿���롼�פˤ�ä��������Ȥ��줿��ʬ�������󥹤Ρ����ϥ���ǥå������֤��ޤ���  

�������Ȥ�Ԥ�����ɽ�����롼���ˤϡ������鱦������ 1 ���饤��ǥå������դ��ޤ������롼�� 0 �ϥѥ��������Τ�ɽ���ޤ��� �Ĥޤꡢm.start(0) �� m.start() ��Ʊ��ɽ���Ǥ���

���:
���󥿥ե����� MatchResult ��� start
�ѥ�᡼��:
group - ��������ɽ�����󥸥�Υѥ�����˻��ꤵ��Ƥ����������Ȥ�Ԥ�����ɽ�����롼�פΥ���ǥå���
�����:
���롼�פˤ�ä��������Ȥ��줿�ǽ��ʸ���Υ���ǥå������ޥå����������������롼�׼��ΤϤɤ���ʬ�ˤ�ޥå����ʤ��ä����� -1
�㳰:
IllegalStateException - �ޥå����ޤ���ߤ��Ƥ��ʤ���硢�ޤ�������Υޥå������Ԥ������
IndexOutOfBoundsException - ���ꤵ�줿����ǥå���������������Ȥ�Ԥ�����ɽ�����롼�פ����Υѥ�����˴ޤޤ�ʤ����

end

public int end()
�Ǹ�˥ޥå�����ʸ���θ�Υ��ե��åȤ��֤��ޤ���

���:
���󥿥ե����� MatchResult ��� end
�����:
�Ǹ�˥ޥå�����ʸ���θ�Υ��ե��å�
�㳰:
IllegalStateException - �ޥå����ޤ���ߤ��Ƥ��ʤ���硢�ޤ�������Υޥå������Ԥ������

end

public int end(int group)
����Υޥå����ǻ��ꤵ�줿���롼�פˤ�ä��������Ȥ��줿��ʬ�������󥹤Ρ��ǽ�ʸ���θ�Υ��ե��åȤ��֤��ޤ���  

�������Ȥ�Ԥ�����ɽ�����롼���ˤϡ������鱦������ 1 ���饤��ǥå������դ��ޤ������롼�� 0 �ϥѥ��������Τ�ɽ���ޤ��� �Ĥޤꡢm.end(0) �� m.end() ��Ʊ��ɽ���Ǥ���

���:
���󥿥ե����� MatchResult ��� end
�ѥ�᡼��:
group - ��������ɽ�����󥸥�Υѥ�����˻��ꤵ��Ƥ����������Ȥ�Ԥ�����ɽ�����롼�פΥ���ǥå���
�����:
���롼�פˤ�ä��������Ȥ��줿�Ǹ��ʸ���θ�Υ��ե��åȡ��ޥå����������������롼�׼��ΤϤɤ���ʬ�ˤ�ޥå����ʤ��ä����� -1
�㳰:
IllegalStateException - �ޥå����ޤ���ߤ��Ƥ��ʤ���硢�ޤ�������Υޥå������Ԥ������
IndexOutOfBoundsException - ���ꤵ�줿����ǥå���������������Ȥ�Ԥ�����ɽ�����롼�פ����Υѥ�����˴ޤޤ�ʤ����

group

public String group()
����Υޥå��ǰ��פ���������ʬ�������󥹤��֤��ޤ���  

����ɽ�����󥸥� m �����ϥ������� s �����ꤵ��Ƥ����硢m.group() �� s.substring(m.start(), m.end()) ��Ʊ��ɽ���ˤʤ�ޤ���

 

�ѥ����� (a* �ʤ�) �ˤ�äƤϡ�����ʸ����ȥޥå����뤳�Ȥ�����ޤ��������Υѥ��������ϥ���������ζ���ʸ����ȥޥå�������硢����ʸ�����֤���ޤ���

���:
���󥿥ե����� MatchResult ��� group
�����:
����Υޥå��ǰ��פ�����ʬ�������� (���ξ��⤢��)��ʸ�������
�㳰:
IllegalStateException - �ޥå����ޤ���ߤ��Ƥ��ʤ���硢�ޤ�������Υޥå������Ԥ������

group

public String group(int group)
����Υޥå����ǻ��ꤵ�줿���롼�פˤ�ä��������Ȥ��줿������ʬ�������󥹤��֤��ޤ���  

����ɽ�����󥸥� m�����ϥ������� s������ӥ��롼�ץ���ǥå��� g �����ꤵ��Ƥ����硢m.group(g) �� s.substring(m.start(g), m.end(g)) ��Ʊ��ɽ���ˤʤ�ޤ���

 

�������Ȥ�Ԥ�����ɽ�����롼���ˤϡ������鱦������ 1 ���饤��ǥå������դ��ޤ������롼�� 0 �ϥѥ��������Τ�ɽ���ޤ��� �Ĥޤꡢm.group(0) �� m.group() ��Ʊ��ɽ���Ǥ���

 

�ޥå������ェλ�����������ꤵ�줿���롼�פ����ϥ������󥹤˸��Ф���ʤ��ä���硢null ���֤���ޤ����ѥ����� ((a*) �ʤ�) �ˤ�äƤϡ�����ʸ����ȥޥå����뤳�Ȥ�����ޤ��������Υ��롼�פ����ϥ���������ζ���ʸ����ȥޥå�������硢����ʸ�����֤���ޤ���

���:
���󥿥ե����� MatchResult ��� group
�ѥ�᡼��:
group - ��������ɽ�����󥸥�Υѥ�����˻��ꤵ��Ƥ����������Ȥ�Ԥ�����ɽ�����롼�פΥ���ǥå���
�����:
����Υޥå����˥��롼�פˤ�ä��������Ȥ��줿��ʬ�������� (���ξ��⤢��)�����롼�פ����Ϥΰ����ؤΥޥå��˼��Ԥ������� null
�㳰:
IllegalStateException - �ޥå����ޤ���ߤ��Ƥ��ʤ���硢�ޤ�������Υޥå������Ԥ������
IndexOutOfBoundsException - ���ꤵ�줿����ǥå���������������Ȥ�Ԥ�����ɽ�����롼�פ����Υѥ�����˴ޤޤ�ʤ����

groupCount

public int groupCount()
��������ɽ�����󥸥�Υѥ�����˻��ꤵ��Ƥ����������Ȥ�Ԥ�����ɽ�����롼�פο����֤��ޤ���  

���롼�� 0 �ϥѥ��������Τ�ɽ���ޤ������롼�� 0 �ϡ����Υ�����Ȥ˴ޤޤ�ޤ���  

���롼�ץ���ǥå��������Υ᥽�åɤ����֤��줿�Ͱʲ������������Ǥ�����ϡ���������ɽ�����󥸥��ͭ���Ǥ���

���:
���󥿥ե����� MatchResult ��� groupCount
�����:
��������ɽ�����󥸥�Υѥ�����˻��ꤵ��Ƥ����������Ȥ�Ԥ�����ɽ�����롼�פο�

matches

public boolean matches()
�ΰ����Τ򤳤Υѥ�����ȥޥå����ޤ���  

�ޥå��������������ϡ�start��end������� group �᥽�åɤ���Ѥ��ƾܺپ��������Ǥ��ޤ���

�����:
�ΰ襷�����󥹤����Τ���������ɽ�����󥸥�Υѥ�����ȥޥå��������ˤΤ� true

find

public boolean find()
���ϥ������󥹤��餳�Υѥ�����ȥޥå����뼡����ʬ�������󥹤򸡺����ޤ���  

���Υ᥽�åɤϡ������������󥸥���ΰ����Ƭ���鳫�Ϥ���ޤ��� ������������θƤӽФ�������˽�λ���Ƥ�������ɽ�����󥸥󤬥ꥻ�åȤ���Ƥ��ʤ����ϡ�����Υޥå��ǰ��פ��ʤ��ä��ǽ��ʸ�����鳫�Ϥ���ޤ���  

�ޥå��������������ϡ�start��end������� group �᥽�åɤ���Ѥ��ƾܺپ��������Ǥ��ޤ���

�����:
���ϥ������󥹤���ʬ�������󥹤���������ɽ�����󥸥�Υѥ�����ȥޥå��������ˤΤ� true

find

public boolean find(int start)
��������ɽ�����󥸥��ꥻ�åȤ������ꤵ�줿����ǥå����ʹߤ����ϥ������󥹤��顢���Υѥ�����ȥޥå����뼡����ʬ�������󥹤򸡺����ޤ���  

�ޥå��������������ϡ�start��end������� group �᥽�åɤ���Ѥ��ƾܺپ��������Ǥ��ޤ��� ��³�� find() �᥽�åɸƤӽФ��Ǥϡ����Υޥå��ǰ��פ��ʤ��ä��ǽ��ʸ�����鳫�Ϥ���ޤ���

�����:
���ϥ������󥹤λ��ꤵ�줿����ǥå����ʹߤ���ʬ�������󥹤�����������ɽ�����󥸥�Υѥ�����ȥޥå��������ˤΤ� true
�㳰:
IndexOutOfBoundsException - start ��������꾮������硢�ޤ��� start �����ϥ������󥹤�Ĺ������礭�����

lookingAt

public boolean lookingAt()
���ϥ������󥹤ȥѥ�����ȤΥޥå����ΰ����Ƭ����Ϥ�ޤ���  

matches �᥽�åɤ�Ʊ�ͤˡ��ΰ����Ƭ���鳫�Ϥ���ޤ��� ���������ΰ����Τ��ޥå�����ɬ�פϤ���ޤ���  

�ޥå��������������ϡ�start��end������� group �᥽�åɤ���Ѥ��ƾܺپ��������Ǥ��ޤ���

�����:
���ϥ������󥹤���Ƭ������������ɽ�����󥸥�Υѥ�����ȥޥå��������ˤΤ� true

quoteReplacement

public static String quoteReplacement(String s)
���ꤵ�줿 String �Υ�ƥ���ִ� String ���֤��ޤ��� ���Υ᥽�åɤϡ�Matcher ���饹�� appendReplacement �᥽�å���Υ�ƥ���ִ� s �Ȥ��Ƶ�ǽ���� String ���������ޤ������������ String �ϡ���ƥ�륷�����󥹤Ȥ��ƽ�������� s ���ʸ���������󥹤˥ޥå����ޤ�������å��� ('\') ����ӥɥ뵭�� ('$') �ˤ����̤ʰ�̣�Ϥ���ޤ���

�ѥ�᡼��:
s - ��ƥ�벽����ʸ����
�����:
��ƥ��ʸ�����ִ�
Ƴ�����줿�С������:
1.5

appendReplacement

public Matcher appendReplacement(StringBuffer sb,
                                 String replacement)
��³�ɲ��ִ�����������ޤ���  

���Υ᥽�åɤϡ����ν�����¹Ԥ��ޤ���

  1. �ɲð��ְʹߤ����ϥ������󥹤���ʸ������ɤ߹��ߡ����ꤵ�줿ʸ����Хåե������ɲä��롣����ޥå�����ʸ����ľ����ʸ�����Ĥޤꥤ��ǥå��� start() - 1 ��ʸ�����ɤ߹�����Ȥ��˽�λ����

  2. ���ꤵ�줿�ִ�ʸ�����ʸ����Хåե������ɲä���

  3. ��������ɽ�����󥸥���ɲð��֤򡢺Ǹ�˥ޥå�����ʸ���Υ���ǥå����� 1 ��ä����͡��Ĥޤ� end() �����ꤹ��

 

�ִ�ʸ����ˤϡ�����Υޥå������������Ȥ��줿��ʬ�������󥹤ؤλ��Ȥ��ޤޤ���礬����ޤ���$g �����Ф����ȡ�group(g) ��ɾ��������̤ˤ��٤��ִ�����ޤ���$ �θ�κǽ�ο��ͤϡ���˥��롼�׻��Ȥΰ����Ȥ��ƽ�������ޤ�����³�ο��ͤ������ʥ��롼�׻��Ȥ��������硢������ g ���Ȥ߹��ޤ�ޤ����� 0 �� 9 �����������롼�׻��Ȥ�����Ū�ʥ���ݡ��ͥ�Ȥȸ��ʤ���ޤ������Ȥ��С�2 ���ܤΥ��롼�פ�ʸ���� "foo" �˥ޥå�����ȡ��ִ�ʸ���� "$2bar" �ΰ����Ϥ����Ԥ��ơ�"foobar" ��ʸ����Хåե������ɲä���ޤ������˥Хå�����å��� (\$) ���դ��뤳�Ȥǡ��ɥ뵭�� ($) ���ƥ��Ȥ����ִ�ʸ����˴ޤ�뤳�Ȥ��Ǥ��ޤ���  

�ִ�ʸ������ǥХå�����å��� (\) �ȥɥ뵭�� ($) ����Ѥ���ȡ�������ƥ���ִ�ʸ����Ȥ��ƽ����������ȤϷ�̤��ۤʤ��礬����ޤ����ɥ뵭��ϡ�������������Ȥ��ꡢ�������Ȥ��줿��ʬ�������󥹤ؤλ��ȤȤ��ƽ���������礬���ꡢ�Хå�����å�����ִ�ʸ������Υ�ƥ��ʸ���򥨥������פ���Τ˻��Ѥ���ޤ���  

���Υ᥽�åɤϡ��롼����� appendTail �᥽�åɤ���� find �᥽�åɤ��Ȥ߹�碌�ƻ��Ѥ��ޤ������Ȥ��С����Υ����ɤǤϡ�one dog two dogs in the yard ��ɸ����ϥ��ȥ꡼��˽񤭽Ф��ޤ���

 Pattern p = Pattern.compile("cat");
 Matcher m = p.matcher("one cat two cats in the yard");
 StringBuffer sb = new StringBuffer();
 while (m.find()) {
     m.appendReplacement(sb, "dog");
 }
 m.appendTail(sb);
 System.out.println(sb.toString());

�ѥ�᡼��:
sb - �������å�ʸ����Хåե���
replacement - �ִ�ʸ����
�����:
��������ɽ�����󥸥�
�㳰:
IllegalStateException - �ޥå����ޤ���ߤ��Ƥ��ʤ���硢�ޤ�������Υޥå������Ԥ������
IndexOutOfBoundsException - �ִ�ʸ���󤬻��Ȥ��Ƥ����������Ȥ�Ԥ�����ɽ�����롼�פ����ѥ��������¸�ߤ��ʤ����

appendTail

public StringBuffer appendTail(StringBuffer sb)
��λ�ɲ��ִ�����������ޤ���  

���Υ᥽�åɤϡ��ɲð��ְʹߤ����ϥ������󥹤���ʸ������ɤ߹��ߡ����ꤵ�줿ʸ����Хåե������ɲä��ޤ������ϥ������󥹤λĤ����ʬ�򥳥ԡ����뤿��ˡ�appendReplacement �᥽�åɤ� 1 ��ʾ�ƤӽФ��Ƥ��餳�Υ᥽�åɤ�ƤӽФ��ޤ���

�ѥ�᡼��:
sb - �������å�ʸ����Хåե���
�����:
�������å�ʸ����Хåե���

replaceAll

public String replaceAll(String replacement)
�ѥ�����ȥޥå��������ϥ������󥹤���ʬ�������󥹤򡢻��ꤵ�줿�ִ�ʸ������֤������ޤ���  

���Υ᥽�åɤϤޤ�����������ɽ�����󥸥��ꥻ�åȤ��ޤ������ˡ����ϥ������󥹤��������ơ��ѥ�����ȥޥå�����ʸ����򸡺����ޤ����ѥ�����ȥޥå����ʤ�ʸ����ϡ����ʸ�����ľ���ɲä���ޤ��� �ѥ�����ȥޥå�����ʸ����ϡ��ִ�ʸ������ִ�����Ʒ�̤��ɲä���ޤ���appendReplacement �᥽�åɤ�Ʊ�ͤˡ��������Ȥ��줿��ʬ�������󥹤ؤλ��Ȥ��ִ�ʸ����˴ޤޤ���礬����ޤ���  

�ִ�ʸ������ǥХå�����å��� (\) �ȥɥ뵭�� ($) ����Ѥ���ȡ�������ƥ���ִ�ʸ����Ȥ��ƽ����������ȤϷ�̤��ۤʤ��礬����ޤ����ɥ뵭��ϡ�������������Ȥ��ꡢ�������Ȥ��줿��ʬ�������󥹤ؤλ��ȤȤ��ƽ���������礬���ꡢ�Хå�����å�����ִ�ʸ������Υ�ƥ��ʸ���򥨥������פ���Τ˻��Ѥ���ޤ���  

����ɽ�� a*b������ "aabfooaabfooabfoob"��������ִ�ʸ���� "-" ����ꤷ����硢����ɽ��������ɽ�����󥸥��Ǥ��Υ᥽�åɤ�ƤӽФ��ȡ�ʸ���� "-foo-foo-foo-" ����������ޤ���  

���Υ᥽�åɤ�ƤӽФ��ȡ���������ɽ�����󥸥�ξ��֤��Ѥ��ޤ�����������ɽ�����󥸥���³�Υޥå����ǻ��Ѥ�����ϡ��ǽ������ɽ�����󥸥��ꥻ�åȤ���ɬ�פ�����ޤ���

�ѥ�᡼��:
replacement - �ִ�ʸ����
�����:
�ޥå��������٤Ƥ���ʬ�������󥹤��ִ�ʸ������֤��������������Ȥ��줿��ʬ�������󥹤�ɬ�פ˱������ִ����뤳�Ȥˤ�äƹ��ۤ��줿ʸ����

replaceFirst

public String replaceFirst(String replacement)
�ѥ�����ȥޥå��������ϥ������󥹤���ʬ�������󥹤Τ������ǽ����ʬ�������󥹤���ꤵ�줿�ִ�ʸ������֤������ޤ���  

���Υ᥽�åɤϤޤ�����������ɽ�����󥸥��ꥻ�åȤ��ޤ������ˡ����ϥ������󥹤��������ơ��ѥ�����ȥޥå�����ǽ��ʸ����򸡺����ޤ����ѥ�����ȥޥå����ʤ�ʸ����ϡ����ʸ�����ľ���ɲä���ޤ��� �ѥ�����ȥޥå�����ʸ����ϡ��ִ�ʸ������ִ�����Ʒ�̤��ɲä���ޤ���appendReplacement �᥽�åɤ�Ʊ�ͤˡ��������Ȥ��줿��ʬ�������󥹤ؤλ��Ȥ��ִ�ʸ����˴ޤޤ���礬����ޤ���  

�ִ�ʸ������ǥХå�����å��� (\) �ȥɥ뵭�� ($) ����Ѥ���ȡ�������ƥ���ִ�ʸ����Ȥ��ƽ����������ȤϷ�̤��ۤʤ��礬����ޤ����ɥ뵭��ϡ�������������Ȥ��ꡢ�������Ȥ��줿��ʬ�������󥹤ؤλ��ȤȤ��ƽ���������礬���ꡢ�Хå�����å�����ִ�ʸ������Υ�ƥ��ʸ���򥨥������פ���Τ˻��Ѥ���ޤ���  

����ɽ�� dog������ "zzzdogzzzdogzzz"��������ִ�ʸ���� "cat" ����ꤷ����硢����ɽ��������ɽ�����󥸥��Ǥ��Υ᥽�åɤ�ƤӽФ��ȡ�ʸ���� "zzzcatzzzdogzzz" ����������ޤ���

 

���Υ᥽�åɤ�ƤӽФ��ȡ���������ɽ�����󥸥�ξ��֤��Ѥ��ޤ�����������ɽ�����󥸥���³�Υޥå����ǻ��Ѥ�����ϡ��ǽ������ɽ�����󥸥��ꥻ�åȤ���ɬ�פ�����ޤ���

�ѥ�᡼��:
replacement - �ִ�ʸ����
�����:
�ǽ�˥ޥå�������ʬ�������󥹤��ִ�ʸ������֤��������������Ȥ��줿��ʬ�������󥹤�ɬ�פ˱������ִ����뤳�Ȥˤ�äƹ��ۤ��줿ʸ����

region

public Matcher region(int start,
                      int end)
�����������󥸥���ΰ�����¤����ꤷ�ޤ����ΰ�ϡ��ޥå��θ����оݤȤʤ����ϥ������󥹤ΰ����Ǥ������Υ᥽�åɤ�ƤӽФ��ȡ������������󥸥󤬥ꥻ�åȤ��졢�ΰ����Ƭ�� start �ѥ�᡼���ˤ����ꤵ�줿����ǥå����ˡ��ΰ�������� end �ѥ�᡼���ˤ����ꤵ�줿����ǥå����ˤ��줾�����ꤵ��ޤ���  

���Ѥ����Ʃ���٤ȥ��󥫡�����ˤ�äƤ� (useTransparentBounds ����� useAnchoringBounds �򻲾�)�����󥫡��ʤɤ�����κ�����ο����񤤤��ΰ�ζ����ޤ��Ϥ����ն�ǰۤʤ��礬����ޤ���

�ѥ�᡼��:
start - �����򳫻Ϥ�����֤Υ���ǥå��� (�����ͤ�ޤ�)
end - ������λ������֤Υ���ǥå��� (�����ͤ�ޤޤʤ�)
�����:
��������ɽ�����󥸥�
�㳰:
IndexOutOfBoundsException - start �ޤ��� end ��������꾮������硢start �����ϥ������󥹤�Ĺ������礭����硢end �����ϥ������󥹤�Ĺ������礭����硢�ޤ��� start �� end ����礭�����
Ƴ�����줿�С������:
1.5

regionStart

public int regionStart()
���������������󥸥���ΰ�γ��ϥ���ǥå������ݡ��Ȥ��ޤ������������������󥸥󤬹Ԥ������ϡ�regionStart (�����ͤ�ޤ�) �� regionEnd (�����ͤ�ޤޤʤ�) �������ǤΥޥå����������¤���ޤ���

�����:
���������������󥸥���ΰ�λ���
Ƴ�����줿�С������:
1.5

regionEnd

public int regionEnd()
���������������󥸥���ΰ�ν�λ����ǥå��� (�����ͤ�ޤޤʤ�) ���ݡ��Ȥ��ޤ������������������󥸥󤬹Ԥ������ϡ�regionStart (�����ͤ�ޤ�) �� regionEnd (�����ͤ�ޤޤʤ�) �������ǤΥޥå����������¤���ޤ���

�����:
��������ɽ�����󥸥���ΰ�ν���
Ƴ�����줿�С������:
1.5

hasTransparentBounds

public boolean hasTransparentBounds()
��������ɽ�����󥸥���ΰ趭����Ʃ���٤��䤤��碌�륯���꡼��Ф��ޤ���  

���Υ᥽�åɤϡ�transparent ��������������ɽ�����󥸥�ǻ��Ѥ������� true ���֤���opaque ���������Ѥ������ˤ� false ���֤��ޤ���  

Ʃ���ޤ�����Ʃ���ζ����ξܺ٤ˤĤ��Ƥϡ�useTransparentBounds �򻲾Ȥ��Ƥ���������  

�ǥե���ȤǤϡ�����ɽ�����󥸥����Ʃ�����ΰ趭������Ѥ��ޤ���

�����:
��������ɽ�����󥸥�Ʃ���ʶ�������Ѥ������ true�������Ǥʤ����� false
Ƴ�����줿�С������:
1.5
��Ϣ����:
useTransparentBounds(boolean)

useTransparentBounds

public Matcher useTransparentBounds(boolean b)
��������ɽ�����󥸥���ΰ趭����Ʃ���٤����ꤷ�ޤ���  

���Υ᥽�åɤ� true �ΰ�������ꤷ�ƸƤӽФ��ȡ�transparent ��������������ɽ�����󥸥�ǻ��Ѥ���ޤ���boolean ������ false �ξ��ϡ�opaque ���������Ѥ���ޤ���  

Ʃ���ʶ�������Ѥ����硢��������ɽ�����󥸥���ΰ�ϡ�����������������Ӷ����Υޥå��󥰺�����Ʃ���ˤʤ�ޤ��������κ����ϡ��ޥå���Ŭ�ڤ��ɤ������ΰ�ζ�����Ķ���Ƹ��뤳�Ȥ��Ǥ��ޤ���  

��Ʃ���ʶ�������Ѥ���ȡ���������ɽ�����󥸥�ζ����ϡ�����������������Ӷ�����Ķ���Ƹ������ߤ�ޥå��󥰺�������Ʃ���Ȥʤ�ޤ��������κ����Ǥ϶���������ˤ����ΤܤäƸ����Ǥ��ʤ����ᡢ�ΰ賰�ǤϤ����ʤ�ޥå��󥰤⼺�Ԥ��ޤ���  

�ǥե���ȤǤϡ�����ɽ�����󥸥����Ʃ���ζ�������Ѥ��ޤ���

�ѥ�᡼��:
b - ��Ʃ���ޤ���Ʃ�����ΰ�Τɤ������Ѥ��뤫�򼨤� boolean
�����:
��������ɽ�����󥸥�
Ƴ�����줿�С������:
1.5
��Ϣ����:
hasTransparentBounds()

hasAnchoringBounds

public boolean hasAnchoringBounds()
��������ɽ�����󥸥���ΰ趭���Υ��󥫡�������䤤��碌�륯���꡼��Ф��ޤ���  

���Υ᥽�åɤϡ�anchoring ��������������ɽ�����󥸥�ǻ��Ѥ������� true ���֤��������Ǥʤ����� false ���֤��ޤ���  

���󥫡����궭���ξܺ٤ˤĤ��Ƥϡ� useTransparentBounds �򻲾Ȥ��Ƥ���������  

�ǥե���ȤǤϡ�����ɽ�����󥸥�ϥ��󥫡������ΰ趭������Ѥ��ޤ���

�����:
��������ɽ�����󥸥󤬥��󥫡����궭������Ѥ������ true�������Ǥʤ����� false
Ƴ�����줿�С������:
1.5
��Ϣ����:
useAnchoringBounds(boolean)

useAnchoringBounds

public Matcher useAnchoringBounds(boolean b)
��������ɽ�����󥸥���ΰ趭���Υ��󥫡������ꤷ�ޤ���  

���Υ᥽�åɤ� true �ΰ�������ꤷ�ƸƤӽФ��ȡ�anchoring ��������������ɽ�����󥸥�ǻ��Ѥ���ޤ���boolean ������ false �ξ��ϡ�non-anchoring ���������Ѥ���ޤ���  

���󥫡����궭�������Ѥ����ȡ���������ɽ�����󥸥���ΰ�ζ����ϡ� ^ ����� $ �ʤɤΥ��󥫡��˥ޥå����ޤ���  

���󥫡����궭�������Ѥ���ʤ����ϡ���������ɽ�����󥸥���ΰ�ζ����ϡ� ^ ����� $ �ʤɤΥ��󥫡��˥ޥå����ޤ���  

�ǥե���ȤǤϡ�����ɽ�����󥸥�ϥ��󥫡������ΰ趭������Ѥ��ޤ���

�ѥ�᡼��:
b - ���󥫡����궭������Ѥ��뤫�ɤ����򼨤� boolean
�����:
��������ɽ�����󥸥�
Ƴ�����줿�С������:
1.5
��Ϣ����:
hasAnchoringBounds()

toString

public String toString()
 

��������ɽ�����󥸥��ʸ����ɽ�����֤��ޤ���Matcher ��ʸ����ɽ���ˤϡ��ǥХå���ͭ�Ѥʾ��󤬴ޤޤ�ޤ�����̩�ʽ񼰤ϻ��ꤵ��ޤ���

�����С��饤��:
���饹 Object ��� toString
�����:
���������������󥸥��ʸ����ɽ��
Ƴ�����줿�С������:
1.5

hitEnd

public boolean hitEnd()
 

���������������󥸥󤬼¹Ԥ����Ǹ�Υޥå����ǡ����Ϥ��������������󥸥�ˤ��ҥåȤ������ˡ�true ���֤��ޤ���  

���Υ᥽�åɤ� true ���֤���硢���Ϥ������¿����С��Ǹ�θ����η�̤��ѹ����줿��ǽ��������ޤ���

�����:
���Ϥ��������Ǹ�Υޥå��ǥҥåȤ������� true�������Ǥʤ����� false
Ƴ�����줿�С������:
1.5

requireEnd

public boolean requireEnd()
 

���¿�������Ϥ����Υޥå�����Υޥå����ѹ�������ǽ����������ˡ�true ���֤��ޤ���  

���Υ᥽�åɤ� true ���֤������ĥޥå������Ф��줿��硢���¿�������Ϥ�����Хޥå�������줿��ǽ��������ޤ������Υ᥽�åɤ� false ���֤������ĥޥå������Ф��줿��硢���¿�������Ϥ�����Хޥå����ѹ�����뤬�������뤳�ȤϤʤ��ä���ǽ��������ޤ����ޥå������Ф���ʤ��ä���硢requireEnd �˰�̣�Ϥ���ޤ���

�����:
���¿�������Ϥ����Υޥå�����Υޥå����ѹ�������ǽ����������� true
Ƴ�����줿�С������:
1.5

JavaTM Platform
Standard Ed. 6

�Х������ȵ�ǽ�Υꥯ������
����˾ܤ��� API ��ե���󥹤���ӳ�ȯ�ԥɥ�����ȤˤĤ��Ƥϡ�Java SE ��ȯ���ѥɥ�������򻲾Ȥ��Ƥ�����������ȯ�Ը����ξܺ٤ʲ��⡢��ǰ�γ��ס��Ѹ��������Х��β����������ӥ����ɼ��㤬�ޤޤ�Ƥ��ޤ���

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy �⻲�Ȥ��Ƥ���������