— 機能: perform-replace from-string replacements query-flag regexp-flag delimited-flag &optional repeat-count map

この関数は、query-replaceと関連するコマンドの中身である。 from-stringの出現を探しだし、それらの一部やすべてを置き換える。 query-flagがnilであると、すべての出現を置換する。 さもなければ、1つ1つユーザーにどうするかを問い合わせる。

regexp-flagがnil以外であると、 from-stringを正規表現として扱う。 さもなければ、その字面とおりに一致する。 delimited-flagがnil以外であると、 単語区切りで囲まれたもののみを対象にする。

引数replacementsは、出現を置き換えるものを指定する。 それが文字列であれば、その文字列を使う。 文字列のリストでもよく、要素を巡回して使う。

repeat-countがnil以外であれば、整数であること。 これは、replacementsのリスト内の各文字列を つぎに進めるまえに何回使用するかを指定する。

通常、キーマップquery-replace-mapで、 可能なユーザーの応答を定義する。 引数mapがnil以外であれば、 query-replace-mapのかわりに使うキーマップである。

— 変数: query-replace-map

この変数は、y-or-n-pやmap-y-or-n-pに加えて、 query-replaceや関連する関数に対する 正しいユーザー応答を定義する特別なキーマップを保持する。 2つの意味で普通のものではない。

• 『キーバインディング』はコマンドではなく、 このキーマップを用いる関数にのみ意味がある単なるシンボルである。
• プレフィックスキーは扱えない。 各キーバインディングは単一イベントのキー列である必要がある。 これは、関数では入力を得るためにread-key-sequenceを使わずに、 『自前』でイベントを読み取り探索するからである。