Function: set-buffer

set-buffer is a function defined in buffer.c.

Signature

(set-buffer BUFFER-OR-NAME)

Documentation

Make buffer BUFFER-OR-NAME current for editing operations.

BUFFER-OR-NAME may be a buffer or the name of an existing buffer. See also with-current-buffer when you want to make a buffer current temporarily. This function does not display the buffer, so its effect ends when the current command terminates. Use switch-to-buffer or pop-to-buffer to switch buffers permanently. The return value is the buffer made current.

Probably introduced at or before Emacs version 21.1.

Source Code

// Defined in /usr/src/emacs/src/buffer.c
{
  register Lisp_Object buffer;
  buffer = Fget_buffer (buffer_or_name);
  if (NILP (buffer))
    nsberror (buffer_or_name);
  if (!BUFFER_LIVE_P (XBUFFER (buffer)))
    error ("Selecting deleted buffer");
  set_buffer_internal (XBUFFER (buffer));
  return buffer;
}