文字列

問題を報告する ソースを表示

文字列をサポートする言語の組み込みタイプ。文字列リテラルの例:
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 int、または None。デフォルトは None です。
検索を制限する前の任意の位置。

elems

sequence string.elems()

文字列の連続する 1 要素部分文字列を含む反復可能な値を返します。戻り値がリストでない可能性があることを除き、[s[i] for i in range(len(s))] と同じです。

次で終わる

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

文字列が sub で終わる場合は true を返します。それ以外の場合は false を返します。必要に応じて [start:end] に、start を包含し、end は除外します。

パラメータ

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

見つける

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

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

パラメータ

パラメータ 説明
sub required
検索する部分文字列。
start int、または None。デフォルトは 0
この位置からの検索に限定します。
end int、または 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 required
検索する部分文字列。
start int、または None。デフォルトは 0
この位置からの検索に限定します。
end int、または None。デフォルトは None です。
検索を制限する前の任意の位置。

Isalnum

bool string.isalnum()

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

イスアルファ

bool string.isalpha()

文字列内のすべての文字が英字([a-zA-Z])で 1 つ以上の文字がある場合、True を返します。

2 桁の数字

bool string.isdigit()

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

低い

bool string.islower()

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

isspace

bool string.isspace()

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

istitle

bool string.istitle()

文字列が語頭を大文字にして、1 つ以上の文字が含まれる場合に true を返します。つまり、すべての大文字は大文字か小文字などの文字の後に置き、すべての小文字は大文字か小文字かのように大文字か小文字かで並べる必要があります。

イスッパー

bool string.isupper()

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

join

string string.join(elements)

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

パラメータ

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

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

string string.lower()

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

リストストリップ

string string.lstrip(chars=None)

chars 内の先頭文字を削除した文字列のコピーを返します。chars は接頭辞ではないので、値のすべての組み合わせが削除されます。
"abcba".lstrip("ba") == "cba"

パラメータ

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

パーティション

tuple string.partition(sep)

入力文字列を区切り文字 sep の最初の出現箇所で分割し、結果のパーティションを形式の 3 要素タプル(前、区切り、後)として返します。入力文字列に区切り文字が含まれていない場合、パーティションは (self, '', '') を返します。

パラメータ

パラメータ 説明
sep required
分割先の文字列。

removeprefix

string string.removeprefix(prefix)

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

パラメータ

パラメータ 説明
prefix required
削除するプレフィックス(存在する場合)。

接尾辞を削除

string string.removesuffix(suffix)

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

パラメータ

パラメータ 説明
suffix 必須
削除するサフィックス(存在する場合)。

replace

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

oldnew で置き換えた文字列のコピーを返します。置換回数を count に制限することもできます。

パラメータ

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

rfind

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

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

パラメータ

パラメータ 説明
sub required
検索する部分文字列。
start int、または None。デフォルトは 0
この位置からの検索に限定します。
end int、または None。デフォルトは None です。
検索を制限する前の任意の位置。

rindex

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

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

パラメータ

パラメータ 説明
sub required
検索する部分文字列。
start int、または None。デフォルトは 0
この位置からの検索に限定します。
end int、または None。デフォルトは None です。
検索を制限する前の任意の位置。

rpartition

tuple string.rpartition(sep)

入力文字列を区切り記号 sep の最終箇所で分割し、結果のパーティションを形式の 3 要素タプル(前、区切り、後)として返します。入力文字列に区切り文字が含まれていない場合、rpartition は ('', '', self) を返します。

パラメータ

パラメータ 説明
sep required
分割先の文字列。

分割

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 string、または None。デフォルトは None
削除する文字。None の場合はすべての空白。

split

list string.split(sep, maxsplit=None)

sep を区切り文字として使用して、文字列内のすべての単語のリストを返します。分割数を maxsplit に制限することもできます。

パラメータ

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

スプリットライン

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 string、または stringtuple。必須
照合する接頭辞(または代替接頭辞のタプル)。
start int、または None。デフォルトは 0
この位置からテストを開始します。
end int、または None。デフォルトは None
この位置で比較を停止します。

strip

string string.strip(chars=None)

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

パラメータ

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

title

string string.title()

入力した文字列を語頭の大文字に変換します。つまり、すべての単語を大文字にし、残りの文字を小文字にします。ここでの 1 つの単語とは、厳密には一連の文字を意味します。このメソッドでは Unicode 文字の補助文字はサポートされていません。

upper

string string.upper()

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