string

問題を報告する ソースを表示 ナイトリー · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

文字列をサポートする言語組み込み型。文字列リテラルの例:

a = 'abc\ndef'
b = "ab'cd"
c = """multiline string"""

# Strings support slicing (negative index starts from the end):
x = "hello"[2:4]  # "ll"
y = "hello"[1:-1]  # "ell"
z = "hello"[:4]  # "hell"# Slice steps can be used, too:
s = "hello"[::2] # "hlo"
t = "hello"[3:0:-1] # "lle"
文字列は直接反復処理できないため、.elems() メソッドを使用して文字列を反復処理します。例:
"bc" in "abcd"   # evaluates to True
x = [c for c in "abc".elems()]  # x == ["a", "b", "c"]
 文字列の暗黙的な連結は許可されていません。代わりに + 演算子を使用してください。比較演算子は辞書順の比較を実行します。等価性をテストするには == を使用します。

メンバー

大文字

string string.capitalize()

文字列のコピーを返します。先頭の文字（存在する場合）は大文字で、残りの文字は小文字になります。このメソッドでは ASCII 以外の文字はサポートされていません。

count

int string.count(sub, start=0, end=None)

文字列内の部分文字列 sub の（重複しない）出現回数を返します。必要に応じて、[start:end] に制限できます。start は含め、end は含めません。

パラメータ

パラメータ 説明
sub required
カウントする部分文字列。
start int、または None。デフォルトは 0。
この位置からの検索に制限します。
end 整数、または None。デフォルトは None。
検索を制限する位置（省略可）。

要素

sequence string.elems()

文字列の連続する 1 要素の部分文字列を含むイテラブルな値を返します。[s[i] for i in range(len(s))] と同等ですが、戻り値がリストではない可能性があります。

endswith

bool string.endswith(sub, start=0, end=None)

文字列が sub で終わる場合は True を返します。それ以外の場合は False を返します。必要に応じて、[start:end] に制限します。start は包含、end は含みません。

パラメータ

パラメータ 説明
sub string: または string のタプル。 必須
照合する接尾辞（または代替接尾辞のタプル）。
start int、または None。デフォルトは 0
。この位置からテストを開始します。
end int、または None。デフォルトは None。
比較を停止する位置（省略可）。

見つける

int string.find(sub, start=0, end=None)

sub が見つかった最初のインデックスを返します。そのようなインデックスが存在しない場合は -1 を返します。必要に応じて、[start:end] に制限できます。start はインデックスを含む範囲で、end はインデックスを除く範囲です。

パラメータ

パラメータ 説明
sub 必須
検索する部分文字列。
start int、または None。デフォルトは 0。
この位置からの検索に制限します。
end 整数、または None。デフォルトは None。
検索を制限する位置（省略可）。

形式

string string.format(*args, **kwargs)

文字列の補間を行います。書式文字列には、中かっこ {} で囲まれた置換フィールドが含まれています。中かっこに含まれないものはリテラル テキストと見なされ、変更されずに出力にコピーされます。リテラル テキストに中かっこ文字を含める必要がある場合は、{{ と }} を 2 回続けてエスケープします。置換フィールドには、名前、数値、空のいずれかを指定できます。値は str 関数を使用して文字列に変換されます。
# Access in order:
"{} < {}".format(4, 5) == "4 < 5"
# Access by position:
"{1}, {0}".format(2, 1) == "1, 2"
# Access by name:
"x{key}x".format(key = 2) == "x2x"

パラメータ

パラメータ 説明
args デフォルトは () です。
引数のリスト。
kwargs デフォルトは {} です。
引数の辞書。

index

int string.index(sub, start=0, end=None)

sub が見つかった最初のインデックスを返します。そのようなインデックスが存在しない場合、エラーを発生させます。必要に応じて、[start:end] に制限します。start はインデックスを含む範囲で、end はインデックスを除く範囲です。

パラメータ

パラメータ 説明
sub 必須
検索する部分文字列。
start int、または None。デフォルトは 0。
この位置からの検索に制限します。
end 整数、または None。デフォルトは None。
検索を制限する位置（省略可）。

isalnum

bool string.isalnum()

文字列内のすべての文字が英数字（[a-zA-Z0-9]）で、文字が 1 つ以上ある場合は true を返します。

イスアルファ

bool string.isalpha()

文字列内のすべての文字がアルファベット（[a-zA-Z]）で、文字が 1 つ以上ある場合は true を返します。

isdigit

bool string.isdigit()

文字列内のすべての文字が数字（[0-9]）で、文字が 1 つ以上ある場合は true を返します。

islower

bool string.islower()

文字列内の大文字と小文字がすべて小文字で、文字が 1 つ以上ある場合は true を返します。

isspace

bool string.isspace()

すべての文字が空白文字で、文字列に 1 文字以上が含まれる場合に true を返します。

istitle

bool string.istitle()

文字列がタイトルケースで、少なくとも 1 文字が含まれている場合は true を返します。つまり、すべての大文字文字は、大文字以外の文字（空白など）の後に続く必要があり、すべての小文字文字は、大文字または小文字の文字の後に続く必要があります。

isupper

bool string.isupper()

文字列内のすべての文字が大文字で、1 つ以上の文字がある場合に true を返します。

結合

string string.join(elements)

引数の文字列要素が、この文字列を区切り文字として結合された文字列を返します。例: 
"|".join(["a", "b", "c"]) == "a|b|c"

パラメータ

パラメータ 説明
elements 必須
結合するオブジェクト。

インストリーム単体に比べて

string string.lower()

この文字列の小文字バージョンを返します。

lstrip

string string.lstrip(chars=None)

chars に含まれる先頭文字を削除した文字列のコピーを返します。chars は接頭辞ではないことに注意してください。その値のすべての組み合わせが削除されます。
"abcba".lstrip("ba") == "cba"

パラメータ

パラメータ 説明
chars 文字列、または None。デフォルトは None。
削除する文字。None の場合は空白文字すべて。

パーティション

tuple string.partition(sep)

最初の区切り文字 sep で入力文字列を分割し、結果のパーティションをフォームの 3 要素タプル（before、separator、after）として返します。入力文字列に区切り文字が含まれていない場合、パーティションは（self、''、''）を返します。

パラメータ

パラメータ 説明
sep 必須
分割する文字列。

removeprefix

string string.removeprefix(prefix)

文字列が prefix で始まる場合は、接頭辞を削除した新しい文字列を返します。それ以外の場合は、文字列を返します。

パラメータ

パラメータ 説明
prefix 必須
削除する接頭辞（存在する場合）。

removesuffix

string string.removesuffix(suffix)

文字列が suffix で終わる場合は、接尾辞が削除された新しい文字列を返します。それ以外の場合は、文字列を返します。

パラメータ

パラメータ 説明
suffix 必須
削除する接尾辞（存在する場合）。

replace

string string.replace(old, new, count=-1)

old が new に置き換えられた文字列のコピーを返します。必要に応じて、置換回数を count に制限します。

パラメータ

パラメータ 説明
old 必須
置換する文字列。
new 必須
代替する文字列。
count デフォルトは -1
replacement の最大数。省略した場合や値が負の場合、上限はありません。

rfind

int string.rfind(sub, start=0, end=None)

sub が見つかった最後のインデックスを返します。そのようなインデックスが存在しない場合は -1 を返します。必要に応じて、[start:end] に制限できます。start はインデックスを含め、end は含めません。

パラメータ

パラメータ 説明
sub 必須
検索する部分文字列。
start int、または None。デフォルトは 0。
この位置からの検索に制限します。
end 整数、または None。デフォルトは None。
検索を制限する位置（省略可）。

rindex

int string.rindex(sub, start=0, end=None)

sub が見つかった最後のインデックスを返します。そのようなインデックスが存在しない場合、エラーを返します。必要に応じて、[start:end] に制限できます。start はインデックスを含む範囲で、end は含まない範囲です。

パラメータ

パラメータ 説明
sub 必須
検索する部分文字列。
start int、または None。デフォルトは 0。
この位置からの検索に制限します。
end 整数、または None。デフォルトは None。
検索を制限する位置（省略可）。

rpartition

tuple string.rpartition(sep)

区切り文字 sep の最後の箇所で入力文字列を分割し、結果のパーティションをフォームの 3 要素タプル（before、separator、after）として返します。入力文字列にセパレータが含まれていない場合、rpartition は（''、''、self）を返します。

パラメータ

パラメータ 説明
sep 必須
分割する文字列。

rsplit

list string.rsplit(sep, maxsplit=None)

文字列内のすべての単語のリストを返します。区切り文字として sep を使用し、必要に応じて分割数を maxsplit に制限します。右から分割する場合を除き、このメソッドは split() と同様に動作します。

パラメータ

パラメータ 説明
sep required
分割する文字列。
maxsplit int、または None。デフォルトは None。
分割の最大数。

rstrip

string string.rstrip(chars=None)

chars に表示される末尾の文字が削除された文字列のコピーを返します。chars は接尾辞ではないことに注意してください。その値のすべての組み合わせが削除されます。
"abcbaa".rstrip("ab") == "abc"

パラメータ

パラメータ 説明
chars 文字列、または None。デフォルトは None。
削除する文字。None の場合は空白文字すべて。

split

list string.split(sep, maxsplit=None)

文字列内のすべての単語のリストを返します。区切り文字として sep を使用し、必要に応じて分割数を maxsplit に制限します。

パラメータ

パラメータ 説明
sep 必須
分割する文字列。
maxsplit int、または None。デフォルトは None。
分割の最大数。

splitlines

sequence string.splitlines(keepends=False)

文字列を行境界（'\n'、'\r\n'、'\r'）で分割し、結果を新しい変更可能なリストとして返します。

パラメータ

パラメータ 説明
keepends デフォルトは False
結果のリストに改行を含めるかどうか。

startsWith

bool string.startswith(sub, start=0, end=None)

文字列が sub で始まる場合は True を返します。それ以外の場合は False を返します。必要に応じて [start:end] に制限します。start は包含、end は含みません。

パラメータ

パラメータ 説明
sub 文字列、または文字列のタプル。必須
匹合させる接頭辞（または代替接頭辞のタプル）。
start int、または None。デフォルトは 0
。この位置からテストを開始します。
end int、または None: デフォルトは None
この位置で比較を停止します。

strip

string string.strip(chars=None)

chars に含まれる先頭または末尾の文字が削除された文字列のコピーを返します。chars は接頭辞でも接尾辞でもありません。値の組み合わせはすべて削除されます。
"aabcbcbaa".strip("ab") == "cbc"

パラメータ

パラメータ 説明
chars 文字列または None: デフォルトは None です。
削除する文字。None の場合はすべての空白文字。

title

string string.title()

入力文字列を頭字に変換します。つまり、各単語の先頭は大文字で、残りの文字は小文字になります。このコンテキストでは、単語は厳密には文字のシーケンスを意味します。この方法では、Unicode の補足文字はサポートされていません。

上限

string string.upper()

この文字列を大文字にして返します。