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

【Python3.x】ConnectionError::errno定数の使い方

errno定数の使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

errno定数は、オペレーティングシステムが報告するシステムエラーコードを表す定数です。これらの定数は、ファイル操作やネットワーク通信などのシステムコールが失敗した際に返される数値コードに対応しており、エラーの具体的な種類を示します。例えば、アクセス拒否(Permission denied)、ファイルが見つからない(No such file or directory)、接続が拒否された(Connection refused)といった状況に対して、それぞれ一意のコードが割り当てられています。

Pythonでは、errnoモジュールを通じてこれらの定数にアクセスできます。特に、ConnectionErrorのようなネットワーク関連の例外が発生した場合、その例外オブジェクトが持つerrnoプロパティは、これらのシステムエラーコード定数の一つと合致する値を保持することが多く、エラーの具体的な原因(例:ホストへのルーティングができない、ネットワークがダウンしているなど)を詳細に特定するのに役立ちます。

システムエンジニアにとって、これらの定数を理解することは、低レベルなシステムエラーを診断し、アプリケーションの堅牢性を高める上で非常に重要です。エラーコードを正確に把握することで、より的確なエラーハンドリングやデバッグが可能になります。

構文(syntax)

1try:
2    # 接続エラーが発生する可能性のある処理(例として意図的に発生)
3    raise ConnectionError("接続拒否", 111) # 111は一般的な接続拒否のエラーコード
4except ConnectionError as e:
5    # ConnectionErrorオブジェクト 'e' からerrno属性にアクセス
6    error_code = e.errno

引数(parameters)

引数なし

引数はありません

戻り値(return)

int

ConnectionErrorクラスのerrno属性は、ネットワーク接続エラーが発生した際に、OSが返すエラーコードを整数型で保持しています。

関連コンテンツ