Difference between revisions of "MSX-DOS2PIS 06"

Latest revision as of 13:50, 17 December 2020

6.エラー

すべての新しいMSX-DOS 2機能（40 h以上の機能コード）はAで「エラーコード」を返します。操作が成功した場合、これは0です。ゼロ以外の場合、エラーコードはエラーの正確な性質を説明します。

MSX-DOS 2は関数呼び出しから戻る直前に "OR A"命令を実行するので、エラーが発生したかどうかをテストするために "CALL 5"命令の直後の一時プログラムで "JR NZ"命令がよく使用されます。多くの場合、このエラージャンプの宛先はエラーコードをBにロードして「エラーコードで終了」機能を実行します。これはエラーコードをコマンドインタプリタに返し、コマンドインタプリタは適切なメッセージを出力します。

一時的なプログラム自体も、 "エラーコードの説明"関数を使用して、MSX-DOS 2関数呼び出しによって返されたエラーに関する実際のメッセージを取得することがあります。詳細は機能仕様を参照してください。

エラーコードは0FFhから始まり、値が大きくなります。 40h未満の値は「ユーザーエラー」であり、システムによって使用されることは決してなく、一時的プログラムによって使用されて独自のエラーを返すことができます。コマンドインタープリタに返された20時間未満のユーザーエラーは、メッセージを表示しません。

"Explain Error Code"関数呼び出し（関数仕様を参照）がメッセージを持たないエラーコードの説明を要求された場合、返される文字列は "System error <n>"または "User error <n"です。 > "適切な場合、<n>はエラー番号です。

以下は現在定義されているすべてのエラー番号とそのメッセージおよび意味のリストです。また、ニーモニックも示されています。ニーモニックは、ソースファイルのシンボルとしてよく使用され、特定のエラーを指すためにMSX-DOS 2システム全体で使用されています。