Next: Yanking, Previous: Kill Ring Concepts, Up: The Kill Ring [Contents][Index]
kill-region
は、テキストkill用の通常サブルーチンです。この関数を呼び出すすべてのコマンドは、“killコマンド”です(そして恐らくは名前に‘kill’が含まれる)。kill-region
は新たにkillされたテキストをkillリング内の最初の要素内に置くか、それをもっとも最近の要素に追加します。これは、前のコマンドがkillコマンドか否かを、(last-command
を使用して)自動的に判別し、もしkillコマンドならkillされたテキストをもっとも最近のエントリーに追加します。
この関数は、startとendから定義されるリージョン内のテキストをkillする。そのテキストは削除されるが、そのテキストプロパティと共にkillリングに保存される。値は常にnil
。
インタラクティブな呼び出しでは、startとendは、ポイントとマークになる。
バッファーまたはテキストが読み取り専用なら、kill-region
は同じようにkillリングを変更後に、バッファーを変更せずにエラーをシグナルする。これはユーザーが一連のkillコマンドで、読み取り専用バッファーからkillリングにテキストをコピーするのに有用。
このオプションが非nil
なら、バッファーやテキストが読み取り専用でもkill-region
はエラーをシグナルしない。かわりにバッファーを変更せずにkillリングを更新して単にリターンする。
このコマンドは、killリングにstartとendで定義されるリージョン(テキストプロパティを含む)を保存するが、バッファーからテキストを削除しない。リターン値はnil
。
このコマンドは後続のkillコマンドが同一のkillリングエントリーに追加しないように、this-command
にkill-region
をセットしない。
Lispプログラム内では、このコマンドよりkill-new
やkill-append
を使うほうがよい。Low-Level Kill Ringを参照のこと。