以下は 8 ビット文字列および Unicode オブジェクトでサポートされる メソッドです:
) |
8ビット文字列では、メソッドはロケール依存になります。
width[, fillchar]) |
sub[, start[, end]]) |
[start:end]
中に部分文字列 sub
が出現する回数を返します。オプション引数 start および end
はスライス表記と同じように解釈されます。
[encoding[, errors]]) |
'strict'
で、エンコード
に関するエラーは UnicodeError を送出します。
他に利用できる値は 'ignore'
、 'replace'
および
関数 codecs.register_error によって登録された名前です。
これについてはセクション 4.8.1節を参照してください。
バージョン 2.2 で 新たに追加 された仕様です。
バージョン 2.3 で 変更 された仕様:
その他のエラーハンドリングスキーマがサポートされました
[encoding[,errors]]) |
'strict'
で、エンコード
に関するエラーは UnicodeError を送出します。
他に利用できる値は 'ignore'
、 'replace'
、
'xmlcharrefreplace'
、 'backslashreplace'
および
関数 codecs.register_error によって登録された名前です。
これについてはセクション 4.8.1を参照してください。
利用可能なエンコーディングの一覧は、セクション 4.8.3
を参照してください。
バージョン 2.0 で 新たに追加 された仕様です。
バージョン 2.3 で 変更 された仕様:
'xmlcharrefreplace'
、 'backslashreplace'
およびその他のエラーハンドリングスキーマがサポートされました
suffix[, start[, end]]) |
True
を返します。そう
でない場合 False
を返します。suffix は見つけたい複数の接尾語
のタプルでも構いません。オプション引数 start がある場
合、文字列の start から比較を始めます。end がある場合、文字
列の end で比較を終えます。
バージョン 2.5 で 変更 された仕様: suffix でタプルを受け付けるようになりました
[tabsize]) |
8
文字分
と仮定します。
sub[, start[, end]]) |
-1
を返します。
sub[, start[, end]]) |
) |
8ビット文字列では、メソッドはロケール依存になります。
) |
8ビット文字列では、メソッドはロケール依存になります。
) |
8ビット文字列では、メソッドはロケール依存になります。
) |
8ビット文字列では、メソッドはロケール依存になります。
) |
8ビット文字列では、メソッドはロケール依存になります。
) |
8ビット文字列では、メソッドはロケール依存になります。
) |
8ビット文字列では、メソッドはロケール依存になります。
seq) |
width[, fillchar]) |
len(s)
よりも小さい場合、元の文字列が返されます。
バージョン 2.4 で 変更 された仕様:
引数 fillchar が追加されました
) |
8ビット文字列では、メソッドはロケール依存になります。
[chars]) |
None
の場合、空白文字が
除去されます。chars 文字列は接頭語ではなく、そこに
含まれる文字の組み合わせ全てがはぎ取られます。
>>> ' spacious '.lstrip() 'spacious ' >>> 'www.example.com'.lstrip('cmowz.') 'example.com'
sep) |
old, new[, count]) |
sub [,start [,end]]) |
-1
を返します。
sub[, start[, end]]) |
width[, fillchar]) |
len(s)
よりも小さい場合、元の文字列が返されます。
バージョン 2.4 で 変更 された仕様:
引数 fillchar が追加されました
sep) |
[sep [,maxsplit]]) |
None
のとき、全ての
空白文字が区切り文字となります。右から分割していくことを除けば、
rsplit() は後ほど詳しく述べる split() と同様に振る舞います。
バージョン 2.4 で 新たに追加 された仕様です。
[chars]) |
None
の場合、空白文字が
除去されます。chars 文字列は接尾語ではなく、そこに
含まれる文字の組み合わせ全てがはぎ取られます。
>>> ' spacious '.rstrip() ' spacious' >>> 'mississippi'.rstrip('ipz') 'mississ'
[sep [,maxsplit]]) |
maxsplit+1
の要素を持ちます)
maxsplit が与えられていない場合、無制限に分割が行なわれます
(全ての可能な分割が行なわれる)。連続した区切り文字はグループ化されず、
空の文字列を区切っていると判断されます(例えば "'1,,2'.split(',')" は
"['1', '', '2']" を返します)。引数 sep は複数の文字にも
できます(例えば "'1, 2, 3'.split(', ')" は
"['1', '2', '3']" を返します)。区切り文字を指定して空の文字列を
分割すると、"['']" を返します。
sep が指定されていないか None
が指定されている場合、異なる分割
アルゴリズムが適用されます。最初に空白文字(スペース、タブ、改行(newline)、
復帰(return)、改ページ(formfeed)) が文字列の両端から除去されます。
次に任意の長さの空白文字列によって単語に分割されます。
連続した空白の区切り文字は単一の区切り文字として扱われます
("'1 2 3'.split()" は "['1', '2', '3']" を返します)。
空の文字列や空白文字だけから成る文字列を分割する場合には空のリストを返します。
[keepends]) |
8ビット文字列では、メソッドはロケール依存になります。
prefix[, start[, end]]) |
True
を返します。そう
でない場合 False
を返します。prefix は複数の接頭語の
タプルにしても構いません。オプション引数 start がある場
合、文字列の start から比較を始めます。end がある場合、文字
列の end で比較を終えます。
バージョン 2.5 で 変更 された仕様: prefix でタプルを受け付けるようになりました
[chars]) |
None
の場合、空白文字が
除去されます。chars 文字列は接頭語でも接尾語でもなく、
そこに含まれる文字の組み合わせ全てがはぎ取られます。
>>> ' spacious '.strip() 'spacious' >>> 'www.example.com'.strip('cmowz.') 'example'
) |
) |
table[, deletechars]) |
Unicode オブジェクトの場合、translate() メソッドはオプションの
deletechars 引数を受理しません。その代わり、メソッドは
すべての文字が与えられた変換テーブルで対応付けされている s の
コピーを返します。この変換テーブルは Unicode 順 (ordinal) から
Unicode 順、Unicode 文字列、または None
への対応付け
でなくてはなりません。対応付けされていない文字は何もせず放置されます。
None
に対応付けられた文字は削除されます。ちなみに、
より柔軟性のあるアプローチは、自作の文字対応付けを行う codec
を codecs モジュールを使って作成することです
(例えば encodings.cp1251 を参照してください。
) |
8ビット文字列では、メソッドはロケール依存になります。
width) |
len(s)
よりも短い場合もとの文字列自体が
返されます。
バージョン 2.2.2 で 新たに追加 された仕様です。
ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。