PowerShellでテキストファイル内の文字列置換
PowerShellでテキストファイル内の特定の文字列を置換する方法について。
入力ファイル「input.txt」内に存在する文字列「foo」を全て「bar」に置換して、出力ファイル「output.txt」に出力する。
出力ファイル「output.txt」が既に存在する場合は、上書き保存される。
バッチファイルによる方法では、空行が消えるなどの制限があった。PowerShell では空行を含めてそのまま処理できる。バッチファイル版は以下を参照。
https://knowledge.reontosanta.com/archives/816
基本の置換
[Get-Content]でファイルを読み込み、[-replace]演算子で置換して、[Set-Content]で出力する。
1 | (Get-Content input.txt) -replace 'foo', 'bar' | Set-Content output.txt |
Get-Content はファイルを行ごとの文字列として読み込み、-replace は各行に対して置換を行う。
同じファイルへ上書きする
出力先に入力ファイルと同じファイルを指定すると、置換結果でそのまま上書きできる。
1 | (Get-Content input.txt) -replace 'foo', 'bar' | Set-Content input.txt |
Get-Content を括弧で囲むことが重要である。括弧により読み込みが完了してから書き込みが始まるため、読み込み途中のファイルへ書き込んでしまうことがない。
複数の置換を続けて行う
-replace は続けて書くことで、複数の置換を順に行える。
1 | (Get-Content input.txt) -replace 'foo', 'bar' -replace 'hoge', 'fuga' | Set-Content output.txt |
正規表現とそのままの文字列の置換
-replace の置換前文字列は正規表現として解釈される。たとえば「.」は任意の1文字に一致するため、意図しない置換が起こる場合がある。
文字列をそのまま置換したい場合は、[regex]::Escape()で置換前文字列をエスケープするか、文字列の Replace メソッドを利用する。
1 2 | # 正規表現として解釈させない場合(Escape) (Get-Content input.txt) -replace [regex]::Escape('foo.bar'), 'baz' | Set-Content output.txt |
1 2 3 | # 文字列変数に対する Replace メソッド $text = 'foo bar foo' $text.Replace('foo', 'baz') |
Replace メソッドは文字列をそのまま検索し、大文字と小文字を区別する。
大文字と小文字を区別する
-replace は既定では大文字と小文字を区別しない。区別する場合は [-creplace] 演算子を利用する。
1 | (Get-Content input.txt) -creplace 'Foo', 'bar' | Set-Content output.txt |
この例では「Foo」だけが置換され、「foo」や「FOO」は置換されない。
エンコーディングの注意
日本語を含むファイルを扱う場合は、エンコーディングに注意する。
PowerShell 5.1 では、Set-Content の既定のエンコーディングは ASCII であり、日本語は文字化けする。読み込みと書き出しの両方に [-Encoding Default](日本語環境では Shift_JIS)を指定すること。
1 | (Get-Content -Encoding Default input.txt) -replace 'foo', 'bar' | Set-Content -Encoding Default output.txt |
PowerShell 7 では既定のエンコーディングが UTF-8(BOMなし)に変わっている。扱うファイルの文字コードに合わせて -Encoding を指定すること。
まとめ
PowerShell では、Get-Content と -replace と Set-Content の組み合わせで、テキストファイル内の文字列置換を1行で行える。バッチファイルによる方法にあった空行や行頭記号の制限もない。
バッチファイル版の記事はこちら。
https://knowledge.reontosanta.com/archives/816