str.replace() 部分文字列を置換
最終更新：2026-09-22
str.replace() 部分文字列を置換
str.replace(old, new[, count]) old を new に置換したコピーを返す。count は回数を制限する。
| カテゴリ | 文字列メソッド |
|---|---|
| 種類 | 組み込み型メソッド |
| Python バージョン | all |
📝 構文
str.replace(old, new[, count])⚙️ 引数
| old 必須 | The substring to be replaced. |
|---|---|
| new 必須 | The replacement substring. |
| count 任意 | Maximum number of replacements; -1 means replace all.（デフォルト値：-1） |
戻り値：str. A copy with old replaced by new, up to count times.
元のオブジェクトを変更するか：いいえ（新しいオブジェクトを返す）
▶ 例
下のコードを編集し「実行」をクリックすると、出力パネルに結果が表示されます：
実行結果：
bbb
bbaa💡 関連するケース
さらに多くのケースは近日公開予定です。
❓ よくある質問
Qreplace() は元の文字列を変更しますか？
Aいいえ！文字列はイミュータブルなので、replace() は新しい文字列を返します。'aaa'.replace('a', 'b') は新しい文字列を作りますが、元の変数は変わりません。結果を取得するには代入する必要があります。
Q最初の数回だけ置換するには？
Acount パラメータを使います：'aaa'.replace('a', 'b', 2) は最初の 2 個だけ置換し、'bba' になります。
Q置換対象の部分文字列が存在しない場合はどうなりますか？
Aエラーは発生せず、元の文字列のコピーをそのまま返します。
Q部分文字列を削除するには？
A空文字列で置換します：'a-b-c'.replace('-', '') は 'abc' になります。
