Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

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

source_encodingメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

source_encodingメソッドは、Encoding::InvalidByteSequenceError クラスのインスタンスに対して、エラーを引き起こした元の文字列のエンコーディング情報を取得するメソッドです。

このエラーは、あるエンコーディングの文字列を別のエンコーディングへ変換しようとした際、元の文字列内に変換先のエンコーディングでは解釈できないような、無効なバイトシーケンス(文字として成立しないバイトの並び)が検出された場合に発生します。例えば、UTF-8として扱われている文字列の中にEUC-JPでは不正なバイト列が含まれており、それをEUC-JPに変換しようとすると、このエラーが送出されます。

source_encodingメソッドを使用することで、エラーが発生した原因となった「元の(ソース)エンコーディング」をRubyのEncodingオブジェクトとして取得できます。これにより、開発者はどのエンコーディング設定の文字列が問題を引き起こしたのかを明確に特定でき、デバッグ作業やエラーハンドリングにおいて、問題の根本原因を突き止めるための重要な手がかりを得られます。特に、異なるエンコーディングを持つデータが混在するシステムや、外部からの入力データを処理する際に、エンコーディングの問題を解決するために不可欠な情報を提供します。返されるEncodingオブジェクトは、無効なバイトシーケンスを含む文字列が元々どのエンコーディングであったかを示します。

構文(syntax)

1begin
2  "\x82\xA0".force_encoding("ASCII-8BIT").encode("UTF-8")
3rescue Encoding::InvalidByteSequenceError => e
4  e.source_encoding
5end

引数(parameters)

引数なし

引数はありません

戻り値(return)

Encoding

このメソッドは、無効なバイトシーケンスが検出された際のエンコーディングオブジェクトを返します。

関連コンテンツ