string

問題を報告 ソースを表示

文字列をサポートする言語の組み込み型。文字列リテラルの例:
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 です。
検索範囲を限定する前の省略可能な位置。

要素

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

find

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 を返します。

isdigit

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 required
結合するオブジェクト。

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

string string.lower()

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

Lstrip

string string.lstrip(chars=None)

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

パラメータ

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

パーティション

tuple string.partition(sep)

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

パラメータ

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

接頭辞の削除

string string.removeprefix(prefix)

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

パラメータ

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

サフィックスを削除

string string.removesuffix(suffix)

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

パラメータ

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

replace

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

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

パラメータ

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

検索

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 要素タプル（before、separator、after）として返します。入力文字列に区切り文字が含まれていない場合、rpartition は ('', '', self を返します。

パラメータ

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

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 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: または string のtuple。 必須
照合する接頭辞（または代替接頭辞のタプル）。
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()

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

upper

string string.upper()

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