2.3.6.1 文字列メソッド

以下は 8 ビット文字列および Unicode オブジェクトでサポートされるメソッドです:

capitalize( ): 最初の文字を大文字にした文字列のコピーを返します。
このメソッドの挙動は8 ビット文字列に対してはロケール依存になります。

center( width): width の長さをもつ中央寄せされた文字列を返します。パディングには空白が使われます。

count( sub[, start[, end]]): 文字列 S[start:end] 中に部分文字列 sub が出現する回数を返します。オプション引数 start および end はスライス表記と同じように解釈されます。

decode( [encoding[, errors]]): codec に登録された文字コード系 encoding を使って文字列をデコードします。encoding は標準でデフォルトの文字列エンコーディングになります。標準とは異なるエラー処理を行うために errors を与えることができます。標準のエラー処理は 'strict' で、エンコードに関するエラーは ValueError を送出します。他に利用できる値は 'ignore' および 'replace' です。バージョン2.2 以降で新規追加された仕様です。

encode( [encoding[,errors]]): 文字列のエンコードされたバージョンを返します。標準のエンコーディングは現在のデフォルト文字列エンコーディングです。標準とは異なるエラー処理を行うために errors を与えることができます。標準のエラー処理は 'strict' で、エンコードに関するエラーは ValueError を送出します。他に利用できる値は 'ignore' および 'replace' です。バージョン2.0 以降で新規追加された仕様です。

endswith( suffix[, start[, end]]): 文字列の一部が suffix で終わるときに True を返します。そうでない場合 False を返します。オプション引数 start がある場合、文字列の start から比較を始めます。end がある場合、文字列の end で比較を終えます。

expandtabs( [tabsize]): 全てのタブ文字が空白で展開された文字列のコピーを返します。 tabsize が与えられていない場合、タブ幅は 8 文字分と仮定します。

find( sub[, start[, end]]): 文字列中の領域 [start, end) に sub が含まれる場合、その最小のインデクスを返します。オプション引数 start および end はスライス表記と同様に解釈されます。sub が見つからなかった場合 -1 を返します。

index( sub[, start[, end]]): find() と同様ですが、sub が見つからなかった場合 ValueError を送出します。

isalnum( ): 文字列中の全ての文字が英数文字で、かつ 1 文字以上ある場合には真を返し、そうでない場合は偽を返します。
このメソッドの挙動は8 ビット文字列に対してはロケール依存になります。

isalpha( ): 文字列中の全ての文字が英文字で、かつ 1 文字以上ある場合には真を返し、そうでない場合はを返します。
このメソッドの挙動は8 ビット文字列に対してはロケール依存になります。

isdigit( ): 文字列中に数字しかない場合には真を返し、その他の場合は偽を返します。
このメソッドの挙動は8 ビット文字列に対してはロケール依存になります。

islower( ): 文字列中の大小文字の区別のある文字全てが小文字で、かつ 1 文字以上ある場合には真を返し、そうでない場合は偽を返します。
このメソッドの挙動は8 ビット文字列に対してはロケール依存になります。

isspace( ): 文字列が空白文字だけからなり、かつ 1 文字以上ある場合には真を返し、そうでない場合は偽を返します。
このメソッドの挙動は8 ビット文字列に対してはロケール依存になります。

istitle( )

文字列がタイトルケース文字列であり、かつ 1 文字以上ある場合、すなわち大文字は大小文字の区別のない文字の後にのみ続き、小文字は大小文字の区別のある文字の後ろにのみ続く場合には真を返します。そうでない場合は偽を返します。

このメソッドの挙動は8 ビット文字列に対してはロケール依存になります。

isupper( ): 文字列中の大小文字の区別のある文字全てが大文字で、かつ 1 文字以上ある場合には真を返し、そうでない場合は偽を返します。
このメソッドの挙動は8 ビット文字列に対してはロケール依存になります。

join( seq): 配列 seq 中の文字列を結合した文字列を返します。文字列を結合するときの区切り文字は、このメソッドを適用する対象の文字列になります。

ljust( width): width の長さをもつ左寄せした文字列を返します。パディングには空白が使われます。width が len(s) よりも小さい場合、元の文字列が返されます。

lower( ): 文字列をコピーし、小文字に変換して返します。
このメソッドの挙動は8 ビット文字列に対してはロケール依存になります。

lstrip( [chars]): 文字列をコピーし、文字列の先頭部分を除去して返します。 chars が省略されるか None の場合、空白文字が除去されます。chars が与えられていてかつ None でない場合、chars は文字列でなければなりません; このメソッドを適用した対象の文字列の先頭部分から chars 中の文字が除去されます。バージョン2.2.2 以降で変更された仕様: 引数 chars をサポートしました

replace( old, new[, count]): 文字列をコピーし、部分文字列 old のある部分全てを new に置換して返します。オプション引数 count が与えられている場合、先頭から count 個の old だけを置換します。

rfind( sub [,start [,end]]): 文字列中の領域 [start, end) に sub が含まれる場合、その最大のインデクスを返します。オプション引数 start および end はスライス表記と同様に解釈されます。sub が見つからなかった場合 -1 を返します。

rindex( sub[, start[, end]]): find() と同様ですが、sub が見つからなかった場合 ValueError を送出します。

rjust( width): width の長さをもつ右寄せした文字列を返します。パディングには空白が使われます。width が len(s) よりも小さい場合、元の文字列が返されます。

rstrip( [chars]): 文字列をコピーし、文字列の末尾部分を除去して返します。 chars が省略されるか None の場合、空白文字が除去されます。chars が与えられていてかつ None でない場合、chars は文字列でなければなりません; このメソッドを適用した対象の文字列の末端部分から chars 中の文字が除去されます。バージョン2.2.2 以降で変更された仕様: 引数 chars をサポートしました

split( [sep [,maxsplit]]): sep を単語の境界として文字列を単語に分割し、分割された単語からなるリストを返します。maxsplit が与えられた場合、最大で maxsplit 個になるように分割します (従って、リストは最大で maxsplit+1 個の要素を持つことになります)。maxsplit を省略したりゼロにした場合、分割の個数は無制限 (できる限りの分割を行う) になります。デリミタが連続している場合には、デリミタ同士をグループ化せず、空文字列に対する分割であるとみなします (たとえば "'1,,2'.split(',')" は "['1', '', '2']" を返します)。 sep 引数は複数文字からなる文字列にできます (たとえば、 "'1, 2, 3'.split(', ')" は "['1', '2', '3']"を返します)。分割文字列を指定して空文字列に対する分割を行うと空のリストを返します。 sep を省略したり None にした場合、通常とは違った分割アルゴリズムを適用します。この場合、各語は任意の長さの空白文字 (スペース、タブ、改行、復帰、行送り) からなる文字列で分割されます。連続する空白文字は単一のデリミタとして扱われます ("'1 2 3'.split()" は "['1', '2', '3']" を返します)。空の文字列を分割すると "['']" を返します。

splitlines( [keepends]): 文字列を改行部分で分解し、各行からなるリストを返します。 keepends が与えられていて、かつその値が真でない限り、返されるリストには改行文字は含まれません。

startswith( prefix[, start[, end]]): 文字列の一部が prefix で始まるときに True を返します。そうでない場合 False を返します。オプション引数 start がある場合、文字列の start から比較を始めます。end がある場合、文字列の end で比較を終えます。

strip( [chars]): 文字列をコピーし、文字列の先頭および末尾部分を除去して返します。 chars が省略されるか None の場合、空白文字が除去されます。chars が与えられていてかつ None でない場合、chars は文字列でなければなりません; このメソッドを適用した対象の文字列の両端から chars 中の文字が除去されます。バージョン2.2.2 以降で変更された仕様: 引数 chars をサポートしました

swapcase( ): 文字列をコピーし、大文字は小文字に、小文字は大文字に変換して返します。このメソッドの挙動は8 ビット文字列に対してはロケール依存になります。

title( ): 文字列をタイトルケースにして返します: 大文字から始まり、残りの文字のうち大小文字の区別があるものは全て小文字にします。
このメソッドの挙動は8 ビット文字列に対してはロケール依存になります。

translate( table[, deletechars]): 文字列をコピーし、オプション引数の文字列 deletechars の中に含まれる文字を全て除去します。その後、残った文字を変換テーブル table に従ってマップして返します。変換テーブルは長さ 256 の文字列でなければなりません。
Unicode オブジェクトの場合、translate() メソッドはオプションの deletechars 引数を受理しません。その代わり、メソッドはすべての文字が与えられた変換テーブルで対応付けされている s のコピーを返します。この変換テーブルは Unicode 順 (ordinal) から Unicode 順、Unicode 文字列、または None への対応付けでなくてはなりません。対応付けされていない文字は何もせず放置されます。 None に対応付けられた文字は削除されます。ちなみに、より柔軟性のあるアプローチは、自作の文字対応付けを行う codec を codecs モジュールを使って作成することです (例えば encodings.cp1251 を参照してください。

upper( ): 文字列をコピーし、大文字に変換して返します。
このメソッドの挙動は8 ビット文字列に対してはロケール依存になります。

zfill( width): 数値文字列の左側をゼロ詰めし、幅 width にして返します。 width が len(s) よりも短い場合もとの文字列自体が返されます。バージョン2.2.2 以降で新規追加された仕様です。

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。