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