【Ruby3.x】Encoding::Converter::putback()メソッドの使い方

putbackメソッドは、RubyのEncoding::Converterクラスに属し、文字エンコーディングの変換処理において、入力として読み込んだバイト列を、変換器の入力バッファに再び戻す（再投入する）機能を実行するメソッドです。

この機能は、変換処理中に誤って入力データを読み込み過ぎてしまった場合や、特定の条件に基づいて入力データをもう一度処理の先頭から評価し直したい場合に特に有用です。putbackメソッドに渡されたバイト列は、次にEncoding::Converterオブジェクトが文字変換（例えば、convertメソッドやfinishメソッド）を実行する際に、あたかもまだ読み込まれていないかのように、最も優先される入力データとして扱われます。

これにより、開発者は入力ストリームの消費をより細かく制御できるようになり、部分的な文字コードの読み込みや、複雑なエンコーディング規則に対応する際に、変換ロジックの柔軟性を大幅に向上させることが可能です。例えば、予期せぬ入力シーケンスに遭遇した場合に、一部を戻して別の変換を試みるといった高度な処理を実現できます。

Copy
1converter = Encoding::Converter.new("UTF-8", "EUC-JP")
2failed_bytes = "バイト列".b # 例として、変換できなかったバイト列を表すStringオブジェクト
3
4converter.putback(failed_bytes)

引数なし

引数はありません

self

このメソッドは、変換処理の実行中に保留されたバイト列を、後続の変換処理のためにバッファに戻すために使用されます。メソッド自体は、メソッドを呼び出したオブジェクト（self）を返します。