Ruby 1.8.7 リファレンスマニュアル > ライブラリ一覧 > 組み込みライブラリ > Errno::EXXXクラス

class Errno::EXXX

クラスの継承リスト: Errno::EXXX < SystemCallError < StandardError < Exception < Object < Kernel

要約

システム依存のエラーコードのそれぞれに対応する一連の例外クラスです。 Rubyのライブラリ内部でシステムコールや一部のC言語関数が失敗したときに発生します。

実際には「EXXX」というクラスが定義されているわけではありません。「XXX」の部分は下記に列挙したような各種のエラー名が入ります。 例えば、File.open の内部でシステムコール open(2) がエラーコード ENOENT を返すと、Rubyは例外 Errno::ENOENT を発生させます。

Ruby は処理系がコンパイルされるときに、デフォルトで下記リストのような Errno::EXXX クラスを定義しようとします。 Errno::EXXX クラスは、対応するエラー名が動作環境に存在する場合のみ定義されます。 このため、一部の環境にしか存在しないエラーコードについて rescue 節などで Errno::EXXX を利用すると 意図せずプログラムの可搬性を損なう場合があります。 それを避けるには、エラーコードの種類を特定する必要がある場合を除いては SystemCallError で rescue するようにしてください。

また、以下の一覧にはないシステムエラーが発生した場合は、 Errno::EXXX (XXX はエラー番号を表す 3 桁の数字) という名前の例外クラスが自動的に作成され、発生します。 (これは Ruby 内部でのみ行われ、 Ruby プログラム上で SystemCallError.new に一覧にないコードを渡してもクラスは作成されません)

それぞれの例外が発生し得るケースについては、この項では記述しません。 例外を発生する各メソッドのマニュアルおよびオペレーティングシステムのマニュアルを参照してください。

エラー名リスト

個々の例外の意味はシステム依存です。 システムのマニュアル errno(3) を参照してください。 Microsoft Windows システムにおいては http://msdn2.microsoft.com/ja-jp/library/5814770t.aspx を参照してください。

特異メソッド

定義 説明
self === other -> bool

other が SystemCallError のサブクラスのインスタンスで、 かつ、other.errno の値が self::Errno と同じ場合に真を返します。そうでない場合は偽を返します。

new() -> Errno::EXXX
new(error_message) -> Errno::EXXX

Errno::EXXX オブジェクトを生成して返します。

定数

定義 説明
Errno

Errno::EXXX の各クラスに対応するシステム依存のエラーコード値(整数)です。

継承したメソッド

backtrace exception message set_backtrace .exception == === =~ __id__ __send__ _dump class clone dclone display enum_for eql? equal? extend freeze frozen? hash initialize initialize_copy inspect instance_eval instance_exec instance_of? instance_variable_defined? instance_variable_get instance_variable_set instance_variables is_a? marshal_dump marshal_load method method_missing methods nil? pretty_inspect pretty_print pretty_print_cycle pretty_print_inspect pretty_print_instance_variables private_methods protected_methods public_methods remove_instance_variable respond_to? singleton_method_added singleton_method_removed singleton_method_undefined singleton_methods taint tainted? tap to_a to_ary to_hash to_int to_io to_proc to_regexp to_yaml to_yaml_properties to_yaml_style untaint errno