This section describes the two primitives for creating buffers.
get-buffer-create creates a buffer if it finds no existing buffer
with the specified name;
generate-new-buffer always creates a new
buffer and gives it a unique name.
Other functions you can use to create buffers include
with-output-to-temp-buffer (see Temporary Displays) and
create-file-buffer (see Visiting Files). Starting a
subprocess can also create a buffer (see Processes).
This function returns a buffer named buffer-or-name. The buffer returned does not become the current buffer—this function does not change which buffer is current.
buffer-or-name must be either a string or an existing buffer. If it is a string and a live buffer with that name already exists,
get-buffer-createreturns that buffer. If no such buffer exists, it creates a new buffer. If buffer-or-name is a buffer instead of a string, it is returned as given, even if it is dead.(get-buffer-create "foo") ⇒ #<buffer foo>
The major mode for a newly created buffer is set to Fundamental mode. (The default value of the variable
major-modeis handled at a higher level; see Auto Major Mode.) If the name begins with a space, the buffer initially disables undo information recording (see Undo).
This function returns a newly created, empty buffer, but does not make it current. If there is no buffer named name, then that is the name of the new buffer. If that name is in use, this function adds suffixes of the form ‘<n>’ to name, where n is an integer. It tries successive integers starting with 2 until it finds an available name.
An error is signaled if name is not a string.(generate-new-buffer "bar") ⇒ #<buffer bar> (generate-new-buffer "bar") ⇒ #<buffer bar<2>> (generate-new-buffer "bar") ⇒ #<buffer bar<3>>
The major mode for the new buffer is set to Fundamental mode. The default value of the variable
major-modeis handled at a higher level. See Auto Major Mode.
See the related function
generate-new-buffer-namein Buffer Names.