term: rework color cutomizing
[bpt/emacs.git] / src / print.c
CommitLineData
38010d50 1/* Lisp object printing and output streams.
95df8112 2
acaf905b 3Copyright (C) 1985-1986, 1988, 1993-1995, 1997-2012
95df8112 4 Free Software Foundation, Inc.
38010d50
JB
5
6This file is part of GNU Emacs.
7
9ec0b715 8GNU Emacs is free software: you can redistribute it and/or modify
38010d50 9it under the terms of the GNU General Public License as published by
9ec0b715
GM
10the Free Software Foundation, either version 3 of the License, or
11(at your option) any later version.
38010d50
JB
12
13GNU Emacs is distributed in the hope that it will be useful,
14but WITHOUT ANY WARRANTY; without even the implied warranty of
15MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16GNU General Public License for more details.
17
18You should have received a copy of the GNU General Public License
9ec0b715 19along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
38010d50
JB
20
21
18160b98 22#include <config.h>
38010d50 23#include <stdio.h>
d7306fe6 24#include <setjmp.h>
38010d50 25#include "lisp.h"
8b4b4467 26#include "character.h"
e5560ff7 27#include "buffer.h"
71ea13cb 28#include "charset.h"
2538fae4 29#include "keyboard.h"
0137dbf7 30#include "frame.h"
38010d50
JB
31#include "window.h"
32#include "process.h"
33#include "dispextern.h"
34#include "termchar.h"
7651e1f5 35#include "intervals.h"
f9467be3 36#include "blockinput.h"
f76c8b1e 37#include "termhooks.h" /* For struct terminal. */
2a7b7982 38#include "font.h"
7651e1f5 39
29208e82 40Lisp_Object Qstandard_output;
38010d50 41
955cbe7b 42static Lisp_Object Qtemp_buffer_setup_hook;
d9c21094 43
2f100b5c 44/* These are used to print like we read. */
2f100b5c 45
955cbe7b 46static Lisp_Object Qfloat_output_format;
f356c3fb 47
f356c3fb 48#include <math.h>
f356c3fb 49#include <float.h>
fa2c4f56 50#include <ftoastr.h>
f356c3fb
PE
51
52/* Default to values appropriate for IEEE floating point. */
f356c3fb
PE
53#ifndef DBL_DIG
54#define DBL_DIG 15
55#endif
f356c3fb 56
38010d50 57/* Avoid actual stack overflow in print. */
a8b7caa3 58static ptrdiff_t print_depth;
38010d50 59
a22dec27 60/* Level of nesting inside outputting backquote in new style. */
a8b7caa3 61static ptrdiff_t new_backquote_output;
0330bb60 62
ec838c39
RS
63/* Detect most circularities to print finite output. */
64#define PRINT_CIRCLE 200
ad64fc97 65static Lisp_Object being_printed[PRINT_CIRCLE];
ec838c39 66
6fec5601
RS
67/* When printing into a buffer, first we put the text in this
68 block, then insert it all at once. */
ad64fc97 69static char *print_buffer;
6fec5601
RS
70
71/* Size allocated in print_buffer. */
d311d28c 72static ptrdiff_t print_buffer_size;
dc2a0b79 73/* Chars stored in print_buffer. */
d311d28c 74static ptrdiff_t print_buffer_pos;
dc2a0b79 75/* Bytes stored in print_buffer. */
d311d28c 76static ptrdiff_t print_buffer_pos_byte;
6fec5601 77
835d0be6 78Lisp_Object Qprint_escape_newlines;
955cbe7b 79static Lisp_Object Qprint_escape_multibyte, Qprint_escape_nonascii;
835d0be6 80
a65b85b5
SM
81/* Vprint_number_table is a table, that keeps objects that are going to
82 be printed, to allow use of #n= and #n# to express sharing.
83 For any given object, the table can give the following values:
84 t the object will be printed only once.
85 -N the object will be printed several times and will take number N.
86 N the object has been printed so we can refer to it as #N#.
87 print_number_index holds the largest N already used.
88 N has to be striclty larger than 0 since we need to distinguish -N. */
a8b7caa3 89static ptrdiff_t print_number_index;
ad64fc97 90static void print_interval (INTERVAL interval, Lisp_Object printcharfun);
38010d50 91
945b0111 92/* GDB resets this to zero on W32 to disable OutputDebugString calls. */
42c8bc9b 93int print_output_debug_flag EXTERNALLY_VISIBLE = 1;
945b0111 94
38010d50 95\f
4ae29f89 96/* Low level output routines for characters and strings. */
38010d50
JB
97
98/* Lisp functions to do output using a stream
081e0581
EN
99 must have the stream in a variable called printcharfun
100 and must start with PRINTPREPARE, end with PRINTFINISH,
101 and use PRINTDECLARE to declare common variables.
102 Use PRINTCHAR to output one character,
4ae29f89 103 or call strout to output a block of characters. */
0788646c
GM
104
105#define PRINTDECLARE \
106 struct buffer *old = current_buffer; \
d311d28c
PE
107 ptrdiff_t old_point = -1, start_point = -1; \
108 ptrdiff_t old_point_byte = -1, start_point_byte = -1; \
109 ptrdiff_t specpdl_count = SPECPDL_INDEX (); \
0788646c 110 int free_print_buffer = 0; \
4b4deea2 111 int multibyte = !NILP (BVAR (current_buffer, enable_multibyte_characters)); \
081e0581
EN
112 Lisp_Object original
113
0788646c
GM
114#define PRINTPREPARE \
115 original = printcharfun; \
116 if (NILP (printcharfun)) printcharfun = Qt; \
117 if (BUFFERP (printcharfun)) \
118 { \
119 if (XBUFFER (printcharfun) != current_buffer) \
120 Fset_buffer (printcharfun); \
121 printcharfun = Qnil; \
122 } \
123 if (MARKERP (printcharfun)) \
124 { \
d311d28c 125 ptrdiff_t marker_pos; \
cd3587c1 126 if (! XMARKER (printcharfun)->buffer) \
0788646c 127 error ("Marker does not point anywhere"); \
1cf21850
LK
128 if (XMARKER (printcharfun)->buffer != current_buffer) \
129 set_buffer_internal (XMARKER (printcharfun)->buffer); \
130 marker_pos = marker_position (printcharfun); \
131 if (marker_pos < BEGV || marker_pos > ZV) \
132 error ("Marker is outside the accessible part of the buffer"); \
0788646c
GM
133 old_point = PT; \
134 old_point_byte = PT_BYTE; \
1cf21850 135 SET_PT_BOTH (marker_pos, \
0788646c
GM
136 marker_byte_position (printcharfun)); \
137 start_point = PT; \
138 start_point_byte = PT_BYTE; \
139 printcharfun = Qnil; \
140 } \
141 if (NILP (printcharfun)) \
142 { \
143 Lisp_Object string; \
4b4deea2 144 if (NILP (BVAR (current_buffer, enable_multibyte_characters)) \
0788646c
GM
145 && ! print_escape_multibyte) \
146 specbind (Qprint_escape_multibyte, Qt); \
4b4deea2 147 if (! NILP (BVAR (current_buffer, enable_multibyte_characters)) \
d39f07c2
RS
148 && ! print_escape_nonascii) \
149 specbind (Qprint_escape_nonascii, Qt); \
0788646c
GM
150 if (print_buffer != 0) \
151 { \
152 string = make_string_from_bytes (print_buffer, \
153 print_buffer_pos, \
154 print_buffer_pos_byte); \
155 record_unwind_protect (print_unwind, string); \
156 } \
157 else \
158 { \
d311d28c 159 int new_size = 1000; \
ff5844ad
PE
160 print_buffer = (char *) xmalloc (new_size); \
161 print_buffer_size = new_size; \
0788646c
GM
162 free_print_buffer = 1; \
163 } \
164 print_buffer_pos = 0; \
165 print_buffer_pos_byte = 0; \
166 } \
5494b50f 167 if (EQ (printcharfun, Qt) && ! noninteractive) \
0f25ecc6 168 setup_echo_area_for_printing (multibyte);
38010d50 169
8a2ab0c6
RS
170#define PRINTFINISH \
171 if (NILP (printcharfun)) \
172 { \
173 if (print_buffer_pos != print_buffer_pos_byte \
4b4deea2 174 && NILP (BVAR (current_buffer, enable_multibyte_characters))) \
8a2ab0c6 175 { \
ee780401
PE
176 unsigned char *temp \
177 = (unsigned char *) alloca (print_buffer_pos + 1); \
09125ef8
PE
178 copy_text ((unsigned char *) print_buffer, temp, \
179 print_buffer_pos_byte, 1, 0); \
b68864e5 180 insert_1_both ((char *) temp, print_buffer_pos, \
8a2ab0c6
RS
181 print_buffer_pos, 0, 1, 0); \
182 } \
183 else \
184 insert_1_both (print_buffer, print_buffer_pos, \
185 print_buffer_pos_byte, 0, 1, 0); \
570fab6c 186 signal_after_change (PT - print_buffer_pos, 0, print_buffer_pos);\
8a2ab0c6
RS
187 } \
188 if (free_print_buffer) \
189 { \
190 xfree (print_buffer); \
191 print_buffer = 0; \
192 } \
193 unbind_to (specpdl_count, Qnil); \
194 if (MARKERP (original)) \
195 set_marker_both (original, Qnil, PT, PT_BYTE); \
196 if (old_point >= 0) \
197 SET_PT_BOTH (old_point + (old_point >= start_point \
198 ? PT - start_point : 0), \
6ddd6eee 199 old_point_byte + (old_point_byte >= start_point_byte \
cd3587c1 200 ? PT_BYTE - start_point_byte : 0)); \
8a2ab0c6 201 if (old != current_buffer) \
0f25ecc6 202 set_buffer_internal (old);
38010d50
JB
203
204#define PRINTCHAR(ch) printchar (ch, printcharfun)
205
08e8d297
RS
206/* This is used to restore the saved contents of print_buffer
207 when there is a recursive call to print. */
0788646c 208
08e8d297 209static Lisp_Object
971de7fb 210print_unwind (Lisp_Object saved_text)
08e8d297 211{
72af86bd 212 memcpy (print_buffer, SDATA (saved_text), SCHARS (saved_text));
ee5263af 213 return Qnil;
08e8d297
RS
214}
215
0788646c
GM
216
217/* Print character CH using method FUN. FUN nil means print to
218 print_buffer. FUN t means print to echo area or stdout if
219 non-interactive. If FUN is neither nil nor t, call FUN with CH as
220 argument. */
38010d50
JB
221
222static void
971de7fb 223printchar (unsigned int ch, Lisp_Object fun)
38010d50 224{
0788646c
GM
225 if (!NILP (fun) && !EQ (fun, Qt))
226 call1 (fun, make_number (ch));
227 else
38010d50 228 {
19a86a03
KH
229 unsigned char str[MAX_MULTIBYTE_LENGTH];
230 int len = CHAR_STRING (ch, str);
231
09eddb56 232 QUIT;
177c0ea7 233
0788646c 234 if (NILP (fun))
9a4d01d8 235 {
d311d28c
PE
236 ptrdiff_t incr = len - (print_buffer_size - print_buffer_pos_byte);
237 if (0 < incr)
238 print_buffer =
239 xpalloc (print_buffer, &print_buffer_size, incr, -1, 1);
72af86bd 240 memcpy (print_buffer + print_buffer_pos_byte, str, len);
0788646c
GM
241 print_buffer_pos += 1;
242 print_buffer_pos_byte += len;
9a4d01d8 243 }
0788646c 244 else if (noninteractive)
1134b854 245 {
0788646c
GM
246 fwrite (str, 1, len, stdout);
247 noninteractive_need_newline = 1;
1134b854 248 }
0788646c 249 else
d366d2e4 250 {
0788646c 251 int multibyte_p
4b4deea2 252 = !NILP (BVAR (current_buffer, enable_multibyte_characters));
177c0ea7 253
eb7b678b 254 setup_echo_area_for_printing (multibyte_p);
0788646c 255 insert_char (ch);
09125ef8 256 message_dolog ((char *) str, len, 0, multibyte_p);
d366d2e4 257 }
38010d50 258 }
38010d50
JB
259}
260
0788646c
GM
261
262/* Output SIZE characters, SIZE_BYTE bytes from string PTR using
263 method PRINTCHARFUN. If SIZE < 0, use the string length of PTR for
264 both SIZE and SIZE_BYTE. PRINTCHARFUN nil means output to
265 print_buffer. PRINTCHARFUN t means output to the echo area or to
266 stdout if non-interactive. If neither nil nor t, call Lisp
267 function PRINTCHARFUN for each character printed. MULTIBYTE
efb15f96
RS
268 non-zero means PTR contains multibyte characters.
269
270 In the case where PRINTCHARFUN is nil, it is safe for PTR to point
271 to data in a Lisp string. Otherwise that is not safe. */
0788646c 272
38010d50 273static void
d311d28c 274strout (const char *ptr, ptrdiff_t size, ptrdiff_t size_byte,
1db5b1ad 275 Lisp_Object printcharfun)
38010d50 276{
087e3c46 277 if (size < 0)
dc2a0b79 278 size_byte = size = strlen (ptr);
087e3c46 279
0788646c 280 if (NILP (printcharfun))
38010d50 281 {
d311d28c
PE
282 ptrdiff_t incr = size_byte - (print_buffer_size - print_buffer_pos_byte);
283 if (0 < incr)
284 print_buffer = xpalloc (print_buffer, &print_buffer_size, incr, -1, 1);
72af86bd 285 memcpy (print_buffer + print_buffer_pos_byte, ptr, size_byte);
6fec5601 286 print_buffer_pos += size;
dc2a0b79 287 print_buffer_pos_byte += size_byte;
38010d50 288 }
7b0cb8a0 289 else if (noninteractive && EQ (printcharfun, Qt))
38010d50 290 {
0788646c
GM
291 fwrite (ptr, 1, size_byte, stdout);
292 noninteractive_need_newline = 1;
293 }
294 else if (EQ (printcharfun, Qt))
295 {
296 /* Output to echo area. We're trying to avoid a little overhead
297 here, that's the reason we don't call printchar to do the
298 job. */
299 int i;
300 int multibyte_p
4b4deea2 301 = !NILP (BVAR (current_buffer, enable_multibyte_characters));
177c0ea7 302
eb7b678b 303 setup_echo_area_for_printing (multibyte_p);
0788646c 304 message_dolog (ptr, size_byte, 0, multibyte_p);
177c0ea7 305
0788646c 306 if (size == size_byte)
38010d50 307 {
0788646c 308 for (i = 0; i < size; ++i)
bcdbfd36 309 insert_char ((unsigned char) *ptr++);
38010d50 310 }
0788646c 311 else
38010d50 312 {
0788646c
GM
313 int len;
314 for (i = 0; i < size_byte; i += len)
aec2b95b 315 {
09125ef8
PE
316 int ch = STRING_CHAR_AND_LENGTH ((const unsigned char *) ptr + i,
317 len);
0788646c 318 insert_char (ch);
aec2b95b 319 }
38010d50 320 }
0788646c
GM
321 }
322 else
323 {
324 /* PRINTCHARFUN is a Lisp function. */
d311d28c 325 ptrdiff_t i = 0;
38010d50 326
0788646c 327 if (size == size_byte)
4ad8bb20 328 {
0788646c 329 while (i < size_byte)
4ad8bb20 330 {
0788646c
GM
331 int ch = ptr[i++];
332 PRINTCHAR (ch);
4ad8bb20 333 }
4ad8bb20 334 }
0788646c 335 else
087e3c46 336 {
0788646c
GM
337 while (i < size_byte)
338 {
339 /* Here, we must convert each multi-byte form to the
340 corresponding character code before handing it to
341 PRINTCHAR. */
342 int len;
09125ef8
PE
343 int ch = STRING_CHAR_AND_LENGTH ((const unsigned char *) ptr + i,
344 len);
0788646c
GM
345 PRINTCHAR (ch);
346 i += len;
347 }
087e3c46 348 }
38010d50 349 }
38010d50
JB
350}
351
352/* Print the contents of a string STRING using PRINTCHARFUN.
ed2c35ef
RS
353 It isn't safe to use strout in many cases,
354 because printing one char can relocate. */
38010d50 355
dc2a0b79 356static void
971de7fb 357print_string (Lisp_Object string, Lisp_Object printcharfun)
38010d50 358{
6fec5601 359 if (EQ (printcharfun, Qt) || NILP (printcharfun))
375fcc09 360 {
d311d28c 361 ptrdiff_t chars;
375fcc09 362
8b4b4467
KH
363 if (print_escape_nonascii)
364 string = string_escape_byte8 (string);
365
375fcc09 366 if (STRING_MULTIBYTE (string))
d5db4077 367 chars = SCHARS (string);
8b4b4467
KH
368 else if (! print_escape_nonascii
369 && (EQ (printcharfun, Qt)
4b4deea2
TT
370 ? ! NILP (BVAR (&buffer_defaults, enable_multibyte_characters))
371 : ! NILP (BVAR (current_buffer, enable_multibyte_characters))))
a76ef35d
KH
372 {
373 /* If unibyte string STRING contains 8-bit codes, we must
374 convert STRING to a multibyte string containing the same
375 character codes. */
376 Lisp_Object newstr;
d311d28c 377 ptrdiff_t bytes;
a76ef35d 378
d5db4077 379 chars = SBYTES (string);
de883a70 380 bytes = count_size_as_multibyte (SDATA (string), chars);
a76ef35d
KH
381 if (chars < bytes)
382 {
383 newstr = make_uninit_multibyte_string (chars, bytes);
72af86bd 384 memcpy (SDATA (newstr), SDATA (string), chars);
d5db4077 385 str_to_multibyte (SDATA (newstr), bytes, chars);
a76ef35d
KH
386 string = newstr;
387 }
388 }
375fcc09 389 else
d5db4077 390 chars = SBYTES (string);
375fcc09 391
efb15f96
RS
392 if (EQ (printcharfun, Qt))
393 {
394 /* Output to echo area. */
d311d28c 395 ptrdiff_t nbytes = SBYTES (string);
efb15f96
RS
396 char *buffer;
397
398 /* Copy the string contents so that relocation of STRING by
399 GC does not cause trouble. */
400 USE_SAFE_ALLOCA;
401
402 SAFE_ALLOCA (buffer, char *, nbytes);
72af86bd 403 memcpy (buffer, SDATA (string), nbytes);
efb15f96 404
1db5b1ad 405 strout (buffer, chars, SBYTES (string), printcharfun);
efb15f96
RS
406
407 SAFE_FREE ();
408 }
409 else
410 /* No need to copy, since output to print_buffer can't GC. */
1db5b1ad 411 strout (SSDATA (string), chars, SBYTES (string), printcharfun);
375fcc09 412 }
38010d50
JB
413 else
414 {
dc2a0b79
RS
415 /* Otherwise, string may be relocated by printing one char.
416 So re-fetch the string address for each character. */
d311d28c
PE
417 ptrdiff_t i;
418 ptrdiff_t size = SCHARS (string);
419 ptrdiff_t size_byte = SBYTES (string);
38010d50
JB
420 struct gcpro gcpro1;
421 GCPRO1 (string);
dc2a0b79
RS
422 if (size == size_byte)
423 for (i = 0; i < size; i++)
d5db4077 424 PRINTCHAR (SREF (string, i));
dc2a0b79 425 else
6b61353c 426 for (i = 0; i < size_byte; )
dc2a0b79
RS
427 {
428 /* Here, we must convert each multi-byte form to the
429 corresponding character code before handing it to PRINTCHAR. */
430 int len;
62a6e103 431 int ch = STRING_CHAR_AND_LENGTH (SDATA (string) + i, len);
dc2a0b79
RS
432 PRINTCHAR (ch);
433 i += len;
434 }
38010d50
JB
435 UNGCPRO;
436 }
437}
438\f
439DEFUN ("write-char", Fwrite_char, Swrite_char, 1, 2, 0,
8c1a1077
PJ
440 doc: /* Output character CHARACTER to stream PRINTCHARFUN.
441PRINTCHARFUN defaults to the value of `standard-output' (which see). */)
5842a27b 442 (Lisp_Object character, Lisp_Object printcharfun)
38010d50 443{
081e0581 444 PRINTDECLARE;
38010d50 445
10eebdbb 446 if (NILP (printcharfun))
38010d50 447 printcharfun = Vstandard_output;
b7826503 448 CHECK_NUMBER (character);
38010d50 449 PRINTPREPARE;
3738a371 450 PRINTCHAR (XINT (character));
38010d50 451 PRINTFINISH;
3738a371 452 return character;
38010d50
JB
453}
454
dc2a0b79
RS
455/* Used from outside of print.c to print a block of SIZE
456 single-byte chars at DATA on the default output stream.
38010d50
JB
457 Do not use this on the contents of a Lisp string. */
458
dc22f25e 459void
a8fe7202 460write_string (const char *data, int size)
38010d50 461{
081e0581 462 PRINTDECLARE;
38010d50 463 Lisp_Object printcharfun;
38010d50
JB
464
465 printcharfun = Vstandard_output;
466
467 PRINTPREPARE;
1db5b1ad 468 strout (data, size, size, printcharfun);
38010d50
JB
469 PRINTFINISH;
470}
471
2f7c71a1
AS
472/* Used to print a block of SIZE single-byte chars at DATA on a
473 specified stream PRINTCHARFUN.
38010d50
JB
474 Do not use this on the contents of a Lisp string. */
475
2f7c71a1 476static void
a8fe7202 477write_string_1 (const char *data, int size, Lisp_Object printcharfun)
38010d50 478{
081e0581 479 PRINTDECLARE;
38010d50
JB
480
481 PRINTPREPARE;
1db5b1ad 482 strout (data, size, size, printcharfun);
38010d50
JB
483 PRINTFINISH;
484}
485
486
38010d50 487void
971de7fb 488temp_output_buffer_setup (const char *bufname)
38010d50 489{
d311d28c 490 ptrdiff_t count = SPECPDL_INDEX ();
38010d50
JB
491 register struct buffer *old = current_buffer;
492 register Lisp_Object buf;
493
d9c21094
RS
494 record_unwind_protect (set_buffer_if_live, Fcurrent_buffer ());
495
38010d50
JB
496 Fset_buffer (Fget_buffer_create (build_string (bufname)));
497
9756ea0f 498 Fkill_all_local_variables ();
fd531951 499 delete_all_overlays (current_buffer);
4b4deea2
TT
500 BVAR (current_buffer, directory) = BVAR (old, directory);
501 BVAR (current_buffer, read_only) = Qnil;
502 BVAR (current_buffer, filename) = Qnil;
503 BVAR (current_buffer, undo_list) = Qt;
b3f6010e
SM
504 eassert (current_buffer->overlays_before == NULL);
505 eassert (current_buffer->overlays_after == NULL);
4b4deea2
TT
506 BVAR (current_buffer, enable_multibyte_characters)
507 = BVAR (&buffer_defaults, enable_multibyte_characters);
d28eab19
KH
508 specbind (Qinhibit_read_only, Qt);
509 specbind (Qinhibit_modification_hooks, Qt);
38010d50 510 Ferase_buffer ();
633307b5 511 XSETBUFFER (buf, current_buffer);
38010d50 512
98040cf1 513 Frun_hooks (1, &Qtemp_buffer_setup_hook);
d9c21094
RS
514
515 unbind_to (count, Qnil);
516
517 specbind (Qstandard_output, buf);
38010d50 518}
38010d50 519\f
971de7fb
DN
520static void print (Lisp_Object obj, register Lisp_Object printcharfun, int escapeflag);
521static void print_preprocess (Lisp_Object obj);
522static void print_preprocess_string (INTERVAL interval, Lisp_Object arg);
523static void print_object (Lisp_Object obj, register Lisp_Object printcharfun, int escapeflag);
38010d50 524
a7ca3326 525DEFUN ("terpri", Fterpri, Sterpri, 0, 1, 0,
8c1a1077
PJ
526 doc: /* Output a newline to stream PRINTCHARFUN.
527If PRINTCHARFUN is omitted or nil, the value of `standard-output' is used. */)
5842a27b 528 (Lisp_Object printcharfun)
38010d50 529{
081e0581 530 PRINTDECLARE;
38010d50 531
10eebdbb 532 if (NILP (printcharfun))
38010d50
JB
533 printcharfun = Vstandard_output;
534 PRINTPREPARE;
535 PRINTCHAR ('\n');
536 PRINTFINISH;
537 return Qt;
538}
539
a7ca3326 540DEFUN ("prin1", Fprin1, Sprin1, 1, 2, 0,
8c1a1077
PJ
541 doc: /* Output the printed representation of OBJECT, any Lisp object.
542Quoting characters are printed when needed to make output that `read'
9474c847 543can handle, whenever this is possible. For complex objects, the behavior
7fab9223 544is controlled by `print-level' and `print-length', which see.
8c1a1077
PJ
545
546OBJECT is any of the Lisp data types: a number, a string, a symbol,
547a list, a buffer, a window, a frame, etc.
548
549A printed representation of an object is text which describes that object.
550
551Optional argument PRINTCHARFUN is the output stream, which can be one
552of these:
553
554 - a buffer, in which case output is inserted into that buffer at point;
555 - a marker, in which case output is inserted at marker's position;
556 - a function, in which case that function is called once for each
557 character of OBJECT's printed representation;
558 - a symbol, in which case that symbol's function definition is called; or
559 - t, in which case the output is displayed in the echo area.
560
561If PRINTCHARFUN is omitted, the value of `standard-output' (which see)
562is used instead. */)
5842a27b 563 (Lisp_Object object, Lisp_Object printcharfun)
38010d50 564{
081e0581 565 PRINTDECLARE;
38010d50 566
10eebdbb 567 if (NILP (printcharfun))
38010d50
JB
568 printcharfun = Vstandard_output;
569 PRINTPREPARE;
3738a371 570 print (object, printcharfun, 1);
38010d50 571 PRINTFINISH;
3738a371 572 return object;
38010d50
JB
573}
574
575/* a buffer which is used to hold output being built by prin1-to-string */
576Lisp_Object Vprin1_to_string_buffer;
577
a7ca3326 578DEFUN ("prin1-to-string", Fprin1_to_string, Sprin1_to_string, 1, 2, 0,
fd4d156b
RS
579 doc: /* Return a string containing the printed representation of OBJECT.
580OBJECT can be any Lisp object. This function outputs quoting characters
cf393f9b 581when necessary to make output that `read' can handle, whenever possible,
a2612656
EZ
582unless the optional second argument NOESCAPE is non-nil. For complex objects,
583the behavior is controlled by `print-level' and `print-length', which see.
8c1a1077
PJ
584
585OBJECT is any of the Lisp data types: a number, a string, a symbol,
586a list, a buffer, a window, a frame, etc.
587
588A printed representation of an object is text which describes that object. */)
5842a27b 589 (Lisp_Object object, Lisp_Object noescape)
38010d50 590{
081e0581 591 Lisp_Object printcharfun;
ca2de342
RS
592 /* struct gcpro gcpro1, gcpro2; */
593 Lisp_Object save_deactivate_mark;
d311d28c 594 ptrdiff_t count = SPECPDL_INDEX ();
6b61353c 595 struct buffer *previous;
ca2de342
RS
596
597 specbind (Qinhibit_modification_hooks, Qt);
2a42e8f6 598
6b61353c
KH
599 {
600 PRINTDECLARE;
601
602 /* Save and restore this--we are altering a buffer
603 but we don't want to deactivate the mark just for that.
604 No need for specbind, since errors deactivate the mark. */
605 save_deactivate_mark = Vdeactivate_mark;
606 /* GCPRO2 (object, save_deactivate_mark); */
607 abort_on_gc++;
608
609 printcharfun = Vprin1_to_string_buffer;
610 PRINTPREPARE;
611 print (object, printcharfun, NILP (noescape));
6196cffe 612 /* Make Vprin1_to_string_buffer be the default buffer after PRINTFINISH */
6b61353c
KH
613 PRINTFINISH;
614 }
38010d50 615
6b61353c 616 previous = current_buffer;
38010d50 617 set_buffer_internal (XBUFFER (Vprin1_to_string_buffer));
3738a371 618 object = Fbuffer_string ();
b51ee131
SM
619 if (SBYTES (object) == SCHARS (object))
620 STRING_SET_UNIBYTE (object);
38010d50 621
28b8f740 622 /* Note that this won't make prepare_to_modify_buffer call
6b61353c
KH
623 ask-user-about-supersession-threat because this buffer
624 does not visit a file. */
38010d50 625 Ferase_buffer ();
6b61353c 626 set_buffer_internal (previous);
2a42e8f6 627
ca2de342
RS
628 Vdeactivate_mark = save_deactivate_mark;
629 /* UNGCPRO; */
38010d50 630
ca2de342
RS
631 abort_on_gc--;
632 return unbind_to (count, object);
38010d50
JB
633}
634
ad64fc97 635DEFUN ("princ", Fprinc, Sprinc, 1, 2, 0,
8c1a1077
PJ
636 doc: /* Output the printed representation of OBJECT, any Lisp object.
637No quoting characters are used; no delimiters are printed around
638the contents of strings.
639
640OBJECT is any of the Lisp data types: a number, a string, a symbol,
641a list, a buffer, a window, a frame, etc.
642
643A printed representation of an object is text which describes that object.
644
645Optional argument PRINTCHARFUN is the output stream, which can be one
646of these:
647
648 - a buffer, in which case output is inserted into that buffer at point;
649 - a marker, in which case output is inserted at marker's position;
650 - a function, in which case that function is called once for each
651 character of OBJECT's printed representation;
652 - a symbol, in which case that symbol's function definition is called; or
653 - t, in which case the output is displayed in the echo area.
654
655If PRINTCHARFUN is omitted, the value of `standard-output' (which see)
656is used instead. */)
5842a27b 657 (Lisp_Object object, Lisp_Object printcharfun)
38010d50 658{
081e0581 659 PRINTDECLARE;
38010d50 660
10eebdbb 661 if (NILP (printcharfun))
38010d50
JB
662 printcharfun = Vstandard_output;
663 PRINTPREPARE;
3738a371 664 print (object, printcharfun, 0);
38010d50 665 PRINTFINISH;
3738a371 666 return object;
38010d50
JB
667}
668
a7ca3326 669DEFUN ("print", Fprint, Sprint, 1, 2, 0,
8c1a1077
PJ
670 doc: /* Output the printed representation of OBJECT, with newlines around it.
671Quoting characters are printed when needed to make output that `read'
9474c847 672can handle, whenever this is possible. For complex objects, the behavior
7fab9223 673is controlled by `print-level' and `print-length', which see.
8c1a1077
PJ
674
675OBJECT is any of the Lisp data types: a number, a string, a symbol,
676a list, a buffer, a window, a frame, etc.
677
678A printed representation of an object is text which describes that object.
679
680Optional argument PRINTCHARFUN is the output stream, which can be one
681of these:
682
683 - a buffer, in which case output is inserted into that buffer at point;
684 - a marker, in which case output is inserted at marker's position;
685 - a function, in which case that function is called once for each
686 character of OBJECT's printed representation;
687 - a symbol, in which case that symbol's function definition is called; or
688 - t, in which case the output is displayed in the echo area.
689
690If PRINTCHARFUN is omitted, the value of `standard-output' (which see)
691is used instead. */)
5842a27b 692 (Lisp_Object object, Lisp_Object printcharfun)
38010d50 693{
081e0581 694 PRINTDECLARE;
38010d50
JB
695 struct gcpro gcpro1;
696
10eebdbb 697 if (NILP (printcharfun))
38010d50 698 printcharfun = Vstandard_output;
3738a371 699 GCPRO1 (object);
38010d50 700 PRINTPREPARE;
38010d50 701 PRINTCHAR ('\n');
3738a371 702 print (object, printcharfun, 1);
38010d50
JB
703 PRINTCHAR ('\n');
704 PRINTFINISH;
38010d50 705 UNGCPRO;
3738a371 706 return object;
38010d50
JB
707}
708
709/* The subroutine object for external-debugging-output is kept here
710 for the convenience of the debugger. */
711Lisp_Object Qexternal_debugging_output;
712
4746118a 713DEFUN ("external-debugging-output", Fexternal_debugging_output, Sexternal_debugging_output, 1, 1, 0,
8c1a1077
PJ
714 doc: /* Write CHARACTER to stderr.
715You can call print while debugging emacs, and pass it this function
716to make it write to the debugging output. */)
5842a27b 717 (Lisp_Object character)
38010d50 718{
0fd11aa5
PE
719 CHECK_NUMBER (character);
720 putc (XINT (character) & 0xFF, stderr);
cd22039d
RS
721
722#ifdef WINDOWSNT
723 /* Send the output to a debugger (nothing happens if there isn't one). */
945b0111
EZ
724 if (print_output_debug_flag)
725 {
726 char buf[2] = {(char) XINT (character), '\0'};
727 OutputDebugString (buf);
728 }
cd22039d
RS
729#endif
730
38010d50
JB
731 return character;
732}
cf1bb91b 733
c33f8948
RS
734/* This function is never called. Its purpose is to prevent
735 print_output_debug_flag from being optimized away. */
736
c38bf546 737extern void debug_output_compilation_hack (int) EXTERNALLY_VISIBLE;
dae581bf 738void
971de7fb 739debug_output_compilation_hack (int x)
c33f8948
RS
740{
741 print_output_debug_flag = x;
742}
6b61353c 743
cd3587c1 744#if defined (GNU_LINUX)
6b61353c
KH
745
746/* This functionality is not vitally important in general, so we rely on
747 non-portable ability to use stderr as lvalue. */
748
749#define WITH_REDIRECT_DEBUGGING_OUTPUT 1
750
ad64fc97 751static FILE *initial_stderr_stream = NULL;
6b61353c
KH
752
753DEFUN ("redirect-debugging-output", Fredirect_debugging_output, Sredirect_debugging_output,
754 1, 2,
755 "FDebug output file: \nP",
756 doc: /* Redirect debugging output (stderr stream) to file FILE.
757If FILE is nil, reset target to the initial stderr stream.
758Optional arg APPEND non-nil (interactively, with prefix arg) means
28b8f740 759append to existing target file. */)
5842a27b 760 (Lisp_Object file, Lisp_Object append)
6b61353c
KH
761{
762 if (initial_stderr_stream != NULL)
f9467be3
YM
763 {
764 BLOCK_INPUT;
765 fclose (stderr);
766 UNBLOCK_INPUT;
767 }
6b61353c
KH
768 stderr = initial_stderr_stream;
769 initial_stderr_stream = NULL;
770
771 if (STRINGP (file))
772 {
773 file = Fexpand_file_name (file, Qnil);
774 initial_stderr_stream = stderr;
d4d7173a 775 stderr = fopen (SSDATA (file), NILP (append) ? "w" : "a");
6b61353c
KH
776 if (stderr == NULL)
777 {
778 stderr = initial_stderr_stream;
779 initial_stderr_stream = NULL;
780 report_file_error ("Cannot open debugging output stream",
781 Fcons (file, Qnil));
782 }
783 }
784 return Qnil;
785}
786#endif /* GNU_LINUX */
787
788
cf1bb91b
RS
789/* This is the interface for debugging printing. */
790
791void
971de7fb 792debug_print (Lisp_Object arg)
cf1bb91b
RS
793{
794 Fprin1 (arg, Qexternal_debugging_output);
3684eb78 795 fprintf (stderr, "\r\n");
cf1bb91b 796}
bd90dcd0 797
e3b27b31 798void safe_debug_print (Lisp_Object) EXTERNALLY_VISIBLE;
bd90dcd0 799void
971de7fb 800safe_debug_print (Lisp_Object arg)
bd90dcd0
KS
801{
802 int valid = valid_lisp_object_p (arg);
803
804 if (valid > 0)
805 debug_print (arg);
806 else
c2982e87 807 fprintf (stderr, "#<%s_LISP_OBJECT 0x%08"pI"x>\r\n",
bd90dcd0 808 !valid ? "INVALID" : "SOME",
c2982e87 809 XHASH (arg));
bd90dcd0
KS
810}
811
38010d50 812\f
a7ca3326 813DEFUN ("error-message-string", Ferror_message_string, Serror_message_string,
113620cc 814 1, 1, 0,
6b61353c
KH
815 doc: /* Convert an error value (ERROR-SYMBOL . DATA) to an error message.
816See Info anchor `(elisp)Definition of signal' for some details on how this
817error message is constructed. */)
5842a27b 818 (Lisp_Object obj)
113620cc
KH
819{
820 struct buffer *old = current_buffer;
63fbf4ff 821 Lisp_Object value;
113620cc
KH
822 struct gcpro gcpro1;
823
0872e11f
RS
824 /* If OBJ is (error STRING), just return STRING.
825 That is not only faster, it also avoids the need to allocate
826 space here when the error is due to memory full. */
94b342ce
KR
827 if (CONSP (obj) && EQ (XCAR (obj), Qerror)
828 && CONSP (XCDR (obj))
829 && STRINGP (XCAR (XCDR (obj)))
830 && NILP (XCDR (XCDR (obj))))
831 return XCAR (XCDR (obj));
0872e11f 832
240e806c 833 print_error_message (obj, Vprin1_to_string_buffer, 0, Qnil);
113620cc
KH
834
835 set_buffer_internal (XBUFFER (Vprin1_to_string_buffer));
836 value = Fbuffer_string ();
837
838 GCPRO1 (value);
839 Ferase_buffer ();
840 set_buffer_internal (old);
841 UNGCPRO;
842
843 return value;
844}
845
c02279de 846/* Print an error message for the error DATA onto Lisp output stream
7ab56fea
RS
847 STREAM (suitable for the print functions).
848 CONTEXT is a C string describing the context of the error.
849 CALLER is the Lisp function inside which the error was signaled. */
113620cc 850
dc22f25e 851void
a8fe7202
AS
852print_error_message (Lisp_Object data, Lisp_Object stream, const char *context,
853 Lisp_Object caller)
113620cc
KH
854{
855 Lisp_Object errname, errmsg, file_error, tail;
856 struct gcpro gcpro1;
113620cc 857
240e806c
RS
858 if (context != 0)
859 write_string_1 (context, -1, stream);
860
861 /* If we know from where the error was signaled, show it in
862 *Messages*. */
863 if (!NILP (caller) && SYMBOLP (caller))
864 {
11fb15d5 865 Lisp_Object cname = SYMBOL_NAME (caller);
d311d28c
PE
866 char *name;
867 USE_SAFE_ALLOCA;
868 SAFE_ALLOCA (name, char *, SBYTES (cname));
72af86bd 869 memcpy (name, SDATA (cname), SBYTES (cname));
826256dd 870 message_dolog (name, SBYTES (cname), 0, 0);
240e806c 871 message_dolog (": ", 2, 0, 0);
d311d28c 872 SAFE_FREE ();
240e806c
RS
873 }
874
113620cc
KH
875 errname = Fcar (data);
876
877 if (EQ (errname, Qerror))
878 {
879 data = Fcdr (data);
c02279de
GM
880 if (!CONSP (data))
881 data = Qnil;
113620cc
KH
882 errmsg = Fcar (data);
883 file_error = Qnil;
884 }
885 else
886 {
71873e2b 887 Lisp_Object error_conditions = Fget (errname, Qerror_conditions);
113620cc 888 errmsg = Fget (errname, Qerror_message);
c02279de 889 file_error = Fmemq (Qfile_error, error_conditions);
113620cc
KH
890 }
891
892 /* Print an error message including the data items. */
893
894 tail = Fcdr_safe (data);
895 GCPRO1 (tail);
896
897 /* For file-error, make error message by concatenating
898 all the data items. They are all strings. */
8c29413d 899 if (!NILP (file_error) && CONSP (tail))
94b342ce 900 errmsg = XCAR (tail), tail = XCDR (tail);
113620cc 901
71873e2b
SM
902 {
903 const char *sep = ": ";
904
905 if (!STRINGP (errmsg))
906 write_string_1 ("peculiar error", -1, stream);
907 else if (SCHARS (errmsg))
908 Fprinc (errmsg, stream);
909 else
910 sep = NULL;
911
912 for (; CONSP (tail); tail = XCDR (tail), sep = ", ")
913 {
914 Lisp_Object obj;
99027bdd 915
71873e2b
SM
916 if (sep)
917 write_string_1 (sep, 2, stream);
918 obj = XCAR (tail);
919 if (!NILP (file_error)
920 || EQ (errname, Qend_of_file) || EQ (errname, Quser_error))
921 Fprinc (obj, stream);
922 else
923 Fprin1 (obj, stream);
924 }
925 }
177c0ea7 926
113620cc
KH
927 UNGCPRO;
928}
38010d50 929
c02279de
GM
930
931\f
38010d50 932/*
edb2a707 933 * The buffer should be at least as large as the max string size of the
8e6208c5 934 * largest float, printed in the biggest notation. This is undoubtedly
38010d50
JB
935 * 20d float_output_format, with the negative of the C-constant "HUGE"
936 * from <math.h>.
177c0ea7 937 *
38010d50 938 * On the vax the worst case is -1e38 in 20d format which takes 61 bytes.
177c0ea7 939 *
38010d50
JB
940 * I assume that IEEE-754 format numbers can take 329 bytes for the worst
941 * case of -1e307 in 20d float_output_format. What is one to do (short of
942 * re-writing _doprnt to be more sane)?
943 * -wsr
6e8e6bf2 944 * Given the above, the buffer must be least FLOAT_TO_STRING_BUFSIZE bytes.
38010d50 945 */
edb2a707 946
99027bdd 947int
57ace6d0 948float_to_string (char *buf, double data)
38010d50 949{
57ace6d0 950 char *cp;
322890c4 951 int width;
99027bdd 952 int len;
177c0ea7 953
7f45de2d
RS
954 /* Check for plus infinity in a way that won't lose
955 if there is no plus infinity. */
956 if (data == data / 2 && data > 1.0)
957 {
99027bdd
PE
958 static char const infinity_string[] = "1.0e+INF";
959 strcpy (buf, infinity_string);
960 return sizeof infinity_string - 1;
7f45de2d
RS
961 }
962 /* Likewise for minus infinity. */
963 if (data == data / 2 && data < -1.0)
964 {
99027bdd
PE
965 static char const minus_infinity_string[] = "-1.0e+INF";
966 strcpy (buf, minus_infinity_string);
967 return sizeof minus_infinity_string - 1;
7f45de2d
RS
968 }
969 /* Check for NaN in a way that won't fail if there are no NaNs. */
970 if (! (data * 0.0 >= 0.0))
971 {
68c45bf0
PE
972 /* Prepend "-" if the NaN's sign bit is negative.
973 The sign bit of a double is the bit that is 1 in -0.0. */
99027bdd 974 static char const NaN_string[] = "0.0e+NaN";
68c45bf0
PE
975 int i;
976 union { double d; char c[sizeof (double)]; } u_data, u_minus_zero;
99027bdd 977 int negative = 0;
68c45bf0
PE
978 u_data.d = data;
979 u_minus_zero.d = - 0.0;
980 for (i = 0; i < sizeof (double); i++)
981 if (u_data.c[i] & u_minus_zero.c[i])
982 {
99027bdd
PE
983 *buf = '-';
984 negative = 1;
68c45bf0
PE
985 break;
986 }
177c0ea7 987
99027bdd
PE
988 strcpy (buf + negative, NaN_string);
989 return negative + sizeof NaN_string - 1;
7f45de2d
RS
990 }
991
10eebdbb 992 if (NILP (Vfloat_output_format)
d4ae1f7e 993 || !STRINGP (Vfloat_output_format))
38010d50 994 lose:
322890c4 995 {
f356c3fb 996 /* Generate the fewest number of digits that represent the
6e8e6bf2 997 floating point value without losing information. */
99027bdd 998 len = dtoastr (buf, FLOAT_TO_STRING_BUFSIZE - 2, 0, 0, data);
75b43359
MWD
999 /* The decimal point must be printed, or the byte compiler can
1000 get confused (Bug#8033). */
1001 width = 1;
322890c4 1002 }
38010d50
JB
1003 else /* oink oink */
1004 {
1005 /* Check that the spec we have is fully valid.
1006 This means not only valid for printf,
1007 but meant for floats, and reasonable. */
57ace6d0 1008 cp = SSDATA (Vfloat_output_format);
38010d50
JB
1009
1010 if (cp[0] != '%')
1011 goto lose;
1012 if (cp[1] != '.')
1013 goto lose;
1014
1015 cp += 2;
c7b14277
JB
1016
1017 /* Check the width specification. */
322890c4 1018 width = -1;
c7b14277 1019 if ('0' <= *cp && *cp <= '9')
381cd4bb
KH
1020 {
1021 width = 0;
1022 do
aca216ff
PE
1023 {
1024 width = (width * 10) + (*cp++ - '0');
1025 if (DBL_DIG < width)
1026 goto lose;
1027 }
381cd4bb
KH
1028 while (*cp >= '0' && *cp <= '9');
1029
1030 /* A precision of zero is valid only for %f. */
aca216ff 1031 if (width == 0 && *cp != 'f')
381cd4bb
KH
1032 goto lose;
1033 }
38010d50
JB
1034
1035 if (*cp != 'e' && *cp != 'f' && *cp != 'g')
1036 goto lose;
1037
38010d50
JB
1038 if (cp[1] != 0)
1039 goto lose;
1040
99027bdd 1041 len = sprintf (buf, SSDATA (Vfloat_output_format), data);
38010d50 1042 }
edb2a707 1043
c7b14277
JB
1044 /* Make sure there is a decimal point with digit after, or an
1045 exponent, so that the value is readable as a float. But don't do
322890c4
RS
1046 this with "%.0f"; it's valid for that not to produce a decimal
1047 point. Note that width can be 0 only for %.0f. */
1048 if (width != 0)
0601fd3d 1049 {
c7b14277
JB
1050 for (cp = buf; *cp; cp++)
1051 if ((*cp < '0' || *cp > '9') && *cp != '-')
1052 break;
0601fd3d 1053
c7b14277
JB
1054 if (*cp == '.' && cp[1] == 0)
1055 {
1056 cp[1] = '0';
1057 cp[2] = 0;
99027bdd 1058 len++;
c7b14277 1059 }
75b43359 1060 else if (*cp == 0)
c7b14277
JB
1061 {
1062 *cp++ = '.';
1063 *cp++ = '0';
1064 *cp++ = 0;
99027bdd 1065 len += 2;
c7b14277 1066 }
edb2a707 1067 }
99027bdd
PE
1068
1069 return len;
38010d50 1070}
cc94f3b2 1071
38010d50
JB
1072\f
1073static void
971de7fb 1074print (Lisp_Object obj, register Lisp_Object printcharfun, int escapeflag)
38010d50 1075{
a22dec27 1076 new_backquote_output = 0;
38010d50 1077
0f25ecc6
RS
1078 /* Reset print_number_index and Vprint_number_table only when
1079 the variable Vprint_continuous_numbering is nil. Otherwise,
1080 the values of these variables will be kept between several
1081 print functions. */
e026eb89
KS
1082 if (NILP (Vprint_continuous_numbering)
1083 || NILP (Vprint_number_table))
0f25ecc6
RS
1084 {
1085 print_number_index = 0;
1086 Vprint_number_table = Qnil;
1087 }
38010d50 1088
0f25ecc6
RS
1089 /* Construct Vprint_number_table for print-gensym and print-circle. */
1090 if (!NILP (Vprint_gensym) || !NILP (Vprint_circle))
ec838c39 1091 {
e6d4cddd
RS
1092 /* Construct Vprint_number_table.
1093 This increments print_number_index for the objects added. */
9a6a4c40 1094 print_depth = 0;
0f25ecc6 1095 print_preprocess (obj);
e6d4cddd 1096
a65b85b5
SM
1097 if (HASH_TABLE_P (Vprint_number_table))
1098 { /* Remove unnecessary objects, which appear only once in OBJ;
a179e3f7 1099 that is, whose status is Qt. */
a65b85b5 1100 struct Lisp_Hash_Table *h = XHASH_TABLE (Vprint_number_table);
d311d28c 1101 ptrdiff_t i;
e6d4cddd 1102
a65b85b5
SM
1103 for (i = 0; i < HASH_TABLE_SIZE (h); ++i)
1104 if (!NILP (HASH_HASH (h, i))
1105 && EQ (HASH_VALUE (h, i), Qt))
1106 Fremhash (HASH_KEY (h, i), Vprint_number_table);
1107 }
0f25ecc6
RS
1108 }
1109
9a6a4c40 1110 print_depth = 0;
0f25ecc6
RS
1111 print_object (obj, printcharfun, escapeflag);
1112}
1113
fb103ca9
SM
1114#define PRINT_CIRCLE_CANDIDATE_P(obj) \
1115 (STRINGP (obj) || CONSP (obj) \
1116 || (VECTORLIKEP (obj) \
1117 && (VECTORP (obj) || COMPILEDP (obj) \
1118 || CHAR_TABLE_P (obj) || SUB_CHAR_TABLE_P (obj) \
1119 || HASH_TABLE_P (obj) || FONTP (obj))) \
1120 || (! NILP (Vprint_gensym) \
1121 && SYMBOLP (obj) \
1122 && !SYMBOL_INTERNED_P (obj)))
1123
0f25ecc6
RS
1124/* Construct Vprint_number_table according to the structure of OBJ.
1125 OBJ itself and all its elements will be added to Vprint_number_table
1126 recursively if it is a list, vector, compiled function, char-table,
1127 string (its text properties will be traced), or a symbol that has
1128 no obarray (this is for the print-gensym feature).
1129 The status fields of Vprint_number_table mean whether each object appears
1130 more than once in OBJ: Qnil at the first time, and Qt after that . */
1131static void
971de7fb 1132print_preprocess (Lisp_Object obj)
0f25ecc6 1133{
6b61353c 1134 int i;
d311d28c 1135 ptrdiff_t size;
c1132671
RS
1136 int loop_count = 0;
1137 Lisp_Object halftail;
1138
1139 /* Avoid infinite recursion for circular nested structure
1140 in the case where Vprint_circle is nil. */
1141 if (NILP (Vprint_circle))
1142 {
4ae29f89
SM
1143 /* Give up if we go so deep that print_object will get an error. */
1144 /* See similar code in print_object. */
1145 if (print_depth >= PRINT_CIRCLE)
1146 error ("Apparently circular structure being printed");
1147
c1132671
RS
1148 for (i = 0; i < print_depth; i++)
1149 if (EQ (obj, being_printed[i]))
1150 return;
1151 being_printed[print_depth] = obj;
1152 }
1153
c1132671
RS
1154 print_depth++;
1155 halftail = obj;
0f25ecc6
RS
1156
1157 loop:
fb103ca9 1158 if (PRINT_CIRCLE_CANDIDATE_P (obj))
0f25ecc6 1159 {
a65b85b5
SM
1160 if (!HASH_TABLE_P (Vprint_number_table))
1161 {
1162 Lisp_Object args[2];
1163 args[0] = QCtest;
1164 args[1] = Qeq;
1165 Vprint_number_table = Fmake_hash_table (2, args);
1166 }
1167
aca2020b
KH
1168 /* In case print-circle is nil and print-gensym is t,
1169 add OBJ to Vprint_number_table only when OBJ is a symbol. */
1170 if (! NILP (Vprint_circle) || SYMBOLP (obj))
0f25ecc6 1171 {
a65b85b5
SM
1172 Lisp_Object num = Fgethash (obj, Vprint_number_table, Qnil);
1173 if (!NILP (num)
1174 /* If Vprint_continuous_numbering is non-nil and OBJ is a gensym,
1175 always print the gensym with a number. This is a special for
1176 the lisp function byte-compile-output-docform. */
1177 || (!NILP (Vprint_continuous_numbering)
1178 && SYMBOLP (obj)
1179 && !SYMBOL_INTERNED_P (obj)))
1180 { /* OBJ appears more than once. Let's remember that. */
17870c01 1181 if (!INTEGERP (num))
aca2020b 1182 {
a65b85b5
SM
1183 print_number_index++;
1184 /* Negative number indicates it hasn't been printed yet. */
1185 Fputhash (obj, make_number (- print_number_index),
1186 Vprint_number_table);
aca2020b 1187 }
a65b85b5
SM
1188 print_depth--;
1189 return;
0f25ecc6 1190 }
a65b85b5
SM
1191 else
1192 /* OBJ is not yet recorded. Let's add to the table. */
1193 Fputhash (obj, Qt, Vprint_number_table);
0f25ecc6 1194 }
0f25ecc6 1195
8e50cc2d 1196 switch (XTYPE (obj))
0f25ecc6
RS
1197 {
1198 case Lisp_String:
0f25ecc6 1199 /* A string may have text properties, which can be circular. */
d5db4077 1200 traverse_intervals_noorder (STRING_INTERVALS (obj),
8bbfc258 1201 print_preprocess_string, Qnil);
0f25ecc6
RS
1202 break;
1203
1204 case Lisp_Cons:
c1132671
RS
1205 /* Use HALFTAIL and LOOP_COUNT to detect circular lists,
1206 just as in print_object. */
1207 if (loop_count && EQ (obj, halftail))
1208 break;
0f25ecc6
RS
1209 print_preprocess (XCAR (obj));
1210 obj = XCDR (obj);
c1132671
RS
1211 loop_count++;
1212 if (!(loop_count & 1))
1213 halftail = XCDR (halftail);
0f25ecc6
RS
1214 goto loop;
1215
1216 case Lisp_Vectorlike:
77b37c05 1217 size = ASIZE (obj);
6b61353c
KH
1218 if (size & PSEUDOVECTOR_FLAG)
1219 size &= PSEUDOVECTOR_SIZE_MASK;
0f25ecc6 1220 for (i = 0; i < size; i++)
28be1ada 1221 print_preprocess (AREF (obj, i));
3e0de07f
SM
1222 if (HASH_TABLE_P (obj))
1223 { /* For hash tables, the key_and_value slot is past
a65b85b5
SM
1224 `size' because it needs to be marked specially in case
1225 the table is weak. */
3e0de07f
SM
1226 struct Lisp_Hash_Table *h = XHASH_TABLE (obj);
1227 print_preprocess (h->key_and_value);
1228 }
ee5263af
GM
1229 break;
1230
1231 default:
1232 break;
0f25ecc6
RS
1233 }
1234 }
c1132671 1235 print_depth--;
0f25ecc6
RS
1236}
1237
0f25ecc6 1238static void
971de7fb 1239print_preprocess_string (INTERVAL interval, Lisp_Object arg)
0f25ecc6
RS
1240{
1241 print_preprocess (interval->plist);
1242}
0f25ecc6 1243
971de7fb 1244static void print_check_string_charset_prop (INTERVAL interval, Lisp_Object string);
71ea13cb
KH
1245
1246#define PRINT_STRING_NON_CHARSET_FOUND 1
1247#define PRINT_STRING_UNSAFE_CHARSET_FOUND 2
1248
4ae29f89 1249/* Bitwise or of the above macros. */
71ea13cb
KH
1250static int print_check_string_result;
1251
1252static void
971de7fb 1253print_check_string_charset_prop (INTERVAL interval, Lisp_Object string)
71ea13cb
KH
1254{
1255 Lisp_Object val;
1256
1257 if (NILP (interval->plist)
1258 || (print_check_string_result == (PRINT_STRING_NON_CHARSET_FOUND
1259 | PRINT_STRING_UNSAFE_CHARSET_FOUND)))
1260 return;
1261 for (val = interval->plist; CONSP (val) && ! EQ (XCAR (val), Qcharset);
1262 val = XCDR (XCDR (val)));
1263 if (! CONSP (val))
1264 {
1265 print_check_string_result |= PRINT_STRING_NON_CHARSET_FOUND;
1266 return;
1267 }
1268 if (! (print_check_string_result & PRINT_STRING_NON_CHARSET_FOUND))
1269 {
1270 if (! EQ (val, interval->plist)
1271 || CONSP (XCDR (XCDR (val))))
1272 print_check_string_result |= PRINT_STRING_NON_CHARSET_FOUND;
1273 }
1274 if (NILP (Vprint_charset_text_property)
1275 || ! (print_check_string_result & PRINT_STRING_UNSAFE_CHARSET_FOUND))
1276 {
1277 int i, c;
d311d28c
PE
1278 ptrdiff_t charpos = interval->position;
1279 ptrdiff_t bytepos = string_char_to_byte (string, charpos);
71ea13cb
KH
1280 Lisp_Object charset;
1281
1282 charset = XCAR (XCDR (val));
1283 for (i = 0; i < LENGTH (interval); i++)
1284 {
1285 FETCH_STRING_CHAR_ADVANCE (c, string, charpos, bytepos);
c80bcdbc
KH
1286 if (! ASCII_CHAR_P (c)
1287 && ! EQ (CHARSET_NAME (CHAR_CHARSET (c)), charset))
71ea13cb
KH
1288 {
1289 print_check_string_result |= PRINT_STRING_UNSAFE_CHARSET_FOUND;
1290 break;
1291 }
1292 }
1293 }
1294}
1295
1296/* The value is (charset . nil). */
1297static Lisp_Object print_prune_charset_plist;
1298
1299static Lisp_Object
971de7fb 1300print_prune_string_charset (Lisp_Object string)
71ea13cb
KH
1301{
1302 print_check_string_result = 0;
1303 traverse_intervals (STRING_INTERVALS (string), 0,
1304 print_check_string_charset_prop, string);
1305 if (! (print_check_string_result & PRINT_STRING_UNSAFE_CHARSET_FOUND))
1306 {
1307 string = Fcopy_sequence (string);
1308 if (print_check_string_result & PRINT_STRING_NON_CHARSET_FOUND)
1309 {
1310 if (NILP (print_prune_charset_plist))
1311 print_prune_charset_plist = Fcons (Qcharset, Qnil);
eabe04c0
KH
1312 Fremove_text_properties (make_number (0),
1313 make_number (SCHARS (string)),
71ea13cb
KH
1314 print_prune_charset_plist, string);
1315 }
1316 else
eabe04c0
KH
1317 Fset_text_properties (make_number (0), make_number (SCHARS (string)),
1318 Qnil, string);
71ea13cb
KH
1319 }
1320 return string;
1321}
1322
0f25ecc6 1323static void
971de7fb 1324print_object (Lisp_Object obj, register Lisp_Object printcharfun, int escapeflag)
0f25ecc6 1325{
aca216ff
PE
1326 char buf[max (sizeof "from..to..in " + 2 * INT_STRLEN_BOUND (EMACS_INT),
1327 max (sizeof " . #" + INT_STRLEN_BOUND (printmax_t),
1328 40))];
0f25ecc6
RS
1329
1330 QUIT;
1331
1332 /* Detect circularities and truncate them. */
4ae29f89 1333 if (NILP (Vprint_circle))
0f25ecc6 1334 {
4ae29f89
SM
1335 /* Simple but incomplete way. */
1336 int i;
1337
1338 /* See similar code in print_preprocess. */
1339 if (print_depth >= PRINT_CIRCLE)
1340 error ("Apparently circular structure being printed");
1341
1342 for (i = 0; i < print_depth; i++)
1343 if (EQ (obj, being_printed[i]))
1344 {
99027bdd
PE
1345 int len = sprintf (buf, "#%d", i);
1346 strout (buf, len, len, printcharfun);
4ae29f89
SM
1347 return;
1348 }
1349 being_printed[print_depth] = obj;
1350 }
1351 else if (PRINT_CIRCLE_CANDIDATE_P (obj))
1352 {
1353 /* With the print-circle feature. */
1354 Lisp_Object num = Fgethash (obj, Vprint_number_table, Qnil);
1355 if (INTEGERP (num))
0f25ecc6 1356 {
4ae29f89
SM
1357 EMACS_INT n = XINT (num);
1358 if (n < 0)
1359 { /* Add a prefix #n= if OBJ has not yet been printed;
1360 that is, its status field is nil. */
99027bdd
PE
1361 int len = sprintf (buf, "#%"pI"d=", -n);
1362 strout (buf, len, len, printcharfun);
4ae29f89
SM
1363 /* OBJ is going to be printed. Remember that fact. */
1364 Fputhash (obj, make_number (- n), Vprint_number_table);
1365 }
1366 else
a65b85b5 1367 {
4ae29f89 1368 /* Just print #n# if OBJ has already been printed. */
99027bdd
PE
1369 int len = sprintf (buf, "#%"pI"d#", n);
1370 strout (buf, len, len, printcharfun);
4ae29f89 1371 return;
a65b85b5 1372 }
0f25ecc6 1373 }
ec838c39 1374 }
ec838c39 1375
38010d50
JB
1376 print_depth++;
1377
8e50cc2d 1378 switch (XTYPE (obj))
38010d50 1379 {
2de9f71c 1380 case_Lisp_Int:
99027bdd
PE
1381 {
1382 int len = sprintf (buf, "%"pI"d", XINT (obj));
1383 strout (buf, len, len, printcharfun);
1384 }
ca0569ad
RS
1385 break;
1386
ca0569ad
RS
1387 case Lisp_Float:
1388 {
6e8e6bf2 1389 char pigbuf[FLOAT_TO_STRING_BUFSIZE];
99027bdd
PE
1390 int len = float_to_string (pigbuf, XFLOAT_DATA (obj));
1391 strout (pigbuf, len, len, printcharfun);
ca0569ad
RS
1392 }
1393 break;
ca0569ad
RS
1394
1395 case Lisp_String:
38010d50
JB
1396 if (!escapeflag)
1397 print_string (obj, printcharfun);
1398 else
1399 {
d311d28c 1400 register ptrdiff_t i_byte;
38010d50 1401 struct gcpro gcpro1;
872a36d2 1402 unsigned char *str;
d311d28c 1403 ptrdiff_t size_byte;
453fa987
RS
1404 /* 1 means we must ensure that the next character we output
1405 cannot be taken as part of a hex character escape. */
1406 int need_nonhex = 0;
db300f59 1407 int multibyte = STRING_MULTIBYTE (obj);
38010d50 1408
7651e1f5
RS
1409 GCPRO1 (obj);
1410
71ea13cb
KH
1411 if (! EQ (Vprint_charset_text_property, Qt))
1412 obj = print_prune_string_charset (obj);
1413
d5db4077 1414 if (!NULL_INTERVAL_P (STRING_INTERVALS (obj)))
7651e1f5
RS
1415 {
1416 PRINTCHAR ('#');
1417 PRINTCHAR ('(');
1418 }
38010d50
JB
1419
1420 PRINTCHAR ('\"');
d5db4077
KR
1421 str = SDATA (obj);
1422 size_byte = SBYTES (obj);
dc2a0b79 1423
47553fa8 1424 for (i_byte = 0; i_byte < size_byte;)
38010d50 1425 {
6ddd6eee
RS
1426 /* Here, we must convert each multi-byte form to the
1427 corresponding character code before handing it to PRINTCHAR. */
1428 int len;
dc2a0b79
RS
1429 int c;
1430
db300f59 1431 if (multibyte)
872a36d2 1432 {
62a6e103 1433 c = STRING_CHAR_AND_LENGTH (str + i_byte, len);
8b4b4467 1434 i_byte += len;
872a36d2 1435 }
dc2a0b79 1436 else
872a36d2 1437 c = str[i_byte++];
dc2a0b79 1438
38010d50 1439 QUIT;
6ddd6eee 1440
38010d50
JB
1441 if (c == '\n' && print_escape_newlines)
1442 {
1443 PRINTCHAR ('\\');
1444 PRINTCHAR ('n');
1445 }
c6f7982f
RM
1446 else if (c == '\f' && print_escape_newlines)
1447 {
1448 PRINTCHAR ('\\');
1449 PRINTCHAR ('f');
1450 }
ae7367d3 1451 else if (multibyte
42a5b22f 1452 && (CHAR_BYTE8_P (c)
73af357a 1453 || (! ASCII_CHAR_P (c) && print_escape_multibyte)))
dc2a0b79
RS
1454 {
1455 /* When multibyte is disabled,
ae7367d3
RS
1456 print multibyte string chars using hex escapes.
1457 For a char code that could be in a unibyte string,
1458 when found in a multibyte string, always use a hex escape
1459 so it reads back as multibyte. */
09125ef8 1460 char outbuf[50];
99027bdd 1461 int len;
8b4b4467
KH
1462
1463 if (CHAR_BYTE8_P (c))
99027bdd 1464 len = sprintf (outbuf, "\\%03o", CHAR_TO_BYTE8 (c));
8b4b4467 1465 else
8f924df7 1466 {
99027bdd 1467 len = sprintf (outbuf, "\\x%04x", c);
8f924df7
KH
1468 need_nonhex = 1;
1469 }
99027bdd 1470 strout (outbuf, len, len, printcharfun);
dc2a0b79 1471 }
db300f59
RS
1472 else if (! multibyte
1473 && SINGLE_BYTE_CHAR_P (c) && ! ASCII_BYTE_P (c)
835d0be6 1474 && print_escape_nonascii)
974a6ff5 1475 {
835d0be6
RS
1476 /* When printing in a multibyte buffer
1477 or when explicitly requested,
974a6ff5
KH
1478 print single-byte non-ASCII string chars
1479 using octal escapes. */
09125ef8 1480 char outbuf[5];
99027bdd
PE
1481 int len = sprintf (outbuf, "\\%03o", c);
1482 strout (outbuf, len, len, printcharfun);
974a6ff5 1483 }
38010d50
JB
1484 else
1485 {
453fa987
RS
1486 /* If we just had a hex escape, and this character
1487 could be taken as part of it,
1488 output `\ ' to prevent that. */
1b62edd6
KH
1489 if (need_nonhex)
1490 {
1491 need_nonhex = 0;
1492 if ((c >= 'a' && c <= 'f')
453fa987 1493 || (c >= 'A' && c <= 'F')
1b62edd6 1494 || (c >= '0' && c <= '9'))
1db5b1ad 1495 strout ("\\ ", -1, -1, printcharfun);
1b62edd6 1496 }
453fa987 1497
38010d50
JB
1498 if (c == '\"' || c == '\\')
1499 PRINTCHAR ('\\');
1500 PRINTCHAR (c);
1501 }
1502 }
1503 PRINTCHAR ('\"');
7651e1f5 1504
d5db4077 1505 if (!NULL_INTERVAL_P (STRING_INTERVALS (obj)))
7651e1f5 1506 {
d5db4077 1507 traverse_intervals (STRING_INTERVALS (obj),
8bbfc258 1508 0, print_interval, printcharfun);
7651e1f5
RS
1509 PRINTCHAR (')');
1510 }
7651e1f5 1511
38010d50
JB
1512 UNGCPRO;
1513 }
ca0569ad 1514 break;
38010d50 1515
ca0569ad
RS
1516 case Lisp_Symbol:
1517 {
1518 register int confusing;
d5db4077
KR
1519 register unsigned char *p = SDATA (SYMBOL_NAME (obj));
1520 register unsigned char *end = p + SBYTES (SYMBOL_NAME (obj));
2190a05e 1521 register int c;
d311d28c
PE
1522 ptrdiff_t i, i_byte;
1523 ptrdiff_t size_byte;
dc2a0b79
RS
1524 Lisp_Object name;
1525
76d0b3ae 1526 name = SYMBOL_NAME (obj);
ca0569ad
RS
1527
1528 if (p != end && (*p == '-' || *p == '+')) p++;
1529 if (p == end)
1530 confusing = 0;
d27497e3
RS
1531 /* If symbol name begins with a digit, and ends with a digit,
1532 and contains nothing but digits and `e', it could be treated
1533 as a number. So set CONFUSING.
1534
1535 Symbols that contain periods could also be taken as numbers,
1536 but periods are always escaped, so we don't have to worry
1537 about them here. */
1538 else if (*p >= '0' && *p <= '9'
1539 && end[-1] >= '0' && end[-1] <= '9')
ca0569ad 1540 {
e837058b
RS
1541 while (p != end && ((*p >= '0' && *p <= '9')
1542 /* Needed for \2e10. */
01a8d3fa 1543 || *p == 'e' || *p == 'E'))
ca0569ad
RS
1544 p++;
1545 confusing = (end == p);
1546 }
d27497e3
RS
1547 else
1548 confusing = 0;
ca0569ad 1549
9a79b20c
AS
1550 size_byte = SBYTES (name);
1551
bf9f2aab 1552 if (! NILP (Vprint_gensym) && !SYMBOL_INTERNED_P (obj))
081e0581 1553 {
081e0581
EN
1554 PRINTCHAR ('#');
1555 PRINTCHAR (':');
1556 }
9a79b20c
AS
1557 else if (size_byte == 0)
1558 {
1559 PRINTCHAR ('#');
1560 PRINTCHAR ('#');
1561 break;
1562 }
dc2a0b79
RS
1563
1564 for (i = 0, i_byte = 0; i_byte < size_byte;)
ca0569ad 1565 {
6ddd6eee
RS
1566 /* Here, we must convert each multi-byte form to the
1567 corresponding character code before handing it to PRINTCHAR. */
eba90784 1568 FETCH_STRING_CHAR_ADVANCE (c, name, i, i_byte);
ca0569ad 1569 QUIT;
09eddb56 1570
ca0569ad
RS
1571 if (escapeflag)
1572 {
09eddb56
RS
1573 if (c == '\"' || c == '\\' || c == '\''
1574 || c == ';' || c == '#' || c == '(' || c == ')'
9a79b20c 1575 || c == ',' || c == '.' || c == '`'
09eddb56
RS
1576 || c == '[' || c == ']' || c == '?' || c <= 040
1577 || confusing)
ca0569ad
RS
1578 PRINTCHAR ('\\'), confusing = 0;
1579 }
1580 PRINTCHAR (c);
1581 }
1582 }
1583 break;
1584
1585 case Lisp_Cons:
38010d50 1586 /* If deeper than spec'd depth, print placeholder. */
d4ae1f7e 1587 if (INTEGERP (Vprint_level)
38010d50 1588 && print_depth > XINT (Vprint_level))
1db5b1ad 1589 strout ("...", -1, -1, printcharfun);
2f100b5c
EN
1590 else if (print_quoted && CONSP (XCDR (obj)) && NILP (XCDR (XCDR (obj)))
1591 && (EQ (XCAR (obj), Qquote)))
1592 {
1593 PRINTCHAR ('\'');
0f25ecc6 1594 print_object (XCAR (XCDR (obj)), printcharfun, escapeflag);
2f100b5c
EN
1595 }
1596 else if (print_quoted && CONSP (XCDR (obj)) && NILP (XCDR (XCDR (obj)))
1597 && (EQ (XCAR (obj), Qfunction)))
1598 {
1599 PRINTCHAR ('#');
1600 PRINTCHAR ('\'');
0f25ecc6 1601 print_object (XCAR (XCDR (obj)), printcharfun, escapeflag);
2f100b5c
EN
1602 }
1603 else if (print_quoted && CONSP (XCDR (obj)) && NILP (XCDR (XCDR (obj)))
a22dec27
SM
1604 && ((EQ (XCAR (obj), Qbackquote))))
1605 {
1606 print_object (XCAR (obj), printcharfun, 0);
1607 new_backquote_output++;
1608 print_object (XCAR (XCDR (obj)), printcharfun, escapeflag);
1609 new_backquote_output--;
1610 }
1611 else if (print_quoted && CONSP (XCDR (obj)) && NILP (XCDR (XCDR (obj)))
1612 && new_backquote_output
2f100b5c
EN
1613 && ((EQ (XCAR (obj), Qbackquote)
1614 || EQ (XCAR (obj), Qcomma)
1615 || EQ (XCAR (obj), Qcomma_at)
1616 || EQ (XCAR (obj), Qcomma_dot))))
1617 {
0f25ecc6 1618 print_object (XCAR (obj), printcharfun, 0);
a22dec27 1619 new_backquote_output--;
0f25ecc6 1620 print_object (XCAR (XCDR (obj)), printcharfun, escapeflag);
a22dec27 1621 new_backquote_output++;
2f100b5c 1622 }
e0f93814 1623 else
38010d50 1624 {
e0f93814 1625 PRINTCHAR ('(');
177c0ea7 1626
38010d50 1627 {
aca216ff 1628 printmax_t i, print_length;
1eab22b5 1629 Lisp_Object halftail = obj;
e0f93814 1630
9ab8560d 1631 /* Negative values of print-length are invalid in CL.
42ac1ed4
GM
1632 Treat them like nil, as CMUCL does. */
1633 if (NATNUMP (Vprint_length))
1634 print_length = XFASTINT (Vprint_length);
1635 else
aca216ff 1636 print_length = TYPE_MAXIMUM (printmax_t);
42ac1ed4
GM
1637
1638 i = 0;
e0f93814 1639 while (CONSP (obj))
38010d50 1640 {
1eab22b5 1641 /* Detect circular list. */
0f25ecc6 1642 if (NILP (Vprint_circle))
1eab22b5 1643 {
53964682 1644 /* Simple but incomplete way. */
0f25ecc6
RS
1645 if (i != 0 && EQ (obj, halftail))
1646 {
99027bdd
PE
1647 int len = sprintf (buf, " . #%"pMd, i / 2);
1648 strout (buf, len, len, printcharfun);
0f25ecc6
RS
1649 goto end_of_list;
1650 }
1651 }
1652 else
1653 {
1654 /* With the print-circle feature. */
1655 if (i != 0)
1656 {
a65b85b5
SM
1657 Lisp_Object num = Fgethash (obj, Vprint_number_table, Qnil);
1658 if (INTEGERP (num))
36de6a04 1659 {
1db5b1ad 1660 strout (" . ", 3, 3, printcharfun);
36de6a04
AS
1661 print_object (obj, printcharfun, escapeflag);
1662 goto end_of_list;
1663 }
0f25ecc6 1664 }
1eab22b5 1665 }
177c0ea7 1666
aca216ff 1667 if (i)
e0f93814 1668 PRINTCHAR (' ');
177c0ea7 1669
aca216ff 1670 if (print_length <= i)
e0f93814 1671 {
1db5b1ad 1672 strout ("...", 3, 3, printcharfun);
0f25ecc6 1673 goto end_of_list;
e0f93814 1674 }
177c0ea7 1675
aca216ff 1676 i++;
0f25ecc6 1677 print_object (XCAR (obj), printcharfun, escapeflag);
177c0ea7 1678
2f100b5c 1679 obj = XCDR (obj);
1eab22b5
RS
1680 if (!(i & 1))
1681 halftail = XCDR (halftail);
38010d50 1682 }
38010d50 1683 }
42ac1ed4
GM
1684
1685 /* OBJ non-nil here means it's the end of a dotted list. */
2f100b5c 1686 if (!NILP (obj))
e0f93814 1687 {
1db5b1ad 1688 strout (" . ", 3, 3, printcharfun);
0f25ecc6 1689 print_object (obj, printcharfun, escapeflag);
e0f93814 1690 }
177c0ea7 1691
0f25ecc6 1692 end_of_list:
e0f93814 1693 PRINTCHAR (')');
38010d50 1694 }
ca0569ad
RS
1695 break;
1696
1697 case Lisp_Vectorlike:
1698 if (PROCESSP (obj))
1699 {
1700 if (escapeflag)
1701 {
1db5b1ad 1702 strout ("#<process ", -1, -1, printcharfun);
ca0569ad
RS
1703 print_string (XPROCESS (obj)->name, printcharfun);
1704 PRINTCHAR ('>');
1705 }
1706 else
1707 print_string (XPROCESS (obj)->name, printcharfun);
1708 }
ed2c35ef
RS
1709 else if (BOOL_VECTOR_P (obj))
1710 {
29ebea3b 1711 ptrdiff_t i;
99027bdd
PE
1712 int len;
1713 unsigned char c;
ed2c35ef 1714 struct gcpro gcpro1;
d311d28c 1715 ptrdiff_t size_in_chars
4b5af5e4
AS
1716 = ((XBOOL_VECTOR (obj)->size + BOOL_VECTOR_BITS_PER_CHAR - 1)
1717 / BOOL_VECTOR_BITS_PER_CHAR);
ed2c35ef
RS
1718
1719 GCPRO1 (obj);
1720
1721 PRINTCHAR ('#');
1722 PRINTCHAR ('&');
99027bdd
PE
1723 len = sprintf (buf, "%"pI"d", XBOOL_VECTOR (obj)->size);
1724 strout (buf, len, len, printcharfun);
ed2c35ef 1725 PRINTCHAR ('\"');
a40384bc 1726
42ac1ed4 1727 /* Don't print more characters than the specified maximum.
9ab8560d 1728 Negative values of print-length are invalid. Treat them
42ac1ed4
GM
1729 like a print-length of nil. */
1730 if (NATNUMP (Vprint_length)
1731 && XFASTINT (Vprint_length) < size_in_chars)
1732 size_in_chars = XFASTINT (Vprint_length);
a40384bc 1733
ed2c35ef
RS
1734 for (i = 0; i < size_in_chars; i++)
1735 {
1736 QUIT;
1737 c = XBOOL_VECTOR (obj)->data[i];
f10fdbfd 1738 if (c == '\n' && print_escape_newlines)
ed2c35ef
RS
1739 {
1740 PRINTCHAR ('\\');
1741 PRINTCHAR ('n');
1742 }
1743 else if (c == '\f' && print_escape_newlines)
1744 {
1745 PRINTCHAR ('\\');
1746 PRINTCHAR ('f');
1747 }
4b5af5e4
AS
1748 else if (c > '\177')
1749 {
1750 /* Use octal escapes to avoid encoding issues. */
1751 PRINTCHAR ('\\');
1752 PRINTCHAR ('0' + ((c >> 6) & 3));
1753 PRINTCHAR ('0' + ((c >> 3) & 7));
1754 PRINTCHAR ('0' + (c & 7));
1755 }
ed2c35ef
RS
1756 else
1757 {
1758 if (c == '\"' || c == '\\')
1759 PRINTCHAR ('\\');
1760 PRINTCHAR (c);
1761 }
1762 }
1763 PRINTCHAR ('\"');
1764
1765 UNGCPRO;
1766 }
ca0569ad
RS
1767 else if (SUBRP (obj))
1768 {
1db5b1ad
JB
1769 strout ("#<subr ", -1, -1, printcharfun);
1770 strout (XSUBR (obj)->symbol_name, -1, -1, printcharfun);
ca0569ad
RS
1771 PRINTCHAR ('>');
1772 }
ca0569ad
RS
1773 else if (WINDOWP (obj))
1774 {
99027bdd 1775 int len;
1db5b1ad 1776 strout ("#<window ", -1, -1, printcharfun);
99027bdd
PE
1777 len = sprintf (buf, "%"pI"d",
1778 XFASTINT (XWINDOW (obj)->sequence_number));
1779 strout (buf, len, len, printcharfun);
ca0569ad
RS
1780 if (!NILP (XWINDOW (obj)->buffer))
1781 {
1db5b1ad 1782 strout (" on ", -1, -1, printcharfun);
4b4deea2 1783 print_string (BVAR (XBUFFER (XWINDOW (obj)->buffer), name), printcharfun);
ca0569ad
RS
1784 }
1785 PRINTCHAR ('>');
1786 }
f76c8b1e
SM
1787 else if (TERMINALP (obj))
1788 {
99027bdd 1789 int len;
f76c8b1e 1790 struct terminal *t = XTERMINAL (obj);
1db5b1ad 1791 strout ("#<terminal ", -1, -1, printcharfun);
99027bdd
PE
1792 len = sprintf (buf, "%d", t->id);
1793 strout (buf, len, len, printcharfun);
f76c8b1e
SM
1794 if (t->name)
1795 {
1db5b1ad
JB
1796 strout (" on ", -1, -1, printcharfun);
1797 strout (t->name, -1, -1, printcharfun);
f76c8b1e
SM
1798 }
1799 PRINTCHAR ('>');
1800 }
7eb03302
GM
1801 else if (HASH_TABLE_P (obj))
1802 {
1803 struct Lisp_Hash_Table *h = XHASH_TABLE (obj);
d311d28c
PE
1804 ptrdiff_t i;
1805 ptrdiff_t real_size, size;
99027bdd 1806 int len;
f19a0f5b 1807#if 0
1db5b1ad 1808 strout ("#<hash-table", -1, -1, printcharfun);
7eb03302
GM
1809 if (SYMBOLP (h->test))
1810 {
1811 PRINTCHAR (' ');
1812 PRINTCHAR ('\'');
1db5b1ad 1813 strout (SDATA (SYMBOL_NAME (h->test)), -1, -1, printcharfun);
7eb03302 1814 PRINTCHAR (' ');
1db5b1ad 1815 strout (SDATA (SYMBOL_NAME (h->weak)), -1, -1, printcharfun);
7eb03302 1816 PRINTCHAR (' ');
99027bdd
PE
1817 len = sprintf (buf, "%"pD"d/%"pD"d", h->count, ASIZE (h->next));
1818 strout (buf, len, len, printcharfun);
7eb03302 1819 }
99027bdd
PE
1820 len = sprintf (buf, " %p", h);
1821 strout (buf, len, len, printcharfun);
7eb03302 1822 PRINTCHAR ('>');
f19a0f5b
TZ
1823#endif
1824 /* Implement a readable output, e.g.:
1825 #s(hash-table size 2 test equal data (k1 v1 k2 v2)) */
1826 /* Always print the size. */
99027bdd
PE
1827 len = sprintf (buf, "#s(hash-table size %"pD"d", ASIZE (h->next));
1828 strout (buf, len, len, printcharfun);
f19a0f5b
TZ
1829
1830 if (!NILP (h->test))
1831 {
1db5b1ad 1832 strout (" test ", -1, -1, printcharfun);
617a0e83 1833 print_object (h->test, printcharfun, escapeflag);
f19a0f5b
TZ
1834 }
1835
1836 if (!NILP (h->weak))
1837 {
1db5b1ad 1838 strout (" weakness ", -1, -1, printcharfun);
617a0e83 1839 print_object (h->weak, printcharfun, escapeflag);
f19a0f5b
TZ
1840 }
1841
1842 if (!NILP (h->rehash_size))
1843 {
1db5b1ad 1844 strout (" rehash-size ", -1, -1, printcharfun);
617a0e83 1845 print_object (h->rehash_size, printcharfun, escapeflag);
f19a0f5b
TZ
1846 }
1847
1848 if (!NILP (h->rehash_threshold))
1849 {
1db5b1ad 1850 strout (" rehash-threshold ", -1, -1, printcharfun);
617a0e83 1851 print_object (h->rehash_threshold, printcharfun, escapeflag);
f19a0f5b
TZ
1852 }
1853
1db5b1ad 1854 strout (" data ", -1, -1, printcharfun);
f19a0f5b
TZ
1855
1856 /* Print the data here as a plist. */
b0ca0f33
DN
1857 real_size = HASH_TABLE_SIZE (h);
1858 size = real_size;
f19a0f5b
TZ
1859
1860 /* Don't print more elements than the specified maximum. */
1861 if (NATNUMP (Vprint_length)
1862 && XFASTINT (Vprint_length) < size)
1863 size = XFASTINT (Vprint_length);
42a5b22f 1864
f19a0f5b
TZ
1865 PRINTCHAR ('(');
1866 for (i = 0; i < size; i++)
1867 if (!NILP (HASH_HASH (h, i)))
1868 {
1869 if (i) PRINTCHAR (' ');
617a0e83 1870 print_object (HASH_KEY (h, i), printcharfun, escapeflag);
f19a0f5b 1871 PRINTCHAR (' ');
617a0e83 1872 print_object (HASH_VALUE (h, i), printcharfun, escapeflag);
f19a0f5b
TZ
1873 }
1874
1875 if (size < real_size)
1db5b1ad 1876 strout (" ...", 4, 4, printcharfun);
f19a0f5b
TZ
1877
1878 PRINTCHAR (')');
1879 PRINTCHAR (')');
1880
7eb03302 1881 }
908b0ae5
RS
1882 else if (BUFFERP (obj))
1883 {
4b4deea2 1884 if (NILP (BVAR (XBUFFER (obj), name)))
1db5b1ad 1885 strout ("#<killed buffer>", -1, -1, printcharfun);
908b0ae5
RS
1886 else if (escapeflag)
1887 {
1db5b1ad 1888 strout ("#<buffer ", -1, -1, printcharfun);
4b4deea2 1889 print_string (BVAR (XBUFFER (obj), name), printcharfun);
908b0ae5
RS
1890 PRINTCHAR ('>');
1891 }
1892 else
4b4deea2 1893 print_string (BVAR (XBUFFER (obj), name), printcharfun);
908b0ae5 1894 }
ca0569ad
RS
1895 else if (WINDOW_CONFIGURATIONP (obj))
1896 {
1db5b1ad 1897 strout ("#<window-configuration>", -1, -1, printcharfun);
ca0569ad 1898 }
ca0569ad
RS
1899 else if (FRAMEP (obj))
1900 {
99027bdd 1901 int len;
ca0569ad
RS
1902 strout ((FRAME_LIVE_P (XFRAME (obj))
1903 ? "#<frame " : "#<dead frame "),
1db5b1ad 1904 -1, -1, printcharfun);
ca0569ad 1905 print_string (XFRAME (obj)->name, printcharfun);
99027bdd
PE
1906 len = sprintf (buf, " %p", XFRAME (obj));
1907 strout (buf, len, len, printcharfun);
ca0569ad
RS
1908 PRINTCHAR ('>');
1909 }
2a7b7982
KH
1910 else if (FONTP (obj))
1911 {
d311d28c 1912 int i;
2a7b7982
KH
1913
1914 if (! FONT_OBJECT_P (obj))
1915 {
1916 if (FONT_SPEC_P (obj))
1db5b1ad 1917 strout ("#<font-spec", -1, -1, printcharfun);
2a7b7982 1918 else
1db5b1ad 1919 strout ("#<font-entity", -1, -1, printcharfun);
2a7b7982
KH
1920 for (i = 0; i < FONT_SPEC_MAX; i++)
1921 {
1922 PRINTCHAR (' ');
1923 if (i < FONT_WEIGHT_INDEX || i > FONT_WIDTH_INDEX)
1924 print_object (AREF (obj, i), printcharfun, escapeflag);
1925 else
1926 print_object (font_style_symbolic (obj, i, 0),
1927 printcharfun, escapeflag);
1928 }
1929 }
1930 else
1931 {
1db5b1ad 1932 strout ("#<font-object ", -1, -1, printcharfun);
2a7b7982
KH
1933 print_object (AREF (obj, FONT_NAME_INDEX), printcharfun,
1934 escapeflag);
1935 }
1936 PRINTCHAR ('>');
1937 }
ca0569ad
RS
1938 else
1939 {
d311d28c 1940 ptrdiff_t size = ASIZE (obj);
ca0569ad
RS
1941 if (COMPILEDP (obj))
1942 {
1943 PRINTCHAR ('#');
1944 size &= PSEUDOVECTOR_SIZE_MASK;
1945 }
8b4b4467 1946 if (CHAR_TABLE_P (obj) || SUB_CHAR_TABLE_P (obj))
ed2c35ef
RS
1947 {
1948 /* We print a char-table as if it were a vector,
1949 lumping the parent and default slots in with the
1950 character slots. But we add #^ as a prefix. */
223509a3
KH
1951
1952 /* Make each lowest sub_char_table start a new line.
1953 Otherwise we'll make a line extremely long, which
1954 results in slow redisplay. */
1955 if (SUB_CHAR_TABLE_P (obj)
1956 && XINT (XSUB_CHAR_TABLE (obj)->depth) == 3)
1957 PRINTCHAR ('\n');
ed2c35ef
RS
1958 PRINTCHAR ('#');
1959 PRINTCHAR ('^');
3701b5de
KH
1960 if (SUB_CHAR_TABLE_P (obj))
1961 PRINTCHAR ('^');
ed2c35ef
RS
1962 size &= PSEUDOVECTOR_SIZE_MASK;
1963 }
00d76abc
KH
1964 if (size & PSEUDOVECTOR_FLAG)
1965 goto badtype;
ca0569ad
RS
1966
1967 PRINTCHAR ('[');
38010d50 1968 {
ca0569ad
RS
1969 register int i;
1970 register Lisp_Object tem;
d311d28c 1971 ptrdiff_t real_size = size;
a40384bc
RS
1972
1973 /* Don't print more elements than the specified maximum. */
42ac1ed4
GM
1974 if (NATNUMP (Vprint_length)
1975 && XFASTINT (Vprint_length) < size)
1976 size = XFASTINT (Vprint_length);
a40384bc 1977
ca0569ad
RS
1978 for (i = 0; i < size; i++)
1979 {
1980 if (i) PRINTCHAR (' ');
28be1ada 1981 tem = AREF (obj, i);
0f25ecc6 1982 print_object (tem, printcharfun, escapeflag);
ca0569ad 1983 }
d6ac884e 1984 if (size < real_size)
1db5b1ad 1985 strout (" ...", 4, 4, printcharfun);
38010d50 1986 }
ca0569ad
RS
1987 PRINTCHAR (']');
1988 }
1989 break;
1990
ca0569ad 1991 case Lisp_Misc:
5db20f08 1992 switch (XMISCTYPE (obj))
38010d50 1993 {
00d76abc 1994 case Lisp_Misc_Marker:
1db5b1ad 1995 strout ("#<marker ", -1, -1, printcharfun);
087e3c46
KH
1996 /* Do you think this is necessary? */
1997 if (XMARKER (obj)->insertion_type != 0)
1db5b1ad 1998 strout ("(moves after insertion) ", -1, -1, printcharfun);
cd3587c1 1999 if (! XMARKER (obj)->buffer)
1db5b1ad 2000 strout ("in no buffer", -1, -1, printcharfun);
ca0569ad
RS
2001 else
2002 {
99027bdd
PE
2003 int len = sprintf (buf, "at %"pD"d", marker_position (obj));
2004 strout (buf, len, len, printcharfun);
1db5b1ad 2005 strout (" in ", -1, -1, printcharfun);
4b4deea2 2006 print_string (BVAR (XMARKER (obj)->buffer, name), printcharfun);
ca0569ad 2007 }
38010d50 2008 PRINTCHAR ('>');
908b0ae5 2009 break;
00d76abc
KH
2010
2011 case Lisp_Misc_Overlay:
1db5b1ad 2012 strout ("#<overlay ", -1, -1, printcharfun);
cd3587c1 2013 if (! XMARKER (OVERLAY_START (obj))->buffer)
1db5b1ad 2014 strout ("in no buffer", -1, -1, printcharfun);
ca0569ad
RS
2015 else
2016 {
99027bdd
PE
2017 int len = sprintf (buf, "from %"pD"d to %"pD"d in ",
2018 marker_position (OVERLAY_START (obj)),
2019 marker_position (OVERLAY_END (obj)));
2020 strout (buf, len, len, printcharfun);
4b4deea2 2021 print_string (BVAR (XMARKER (OVERLAY_START (obj))->buffer, name),
ca0569ad
RS
2022 printcharfun);
2023 }
2024 PRINTCHAR ('>');
908b0ae5 2025 break;
00d76abc
KH
2026
2027 /* Remaining cases shouldn't happen in normal usage, but let's print
2028 them anyway for the benefit of the debugger. */
2029 case Lisp_Misc_Free:
1db5b1ad 2030 strout ("#<misc free cell>", -1, -1, printcharfun);
00d76abc
KH
2031 break;
2032
c069fee4 2033 case Lisp_Misc_Save_Value:
1db5b1ad 2034 strout ("#<save_value ", -1, -1, printcharfun);
99027bdd
PE
2035 {
2036 int len = sprintf (buf, "ptr=%p int=%"pD"d",
2037 XSAVE_VALUE (obj)->pointer,
2038 XSAVE_VALUE (obj)->integer);
2039 strout (buf, len, len, printcharfun);
2040 }
c069fee4
KS
2041 PRINTCHAR ('>');
2042 break;
2043
00d76abc
KH
2044 default:
2045 goto badtype;
e0f93814 2046 }
00d76abc 2047 break;
ca0569ad
RS
2048
2049 default:
00d76abc 2050 badtype:
ca0569ad 2051 {
99027bdd 2052 int len;
ca0569ad
RS
2053 /* We're in trouble if this happens!
2054 Probably should just abort () */
1db5b1ad 2055 strout ("#<EMACS BUG: INVALID DATATYPE ", -1, -1, printcharfun);
00d76abc 2056 if (MISCP (obj))
99027bdd 2057 len = sprintf (buf, "(MISC 0x%04x)", (int) XMISCTYPE (obj));
00d76abc 2058 else if (VECTORLIKEP (obj))
99027bdd 2059 len = sprintf (buf, "(PVEC 0x%08"pD"x)", ASIZE (obj));
00d76abc 2060 else
99027bdd
PE
2061 len = sprintf (buf, "(0x%02x)", (int) XTYPE (obj));
2062 strout (buf, len, len, printcharfun);
ca0569ad 2063 strout (" Save your buffers immediately and please report this bug>",
1db5b1ad 2064 -1, -1, printcharfun);
ca0569ad 2065 }
38010d50
JB
2066 }
2067
2068 print_depth--;
2069}
2070\f
7651e1f5
RS
2071
2072/* Print a description of INTERVAL using PRINTCHARFUN.
2073 This is part of printing a string that has text properties. */
2074
2075void
971de7fb 2076print_interval (INTERVAL interval, Lisp_Object printcharfun)
7651e1f5 2077{
71ea13cb
KH
2078 if (NILP (interval->plist))
2079 return;
30503c0b 2080 PRINTCHAR (' ');
0f25ecc6 2081 print_object (make_number (interval->position), printcharfun, 1);
7651e1f5 2082 PRINTCHAR (' ');
0f25ecc6 2083 print_object (make_number (interval->position + LENGTH (interval)),
cd3587c1 2084 printcharfun, 1);
7651e1f5 2085 PRINTCHAR (' ');
0f25ecc6 2086 print_object (interval->plist, printcharfun, 1);
7651e1f5
RS
2087}
2088
7651e1f5 2089\f
38010d50 2090void
971de7fb 2091syms_of_print (void)
38010d50 2092{
cd3520a4 2093 DEFSYM (Qtemp_buffer_setup_hook, "temp-buffer-setup-hook");
d9c21094 2094
29208e82 2095 DEFVAR_LISP ("standard-output", Vstandard_output,
8c1a1077
PJ
2096 doc: /* Output stream `print' uses by default for outputting a character.
2097This may be any function of one argument.
2098It may also be a buffer (output is inserted before point)
2099or a marker (output is inserted and the marker is advanced)
2100or the symbol t (output appears in the echo area). */);
38010d50 2101 Vstandard_output = Qt;
cd3520a4 2102 DEFSYM (Qstandard_output, "standard-output");
38010d50 2103
29208e82 2104 DEFVAR_LISP ("float-output-format", Vfloat_output_format,
8c1a1077
PJ
2105 doc: /* The format descriptor string used to print floats.
2106This is a %-spec like those accepted by `printf' in C,
2107but with some restrictions. It must start with the two characters `%.'.
2108After that comes an integer precision specification,
2109and then a letter which controls the format.
2110The letters allowed are `e', `f' and `g'.
2111Use `e' for exponential notation \"DIG.DIGITSeEXPT\"
2112Use `f' for decimal point notation \"DIGITS.DIGITS\".
2113Use `g' to choose the shorter of those two formats for the number at hand.
2114The precision in any of these cases is the number of digits following
2115the decimal point. With `f', a precision of 0 means to omit the
2116decimal point. 0 is not allowed with `e' or `g'.
2117
2118A value of nil means to use the shortest notation
2119that represents the number without losing information. */);
38010d50 2120 Vfloat_output_format = Qnil;
cd3520a4 2121 DEFSYM (Qfloat_output_format, "float-output-format");
38010d50 2122
29208e82 2123 DEFVAR_LISP ("print-length", Vprint_length,
8c1a1077
PJ
2124 doc: /* Maximum length of list to print before abbreviating.
2125A value of nil means no limit. See also `eval-expression-print-length'. */);
38010d50
JB
2126 Vprint_length = Qnil;
2127
29208e82 2128 DEFVAR_LISP ("print-level", Vprint_level,
8c1a1077
PJ
2129 doc: /* Maximum depth of list nesting to print before abbreviating.
2130A value of nil means no limit. See also `eval-expression-print-level'. */);
38010d50
JB
2131 Vprint_level = Qnil;
2132
29208e82 2133 DEFVAR_BOOL ("print-escape-newlines", print_escape_newlines,
8c1a1077
PJ
2134 doc: /* Non-nil means print newlines in strings as `\\n'.
2135Also print formfeeds as `\\f'. */);
38010d50
JB
2136 print_escape_newlines = 0;
2137
29208e82 2138 DEFVAR_BOOL ("print-escape-nonascii", print_escape_nonascii,
8c1a1077
PJ
2139 doc: /* Non-nil means print unibyte non-ASCII chars in strings as \\OOO.
2140\(OOO is the octal representation of the character code.)
249c0f71
RS
2141Only single-byte characters are affected, and only in `prin1'.
2142When the output goes in a multibyte buffer, this feature is
2143enabled regardless of the value of the variable. */);
38940e93
RS
2144 print_escape_nonascii = 0;
2145
29208e82 2146 DEFVAR_BOOL ("print-escape-multibyte", print_escape_multibyte,
8c1a1077
PJ
2147 doc: /* Non-nil means print multibyte characters in strings as \\xXXXX.
2148\(XXXX is the hex representation of the character code.)
2149This affects only `prin1'. */);
835d0be6
RS
2150 print_escape_multibyte = 0;
2151
29208e82 2152 DEFVAR_BOOL ("print-quoted", print_quoted,
8c1a1077 2153 doc: /* Non-nil means print quoted forms with reader syntax.
db75cb5f 2154I.e., (quote foo) prints as 'foo, (function foo) as #'foo. */);
2f100b5c
EN
2155 print_quoted = 0;
2156
29208e82 2157 DEFVAR_LISP ("print-gensym", Vprint_gensym,
8c1a1077
PJ
2158 doc: /* Non-nil means print uninterned symbols so they will read as uninterned.
2159I.e., the value of (make-symbol \"foobar\") prints as #:foobar.
2160When the uninterned symbol appears within a recursive data structure,
2161and the symbol appears more than once, in addition use the #N# and #N=
2162constructs as needed, so that multiple references to the same symbol are
2163shared once again when the text is read back. */);
e0f69431
RS
2164 Vprint_gensym = Qnil;
2165
29208e82 2166 DEFVAR_LISP ("print-circle", Vprint_circle,
fb7ada5f 2167 doc: /* Non-nil means print recursive structures using #N= and #N# syntax.
8c1a1077
PJ
2168If nil, printing proceeds recursively and may lead to
2169`max-lisp-eval-depth' being exceeded or an error may occur:
2170\"Apparently circular structure being printed.\" Also see
2171`print-length' and `print-level'.
2172If non-nil, shared substructures anywhere in the structure are printed
2173with `#N=' before the first occurrence (in the order of the print
2174representation) and `#N#' in place of each subsequent occurrence,
2175where N is a positive decimal integer. */);
0f25ecc6
RS
2176 Vprint_circle = Qnil;
2177
29208e82 2178 DEFVAR_LISP ("print-continuous-numbering", Vprint_continuous_numbering,
fb7ada5f 2179 doc: /* Non-nil means number continuously across print calls.
8c1a1077
PJ
2180This affects the numbers printed for #N= labels and #M# references.
2181See also `print-circle', `print-gensym', and `print-number-table'.
2182This variable should not be set with `setq'; bind it with a `let' instead. */);
0f25ecc6
RS
2183 Vprint_continuous_numbering = Qnil;
2184
29208e82 2185 DEFVAR_LISP ("print-number-table", Vprint_number_table,
8c1a1077
PJ
2186 doc: /* A vector used internally to produce `#N=' labels and `#N#' references.
2187The Lisp printer uses this vector to detect Lisp objects referenced more
e6d4cddd
RS
2188than once.
2189
2190When you bind `print-continuous-numbering' to t, you should probably
2191also bind `print-number-table' to nil. This ensures that the value of
2192`print-number-table' can be garbage-collected once the printing is
2193done. If all elements of `print-number-table' are nil, it means that
2194the printing done so far has not found any shared structure or objects
2195that need to be recorded in the table. */);
0f25ecc6 2196 Vprint_number_table = Qnil;
081e0581 2197
29208e82 2198 DEFVAR_LISP ("print-charset-text-property", Vprint_charset_text_property,
71ea13cb
KH
2199 doc: /* A flag to control printing of `charset' text property on printing a string.
2200The value must be nil, t, or `default'.
2201
2202If the value is nil, don't print the text property `charset'.
2203
2204If the value is t, always print the text property `charset'.
2205
2206If the value is `default', print the text property `charset' only when
2207the value is different from what is guessed in the current charset
dedbd91c 2208priorities. */);
71ea13cb
KH
2209 Vprint_charset_text_property = Qdefault;
2210
38010d50
JB
2211 /* prin1_to_string_buffer initialized in init_buffer_once in buffer.c */
2212 staticpro (&Vprin1_to_string_buffer);
2213
2214 defsubr (&Sprin1);
2215 defsubr (&Sprin1_to_string);
113620cc 2216 defsubr (&Serror_message_string);
38010d50
JB
2217 defsubr (&Sprinc);
2218 defsubr (&Sprint);
2219 defsubr (&Sterpri);
2220 defsubr (&Swrite_char);
2221 defsubr (&Sexternal_debugging_output);
6b61353c
KH
2222#ifdef WITH_REDIRECT_DEBUGGING_OUTPUT
2223 defsubr (&Sredirect_debugging_output);
2224#endif
38010d50 2225
cd3520a4
JB
2226 DEFSYM (Qexternal_debugging_output, "external-debugging-output");
2227 DEFSYM (Qprint_escape_newlines, "print-escape-newlines");
2228 DEFSYM (Qprint_escape_multibyte, "print-escape-multibyte");
2229 DEFSYM (Qprint_escape_nonascii, "print-escape-nonascii");
835d0be6 2230
71ea13cb
KH
2231 print_prune_charset_plist = Qnil;
2232 staticpro (&print_prune_charset_plist);
38010d50 2233}