GNU Emacs 32.0.50 (9008bf64c3) のマニュアルを PLaMo 翻訳で機械翻訳したものです。誤訳を含むことがあります。原文: https://www.gnu.org/software/emacs/manual/html_node/elisp/Standard-Errors.html ・ emacs-doc.conao3.com

付録F 標準誤差

以下に、標準のEmacsにおける主要なエラーシンボルを、概念別に分類して一覧にします。各シンボルのメッセージと、そのエラーがどのように発生し得るかの説明への相互参照を記載しています。

各エラーシンボルには、シンボルのリストである親エラー条件の集合が定義されています。通常、このリストにはエラーシンボル自体とシンボル error が含まれます。場合によっては、error よりも狭く、かつ単一のエラーシンボルよりも広い中間分類である追加のシンボルが含まれることもあります。例えば、ファイルアクセスにおけるすべてのエラーは、条件 file-error を持ちます。ここで特定のエラーシンボルに追加のエラー条件がないと述べている場合は、条件が存在しないことを意味します。

特例として、エラー記号 quit と minibuffer-quit には条件 error が適用されません。これは、終了がエラーとはみなされないためです。

これらのエラーシンボルの多くはC言語で定義されています(主にdata.c)が、一部はLispで定義されています。例えば、ファイルuserlock.elではfile-lockedおよびfile-supersessionエラーが定義されています。Emacsに同梱されているいくつかの特化したLispライブラリでも、独自のエラーシンボルが定義されています。ここでは、それらすべてを列挙することはしません。

エラーの発生および処理方法については、Errorsを参照してください。

error

メッセージは ‘error’ です。エラーを参照してください。

quit

メッセージは ‘Quit’ です。Quitting を参照してください。

minibuffer-quit

メッセージは ‘Quit’ です。これは quit のサブカテゴリです。Quitting を参照してください。

args-out-of-range

メッセージは ‘Args out of range’ です。これは、シーケンス、バッファ、またはその他のコンテナのようなオブジェクトの範囲外にある要素にアクセスしようとしたときに発生します。シーケンス、配列、ベクトル、および テキストを参照してください。

arith-error

メッセージは ‘Arithmetic error’ です。これは、0による整数除算を行おうとした際に発生します。数値変換および算術演算を参照してください。

beginning-of-buffer

メッセージは ‘Beginning of buffer’ です。キャラクターによるモーションを参照してください。

buffer-read-only

メッセージは ‘Buffer is read-only’ です。読み取り専用バッファを参照してください。

circular-list

メッセージは ‘List contains a loop’ です。これは、循環構造が検出された場合に発生します。循環オブジェクトの構文について読むを参照してください。

cl-assertion-failed

メッセージは ‘Assertion failed’ です。これは、cl-assert マクロがテストに失敗したときに発生します。Common Lisp Extensions の Assertions を参照してください。

coding-system-error

メッセージは ‘Invalid coding system’ です。Lispにおけるコーディングシステムを参照してください。

cyclic-function-indirection

メッセージは ‘Symbol's chain of function indirections contains a loop’ です。シンボル関数間接参照を参照してください。

cyclic-variable-indirection

メッセージは ‘Symbol's chain of variable indirections contains a loop’ です。変数エイリアスを参照してください。

dbus-error

メッセージは ‘D-Bus error’ です。D-Bus integration in Emacs の Errors and Events を参照してください。

end-of-buffer

メッセージは ‘End of buffer’ です。キャラクターによるモーションを参照してください。

end-of-file

メッセージは ‘End of file during parsing’ です。これはファイルI/OではなくLispリーダーに関するものであるため、file-errorのサブカテゴリではないことに注意してください。入力関数を参照してください。

file-already-exists

これは file-error のサブカテゴリです。ファイルへの書き込み を参照してください。

permission-denied

これはfile-errorのサブカテゴリであり、OSが何らかの理由でEmacsによるファイルやディレクトリへのアクセスを許可しない場合に発生します。

file-date-error

これは file-error のサブカテゴリです。copy-file が出力ファイルの最終更新日時を設定しようとして失敗した場合に発生します。ファイル名と属性の変更 を参照してください。

file-error

エラー条件 file-error が存在する場合、エラーメッセージは通常データ項目のみから構成されるため、このエラーおよびそのサブカテゴリのエラー文字列は記載していません。したがって、エラー文字列はあまり重要ではありません。ただし、これらのエラーシンボルは error-message プロパティを持っており、データが提供されない場合は error-message プロパティが使用されます。Files を参照してください。

file-missing

これは file-error のサブカテゴリです。操作が存在しないファイルに対して実行を試みた際に発生します。ファイル名と属性の変更 を参照してください。

compression-error

これはfile-errorのサブカテゴリであり、圧縮ファイルの処理に伴う問題によって発生します。プログラムの読み込みの仕組みを参照してください。

file-locked

これはfile-errorのサブカテゴリです。ファイルロックを参照してください。

file-supersession

これはfile-errorのサブカテゴリです。バッファ変更時刻を参照してください。

file-notify-error

これは file-error のサブカテゴリです。ファイルの変更を監視できなかった場合に発生します。ファイル変更時の通知 を参照してください。

remote-file-error

これは file-error のサブカテゴリであり、リモートファイルへのアクセスに関する問題によって発生します。The GNU Emacs Manual の リモートファイル を参照してください。多くの場合、このエラーは、タイマー、プロセスフィルタ、プロセスセンチネル、あるいは一般的な特殊イベントなどがリモートファイルにアクセスしようとし、別のリモートファイル操作と競合した際に発生します。一般的には、バグレポートを作成することをお勧めします。The GNU Emacs Manual の バグ を参照してください。

ftp-error

これはremote-file-errorのサブカテゴリであり、ftpを用いてリモートファイルにアクセスする際の問題に起因します。The GNU Emacs ManualのRemote Filesを参照してください。

invalid-function

メッセージは ‘Invalid function’ です。シンボル関数間接参照を参照してください。

invalid-read-syntax

メッセージは通常 ‘Invalid read syntax’ となります。印刷表現と読み取り構文を参照してください。また、式の後にテキストが続く場合、eval-expression のようなコマンドによってもこのエラーが発生することがあります。その場合、メッセージは ‘Trailing garbage following expression’ となります。

invalid-regexp

メッセージは ‘Invalid regexp’ です。正規表現を参照してください。

mark-inactive

メッセージは ‘The mark is not active now’ です。The Mark を参照してください。

no-catch

メッセージは ‘No catch for tag’ です。明示的な非ローカル終了: catch および throw を参照してください。

range-error

メッセージは Arithmetic range error です。

overflow-error

メッセージは ‘Arithmetic overflow error’ です。これは range-error のサブカテゴリです。これは、integer-width の制限を超える整数で発生する場合があります。整数の基本を参照してください。

scan-error

メッセージは ‘Scan error’ です。これは、特定の構文解析関数が無効な構文や不一致の括弧を検出した際に発生します。通常、人間が読み取り可能なエラーメッセージ、移動不可能な障害物の開始位置、および障害物の終了位置という3つの引数とともにスローされます。バランス式の移動および式の解析を参照してください。

search-failed

メッセージは ‘Search failed’ です。検索とマッチングを参照してください。

setting-constant

メッセージは ‘Attempt to set a constant symbol’ です。これは、nil、t、most-positive-fixnum、most-negative-fixnum、およびキーワードシンボルに値を代入しようとした際に発生します。また、enable-multibyte-characters や、何らかの理由で直接代入が許可されていないその他の一部のシンボルに値を代入しようとした際にも発生します。不変の変数を参照してください。

text-read-only

メッセージは ‘Text is read-only’ です。これは buffer-read-only のサブカテゴリです。特別な意味を持つプロパティを参照してください。

undefined-color

メッセージは ‘Undefined color’ です。色名を参照してください。

user-error

メッセージは空文字列です。エラーの通知方法を参照してください。

user-search-failed

これは ‘search-failed’ のようなものですが、‘user-error’ とは異なり、デバッガは起動しません。エラーの通知方法および検索とマッチングを参照してください。これはInfoファイル内の検索に使用されます。Infoのテキスト検索を参照してください。

void-function

メッセージは ‘Symbol's function definition is void’ です。関数セルの内容へのアクセスを参照してください。

void-variable

メッセージは ‘Symbol's value as variable is void’ です。変数の値へのアクセスを参照してください。

wrong-number-of-arguments

メッセージは ‘Wrong number of arguments’ です。引数リストの機能を参照してください。

wrong-type-argument

メッセージは ‘Wrong type argument’ です。型述語を参照してください。

unknown-image-type

メッセージは ‘Cannot determine image type’ です。Images を参照してください。

inhibited-interaction

メッセージは ‘User interaction while inhibited’ です。このエラーは、inhibit-interaction が nil ではなく、ユーザーインタラクション関数(read-from-minibuffer など)が呼び出された際に発生します。