概要
re
モジュールの関数は、パターンと文字列を直接指定してマッチングなどの操作を行う。
引数の中のflags
については、reモジュールで定義された定数を指定する。複数のflags
を指定する場合は、ビットごとのOR('|'
演算子)を使って組み合わせる。
パターンは実行に先立ってコンパイルされるので、同じパターンを複数回用いる場合には、re.compile()
関数でパターンをコンパイルし、コンパイルされたRegexObject
オブジェクトのメソッドを用いる方がよい。
正規表現のコンパイル
compile()
re.compile(pattern, flags=0)
正規表現パターンを正規表現オブジェクトにコンパイルする。正規表現オブジェクトのメソッド群で、以下のモジュール関数と同等の操作を行うことができる。
以下のモジュール関数を使う場合はflags
を関数ごとに指定するが、正規表現オブジェクトを使う場合は、compile()
関数の引数でflags
を指定する。
パターンの検索
search()
re.search(pattern, string, flags=0)
string
の任意の位置で、最初にpattern
にマッチした時にMatchObject
のオブジェクトを返す。マッチしなければNoneを返す。
|
import re s = r"abcdabcd" print(re.search(r'ab', s)) # <_sre.SRE_Match object; span=(0, 2), match='ab'> print(re.search(r'cd', s)) # <_sre.SRE_Match object; span=(2, 4), match='cd'> print(re.search(r'ef', s)) # None |
match()
re.match(pattern, string, flags=0)
string
の先頭でpattern
にマッチすればMatchObject
のオブジェクトを返す。マッチしなければNoneを返す。string
の途中ではマッチしない。
|
import re s = r"abcdabcd" print(re.match(r'ab', s)) # <_sre.SRE_Match object; span=(0, 2), match='ab'> print(re.match(r'cd', s)) # None |
fullmatch()
re.fullmatch(pattern, string, flags=0)
pattern
がstring
全体にマッチしたときだけMatcObject
のオブジェクトを返し、それ以外はNoneを返す。
|
import re s = r"abcdabcd" print(re.fullmatch(r'abcdabcd', s)) # <_sre.SRE_Match object; span=(0, 8), match='abcdabcd'> print(re.fullmatch(r'abcd', s)) # None print(re.fullmatch(r'.*', s)) # <_sre.SRE_Match object; span=(0, 8), match='abcdabcd'> print(re.fullmatch(r'.{5}', s)) # None |
findall()
re.findall(pattern, string, flags=0)
string
中でpattern
にマッチする全ての部分文字列を要素とするリストを返す。マッチする部分がなければ空のリスト([]
)を返す。先頭からマッチした部分を取り除きながらサーチしていく。
|
import re s = r"abcdabcd" print(re.findall(r'ab', s)) # ['ab', 'ab'] print(re.findall(r'ef', s)) # [] print(re.findall(r'.{3}', s)) # ['abc', 'dab'] |
finditer()
re.finditer(pattern, string, flags=0)
string
中でpattern
にマッチした結果のMatchObject
オブジェクトのイテレータを返す。マッチする部分がなければ空のイテレータを返す。先頭からマッチした部分を取り除きながらサーチしていく。
|
import re s = r"abcdabcd" [print(x) for x in re.finditer(r'ab', s)] # <_sre.SRE_Match object; span=(0, 2), match='ab'> # <_sre.SRE_Match object; span=(4, 6), match='ab'> [print(x) for x in re.finditer(r'ef', s)] # 空のイテレータ [print(x) for x in re.finditer(r'.{3}', s)] # <_sre.SRE_Match object; span=(0, 3), match='abc'> # <_sre.SRE_Match object; span=(3, 6), match='dab'> |
分割
split()
re.split(pattern, string, maxsplit=0, flags=0)
string
をすべてのpattern
にマッチする部分で分割し、それらを要素とするリストを返す。pattern
にマッチする部分は除かれる。マッチする部分がなければ、string
を1つの要素とするリストが返される。
maxsplitに1以上の数nを指定すると、先頭から最大n個の分割が発生し、残りはリストの最後の要素となる。
|
import re s =r"she sells sea shells by the seashore" print(re.split(r' ', s)) # ['she', 'sells', 'sea', 'shells', 'by', 'the', 'seashore'] print(re.split(r'se', s)) # ['she ', 'lls ', 'a shells by the ', 'ashore'] print(re.split(r'xyz', s)) # ['she sells sea shells by the seashore'] print(re.split(r' ', s, maxsplit=3)) # ['she', 'sells', 'sea', 'shells by the seashore'] print(re.split(r' ', s, maxsplit=10)) # ['she', 'sells', 'sea', 'shells', 'by', 'the', 'seashore'] |
pattern
が先頭の部分に一致する場合は、リストの最初は空文字列から始まり、最後の部分に一致する場合はリストの最終要素が空文字列になる。
|
import re s = "abracadabra" print(re.split(r'ab', s)) # ['', 'racad', 'ra'] print(re.split(r'ra', s)) # ['ab', 'cadab', ''] |
空文字列(''
)では分割されない。patternとして空文字1文字を指定するとエラー。
置換
sub()
re.sub(pattern, repl, string, count=0, flags=0)
string
中でpattern
にマッチする部分文字列をrepl
の文字列で置換する。count
で正の整数値を指定すると、先頭から最大その回数だけ置換を行う。
|
import re s = "she sells sea shells by the seashore" print(re.sub(r'sh', "++", s)) # ++e sells sea ++ells by the sea++ore print(re.sub(r'sh', "++", s, count=2)) # ++e sells sea ++ells by the seashore |
空文字列とのマッチは、前のマッチの直後以外に置換される。
|
import re print(re.sub(r'x*', '-', "abcde")) # -a-b-c-d-e- |
replには文字列を返す関数を指定できる。
|
import re def repl_func(matchobj): if matchobj.group(0).isalpha(): return 'A' else: return '0' print(re.sub(r'[A-Z0-9]', repl_func, "TK-80-BS")) # AA-00-AA |
subn()
re.subn(pattern, repl, string, count=0, fkags=0)
sub()と同じ操作を行うが、タプルで(置換後の文字列, 置換数)
を返す。
|
import re s = "she sells sea shells by the seashore" print(re.subn(r'sh', "++", s)) # ('++e sells sea ++ells by the sea++ore', 3) print(re.subn(r'sh', "++", s, count=2)) # ('++e sells sea ++ells by the seashore', 2) |