Previous: Output Functions, Up: Read and Print
The value of this variable is the default output stream—the stream that print functions use when the stream argument is
nil
.
If this variable is non-
nil
, then newline characters in strings are printed as ‘\n’ and formfeeds are printed as ‘\f’. Normally these characters are printed as actual newlines and formfeeds.This variable affects the print functions
prin1
andprinc
. Here is an example usingprin1
:(prin1 "a\nb") -| "a -| b" => "a b" (let ((print-escape-newlines t)) (prin1 "a\nb")) -| "a\nb" => "a b"In the second expression, the local binding of
print-escape-newlines
is in effect during the call toprin1
, but not during the printing of the result.
If this variable is non-
nil
, then unibyte non-ascii characters in strings are unconditionally printed as backslash sequences by the print functionsprin1
andThose functions also use backslash sequences for unibyte non-ascii characters, regardless of the value of this variable, when the output stream is a multibyte buffer or a marker pointing into one.
If this variable is non-
nil
, then multibyte non-ascii characters in strings are unconditionally printed as backslash sequences by the print functionsprin1
andThose functions also use backslash sequences for multibyte non-ascii characters, regardless of the value of this variable, when the output stream is a unibyte buffer or a marker pointing into one.
The value of this variable is the maximum number of elements to print in any list, vector or bool-vector. If an object being printed has more than this many elements, it is abbreviated with an ellipsis.
If the value is
nil
(the default), then there is no limit.(setq print-length 2) => 2 (print '(1 2 3 4 5)) -| (1 2 ...) => (1 2 ...)
The value of this variable is the maximum depth of nesting of parentheses and brackets when printed. Any list or vector at a depth exceeding this limit is abbreviated with an ellipsis. A value of
nil
(which is the default) means no limit.
These variables are used for detecting and reporting circular and shared structure—but they are only defined in Emacs 21.
If non-
nil
, this variable enables detection of circular and shared structure in printing.
If non-
nil
, this variable enables detection of uninterned symbols (see Creating Symbols) in printing. When this is enabled, uninterned symbols print with the prefix ‘#:’, which tells the Lisp reader to produce an uninterned symbol.