string

問題を報告 ソースを表示 ナイトリー · 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 必須
カウントする部分文字列。
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 のタプル 必須
照合する接尾辞（または代替接尾辞のタプル）。
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 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 必須
検索する部分文字列。
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 を返します。

isdig

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

結合

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

パーティション

tuple string.partition(sep)

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

パラメータ

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

removeprefix

string string.removeprefix(prefix)

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

パラメータ

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

サフィックスを削除

string string.removesuffix(suffix)

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

パラメータ

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

replace

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

old のオカレンスが new に置換された文字列のコピーを返します。置換の数を count に制限することもできます。

パラメータ

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

rfind

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

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

パラメータ

パラメータ 説明
sub 必須
検索する部分文字列。
start int;または None デフォルトは 0
この位置からの検索に限定します。
end int;または None デフォルトは None
です 検索範囲を限定するオプションの位置。

rindex

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

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

パラメータ

パラメータ 説明
sub 必須
検索する部分文字列。
start int;または None デフォルトは 0
この位置からの検索に限定します。
end int;または 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 必須
分割する文字列。
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 必須
分割する文字列。
maxsplit int;または None デフォルトは None
です 分割の最大数。

スプリットライン

sequence string.splitlines(keepends=False)

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

パラメータ

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

次で始まる

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

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

パラメータ

パラメータ 説明
sub string;または string のタプル 必須
照合する接頭辞（または代替接頭辞のタプル）。
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 の補足文字はサポートされていません。

上限

string string.upper()

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