Pythonで文字列をファイルのように扱う方法｜StringIOの使い方を解説

文字列をファイルライクなオブジェクトに変換するには？

Pythonでは、文字列の中身を持つファイルライクなオブジェクト（ファイルと同じダックタイプのオブジェクト）を作成したい場面があります。そのような場合には StringIO モジュールを使用します。文字列を StringIO のコンストラクタに渡すだけで、あとは通常のファイルオブジェクトと同じように読み書きが行えます。

以下は基本的な使用例です。

>>> from cStringIO import StringIO
>>> f = StringIO('Hello world')
>>> f.read()
'Hello world'

このように、f.read() を呼び出すと、渡した文字列がそのまま返されることが確認できます。

Python 3での使い方：io モジュール

Python 3では、cStringIO モジュールは廃止されているため、代わりに標準ライブラリの io モジュールを使用します。

>>> import io
>>> f = io.StringIO('Hello world')
>>> f.read()
'Hello world'

io.StringIO はPython 3における推奨の方法であり、メモリ上でテキストデータをファイルのように操作できるため、テストコードや一時的なデータ処理などで非常に便利です。

Unicode文字列に関する注意点

なお、Python 2の StringIO については、プレーンなASCIIとしてエンコードできないUnicode文字列を受け付けないという制限がある点に注意してください。日本語などのマルチバイト文字を扱う場合は、適切なエンコード処理を行うか、Python 3の io.StringIO を使用することをおすすめします。