Mercurial > hg > xemacs-beta
annotate src/print.c @ 5117:3742ea8250b5 ben-lisp-object ben-lisp-object-final-ws-year-2005
Checking in final CVS version of workspace 'ben-lisp-object'
author | Ben Wing <ben@xemacs.org> |
---|---|
date | Sat, 26 Dec 2009 00:20:27 -0600 |
parents | d30cd499e445 |
children | e0db3c197671 |
rev | line source |
---|---|
428 | 1 /* Lisp object printing and output streams. |
2 Copyright (C) 1985, 1986, 1988, 1992-1995 Free Software Foundation, Inc. | |
3063 | 3 Copyright (C) 1995, 1996, 2000, 2001, 2002, 2003, 2005 Ben Wing. |
428 | 4 |
5 This file is part of XEmacs. | |
6 | |
7 XEmacs is free software; you can redistribute it and/or modify it | |
8 under the terms of the GNU General Public License as published by the | |
9 Free Software Foundation; either version 2, or (at your option) any | |
10 later version. | |
11 | |
12 XEmacs is distributed in the hope that it will be useful, but WITHOUT | |
13 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
14 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License | |
15 for more details. | |
16 | |
17 You should have received a copy of the GNU General Public License | |
18 along with XEmacs; see the file COPYING. If not, write to | |
19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330, | |
20 Boston, MA 02111-1307, USA. */ | |
21 | |
22 /* Synched up with: Not synched with FSF. */ | |
23 | |
24 /* This file has been Mule-ized. */ | |
25 | |
771 | 26 /* Seriously divergent from FSF by this point. |
27 | |
28 Seriously hacked on by Ben Wing for Mule. All stdio code also by Ben, | |
29 as well as the debugging code (initial version of debug_print(), though, | |
30 by Jamie Zawinski) and the _fmt interfaces. Also a fair amount of work | |
31 by Hrvoje, e.g. floating-point code and rewriting to avoid O(N^2) | |
32 consing when outputting to the echo area. Print-circularity code by | |
33 Martin? */ | |
428 | 34 |
35 #include <config.h> | |
36 #include "lisp.h" | |
37 | |
38 #include "backtrace.h" | |
39 #include "buffer.h" | |
40 #include "bytecode.h" | |
872 | 41 #include "device-impl.h" |
428 | 42 #include "extents.h" |
43 #include "frame.h" | |
44 #include "insdel.h" | |
45 #include "lstream.h" | |
771 | 46 #include "opaque.h" |
800 | 47 |
872 | 48 #include "console-tty-impl.h" |
49 #include "console-stream-impl.h" | |
442 | 50 #ifdef WIN32_NATIVE |
51 #include "console-msw.h" | |
52 #endif | |
428 | 53 |
800 | 54 #include "sysfile.h" |
55 | |
428 | 56 #include <float.h> |
57 /* Define if not in float.h */ | |
58 #ifndef DBL_DIG | |
59 #define DBL_DIG 16 | |
60 #endif | |
61 | |
62 Lisp_Object Vstandard_output, Qstandard_output; | |
63 | |
64 /* The subroutine object for external-debugging-output is kept here | |
65 for the convenience of the debugger. */ | |
442 | 66 Lisp_Object Qexternal_debugging_output, Qalternate_debugging_output; |
67 | |
68 #ifdef HAVE_MS_WINDOWS | |
69 Lisp_Object Qmswindows_debugging_output; | |
70 #endif | |
428 | 71 |
72 /* Avoid actual stack overflow in print. */ | |
73 static int print_depth; | |
74 | |
75 /* Detect most circularities to print finite output. */ | |
76 #define PRINT_CIRCLE 200 | |
77 static Lisp_Object being_printed[PRINT_CIRCLE]; | |
78 | |
79 /* Maximum length of list or vector to print in full; noninteger means | |
80 effectively infinity */ | |
81 | |
82 Lisp_Object Vprint_length; | |
83 Lisp_Object Qprint_length; | |
84 | |
85 /* Maximum length of string to print in full; noninteger means | |
86 effectively infinity */ | |
87 | |
88 Lisp_Object Vprint_string_length; | |
89 Lisp_Object Qprint_string_length; | |
90 | |
91 /* Maximum depth of list to print in full; noninteger means | |
92 effectively infinity. */ | |
93 | |
94 Lisp_Object Vprint_level; | |
95 | |
96 /* Label to use when making echo-area messages. */ | |
97 | |
98 Lisp_Object Vprint_message_label; | |
99 | |
100 /* Nonzero means print newlines in strings as \n. */ | |
101 | |
102 int print_escape_newlines; | |
103 int print_readably; | |
104 | |
105 /* Non-nil means print #: before uninterned symbols. | |
106 Neither t nor nil means so that and don't clear Vprint_gensym_alist | |
107 on entry to and exit from print functions. */ | |
108 Lisp_Object Vprint_gensym; | |
109 Lisp_Object Vprint_gensym_alist; | |
110 | |
111 Lisp_Object Qdisplay_error; | |
112 Lisp_Object Qprint_message_label; | |
113 | |
114 /* Force immediate output of all printed data. Used for debugging. */ | |
115 int print_unbuffered; | |
116 | |
117 FILE *termscript; /* Stdio stream being used for copy of all output. */ | |
118 | |
1346 | 119 static void write_string_to_alternate_debugging_output (const Ibyte *str, |
771 | 120 Bytecount len); |
121 | |
1957 | 122 /* To avoid consing in debug_prin1, we package up variables we need to bind |
123 into an opaque object. */ | |
124 struct debug_bindings | |
125 { | |
2367 | 126 int inhibit_non_essential_conversion_operations; |
1957 | 127 int print_depth; |
128 int print_readably; | |
129 int print_unbuffered; | |
130 int gc_currently_forbidden; | |
131 Lisp_Object Vprint_length; | |
132 Lisp_Object Vprint_level; | |
133 Lisp_Object Vinhibit_quit; | |
134 }; | |
135 | |
136 static Lisp_Object debug_prin1_bindings; | |
428 | 137 |
138 | |
139 int stdout_needs_newline; | |
1346 | 140 int stdout_clear_before_next_output; |
428 | 141 |
771 | 142 /* Basic function to actually write to a stdio stream or TTY console. */ |
143 | |
442 | 144 static void |
1346 | 145 write_string_to_stdio_stream_1 (FILE *stream, struct console *con, |
146 const Ibyte *ptr, Bytecount len, | |
147 int must_flush) | |
428 | 148 { |
771 | 149 Extbyte *extptr = 0; |
150 Bytecount extlen = 0; | |
151 int output_is_std_handle = | |
152 stream ? stream == stdout || stream == stderr : | |
153 CONSOLE_TTY_DATA (con)->is_stdio; | |
154 | |
155 if (stream || output_is_std_handle) | |
156 { | |
2367 | 157 if (initialized && !inhibit_non_essential_conversion_operations) |
771 | 158 TO_EXTERNAL_FORMAT (DATA, (ptr, len), |
159 ALLOCA, (extptr, extlen), | |
160 Qterminal); | |
161 else | |
162 { | |
2367 | 163 #ifdef NON_ASCII_INTERNAL_FORMAT |
164 #error Do something here | |
165 #else | |
771 | 166 extptr = (Extbyte *) ptr; |
167 extlen = (Bytecount) len; | |
2367 | 168 #endif |
771 | 169 } |
170 } | |
171 | |
428 | 172 if (stream) |
173 { | |
442 | 174 #ifdef WIN32_NATIVE |
175 HANDLE errhand = GetStdHandle (STD_INPUT_HANDLE); | |
176 int no_useful_stderr = errhand == 0 || errhand == INVALID_HANDLE_VALUE; | |
177 | |
178 if (!no_useful_stderr) | |
179 no_useful_stderr = !PeekNamedPipe (errhand, 0, 0, 0, 0, 0); | |
180 /* we typically have no useful stdout/stderr under windows if we're | |
181 being invoked graphically. */ | |
182 if (no_useful_stderr) | |
771 | 183 mswindows_output_console_string (ptr, len); |
442 | 184 else |
428 | 185 #endif |
442 | 186 { |
771 | 187 retry_fwrite (extptr, 1, extlen, stream); |
442 | 188 #ifdef WIN32_NATIVE |
189 /* Q122442 says that pipes are "treated as files, not as | |
190 devices", and that this is a feature. Before I found that | |
191 article, I thought it was a bug. Thanks MS, I feel much | |
192 better now. - kkm */ | |
193 must_flush = 1; | |
194 #endif | |
195 if (must_flush) | |
196 fflush (stream); | |
197 } | |
428 | 198 } |
199 else | |
771 | 200 /* The stream itself does conversion to external format */ |
201 Lstream_write (XLSTREAM (CONSOLE_TTY_DATA (con)->outstream), ptr, len); | |
442 | 202 |
203 if (output_is_std_handle) | |
428 | 204 { |
205 if (termscript) | |
206 { | |
771 | 207 retry_fwrite (extptr, 1, extlen, termscript); |
428 | 208 fflush (termscript); |
209 } | |
1346 | 210 stdout_needs_newline = (ptr[len - 1] != '\n'); |
428 | 211 } |
212 } | |
213 | |
1346 | 214 /* Write to a stdio stream or TTY console, first clearing the left side |
215 if necessary. */ | |
216 | |
217 static void | |
218 write_string_to_stdio_stream (FILE *stream, struct console *con, | |
219 const Ibyte *ptr, Bytecount len, | |
220 int must_flush) | |
221 { | |
222 if (stdout_clear_before_next_output && | |
223 (stream ? stream == stdout || stream == stderr : | |
224 CONSOLE_TTY_DATA (con)->is_stdio)) | |
225 { | |
226 if (stdout_needs_newline) | |
227 write_string_to_stdio_stream_1 (stream, con, (Ibyte *) "\n", 1, | |
228 must_flush); | |
229 stdout_clear_before_next_output = 0; | |
230 } | |
231 | |
232 write_string_to_stdio_stream_1 (stream, con, ptr, len, must_flush); | |
233 } | |
234 | |
235 /* | |
236 EXT_PRINT_STDOUT = stdout or its equivalent (may be a | |
237 console window under MS Windows) | |
238 EXT_PRINT_STDERR = stderr or its equivalent (may be a | |
239 console window under MS Windows) | |
240 EXT_PRINT_ALTERNATE = an internal character array; see | |
241 `alternate-debugging-output' | |
242 EXT_PRINT_MSWINDOWS = Under MS Windows, the "debugging output" that | |
243 debuggers can hook into; uses OutputDebugString() | |
244 system call | |
245 EXT_PRINT_ALL = all of the above except stdout | |
246 */ | |
247 | |
248 enum ext_print | |
249 { | |
250 EXT_PRINT_STDOUT = 1, | |
251 EXT_PRINT_STDERR = 2, | |
252 EXT_PRINT_ALTERNATE = 4, | |
253 EXT_PRINT_MSWINDOWS = 8, | |
254 EXT_PRINT_ALL = 14 | |
255 }; | |
256 | |
257 static void | |
258 write_string_to_external_output (const Ibyte *ptr, Bytecount len, | |
259 int dest) | |
260 { | |
261 if (dest & EXT_PRINT_STDOUT) | |
262 write_string_to_stdio_stream (stdout, 0, ptr, len, 1); | |
263 if (dest & EXT_PRINT_STDERR) | |
264 write_string_to_stdio_stream (stderr, 0, ptr, len, 1); | |
265 if (dest & EXT_PRINT_ALTERNATE) | |
266 write_string_to_alternate_debugging_output (ptr, len); | |
267 #ifdef WIN32_NATIVE | |
268 if (dest & EXT_PRINT_MSWINDOWS) | |
269 write_string_to_mswindows_debugging_output (ptr, len); | |
270 #endif | |
271 } | |
272 | |
273 /* #### The following function should make use of a call to the | |
274 emacs_vsprintf_*() functions rather than just using vsprintf. This is | |
275 the only way to ensure that I18N3 works properly (many implementations | |
276 of the *printf() functions, including the ones included in glibc, do not | |
277 implement the %###$ argument-positioning syntax). | |
442 | 278 |
279 Note, however, that to do this, we'd have to | |
280 | |
281 1) pre-allocate all the lstreams and do whatever else was necessary | |
282 to make sure that no allocation occurs, since these functions may be | |
283 called from fatal_error_signal(). | |
284 | |
285 2) (to be really correct) make a new lstream that outputs using | |
1346 | 286 mswindows_output_console_string(). |
287 | |
288 3) A reasonable compromise might be to use emacs_vsprintf() when we're | |
289 in a safe state, and when not, use plain vsprintf(). */ | |
442 | 290 |
771 | 291 static void |
1346 | 292 write_string_to_external_output_va (const CIbyte *fmt, va_list args, |
293 int dest) | |
442 | 294 { |
867 | 295 Ibyte kludge[8192]; |
771 | 296 Bytecount kludgelen; |
297 | |
2367 | 298 if (initialized && !inhibit_non_essential_conversion_operations) |
771 | 299 fmt = GETTEXT (fmt); |
867 | 300 vsprintf ((CIbyte *) kludge, fmt, args); |
771 | 301 kludgelen = qxestrlen (kludge); |
1346 | 302 write_string_to_external_output (kludge, kludgelen, dest); |
442 | 303 } |
304 | |
771 | 305 /* Output portably to stderr or its equivalent (i.e. may be a console |
306 window under MS Windows); do external-format conversion and call GETTEXT | |
307 on the format string. Automatically flush when done. | |
442 | 308 |
2731 | 309 NOTE: CIbyte means "internal format" data. This includes the "..." |
310 arguments. For numerical arguments, we have to assume that vsprintf | |
311 will be a good boy and format them as ASCII. For Mule internal coding | |
312 (and UTF-8 internal coding, if/when we get it), it is safe to pass | |
313 string values in internal format to be formatted, because zero octets | |
314 only occur in the NUL character itself. Similarly, it is safe to pass | |
315 pure ASCII literal strings for these functions. *Everything else must | |
316 be converted, including all external data.* | |
317 | |
318 This function is safe to use even when not initialized or when dying -- | |
319 we don't do conversion in such cases. */ | |
771 | 320 |
321 void | |
867 | 322 stderr_out (const CIbyte *fmt, ...) |
442 | 323 { |
324 va_list args; | |
325 va_start (args, fmt); | |
1346 | 326 write_string_to_external_output_va (fmt, args, EXT_PRINT_STDERR); |
442 | 327 va_end (args); |
328 } | |
329 | |
771 | 330 /* Output portably to stdout or its equivalent (i.e. may be a console |
331 window under MS Windows). Works like stderr_out(). */ | |
442 | 332 |
771 | 333 void |
867 | 334 stdout_out (const CIbyte *fmt, ...) |
442 | 335 { |
336 va_list args; | |
337 va_start (args, fmt); | |
1346 | 338 write_string_to_external_output_va (fmt, args, EXT_PRINT_STDOUT); |
339 va_end (args); | |
340 } | |
341 | |
342 /* Output portably to print destination as specified by DEST. */ | |
343 | |
344 void | |
345 external_out (int dest, const CIbyte *fmt, ...) | |
346 { | |
347 va_list args; | |
348 va_start (args, fmt); | |
349 write_string_to_external_output_va (fmt, args, dest); | |
442 | 350 va_end (args); |
771 | 351 } |
352 | |
353 /* Output portably to stderr or its equivalent (i.e. may be a console | |
354 window under MS Windows), as well as alternate-debugging-output and | |
355 (under MS Windows) the C debugging output, i.e. OutputDebugString(). | |
356 Works like stderr_out(). */ | |
357 | |
358 void | |
867 | 359 debug_out (const CIbyte *fmt, ...) |
771 | 360 { |
361 va_list args; | |
362 va_start (args, fmt); | |
1346 | 363 write_string_to_external_output_va (fmt, args, EXT_PRINT_ALL); |
771 | 364 va_end (args); |
442 | 365 } |
366 | |
367 DOESNT_RETURN | |
867 | 368 fatal (const CIbyte *fmt, ...) |
442 | 369 { |
370 va_list args; | |
371 va_start (args, fmt); | |
372 | |
771 | 373 stderr_out ("\nXEmacs: fatal error: "); |
1346 | 374 write_string_to_external_output_va (fmt, args, EXT_PRINT_STDERR); |
442 | 375 stderr_out ("\n"); |
376 | |
377 va_end (args); | |
378 exit (1); | |
379 } | |
380 | |
428 | 381 /* Write a string to the output location specified in FUNCTION. |
382 Arguments NONRELOC, RELOC, OFFSET, and LEN are as in | |
771 | 383 buffer_insert_string_1() in insdel.c. |
384 | |
385 FUNCTION is one of | |
386 | |
387 -- an lstream | |
388 -- a buffer (insert at point and advance point) | |
389 -- a marker (insert at marker and advance marker) | |
390 -- a frame (append to echo area; clear echo area first if | |
391 `print-message-label' has changed since the last time) | |
392 -- t or nil (send to stdout) | |
393 -- a Lisp function of one argument (call to get data output) | |
394 | |
395 Use Qexternal_debugging_output to get output to stderr. | |
396 */ | |
428 | 397 |
398 static void | |
867 | 399 output_string (Lisp_Object function, const Ibyte *nonreloc, |
428 | 400 Lisp_Object reloc, Bytecount offset, Bytecount len) |
401 { | |
402 /* This function can GC */ | |
403 Charcount cclen; | |
404 /* We change the value of nonreloc (fetching it from reloc as | |
405 necessary), but we don't want to pass this changed value on to | |
406 other functions that take both a nonreloc and a reloc, or things | |
407 may get confused and an assertion failure in | |
408 fixup_internal_substring() may get triggered. */ | |
867 | 409 const Ibyte *newnonreloc = nonreloc; |
428 | 410 struct gcpro gcpro1, gcpro2; |
411 | |
412 /* Emacs won't print while GCing, but an external debugger might */ | |
771 | 413 #ifdef NO_PRINT_DURING_GC |
428 | 414 if (gc_in_progress) return; |
771 | 415 #endif |
428 | 416 |
417 /* Perhaps not necessary but probably safer. */ | |
418 GCPRO2 (function, reloc); | |
419 | |
420 fixup_internal_substring (newnonreloc, reloc, offset, &len); | |
421 | |
422 if (STRINGP (reloc)) | |
771 | 423 { |
793 | 424 cclen = string_offset_byte_to_char_len (reloc, offset, len); |
771 | 425 newnonreloc = XSTRING_DATA (reloc); |
426 } | |
427 else | |
428 cclen = bytecount_to_charcount (newnonreloc + offset, len); | |
428 | 429 |
430 if (LSTREAMP (function)) | |
431 { | |
432 if (STRINGP (reloc)) | |
433 { | |
434 /* Protect against Lstream_write() causing a GC and | |
435 relocating the string. For small strings, we do it by | |
436 alloc'ing the string and using a copy; for large strings, | |
437 we inhibit GC. */ | |
438 if (len < 65536) | |
439 { | |
2367 | 440 Ibyte *copied = alloca_ibytes (len); |
428 | 441 memcpy (copied, newnonreloc + offset, len); |
442 Lstream_write (XLSTREAM (function), copied, len); | |
443 } | |
1957 | 444 else if (gc_currently_forbidden) |
445 { | |
446 /* Avoid calling begin_gc_forbidden, which conses. We can reach | |
447 this point from the cons debug code, which will get us into | |
448 an infinite loop if we cons again. */ | |
449 Lstream_write (XLSTREAM (function), newnonreloc + offset, len); | |
450 } | |
428 | 451 else |
452 { | |
771 | 453 int speccount = begin_gc_forbidden (); |
428 | 454 Lstream_write (XLSTREAM (function), newnonreloc + offset, len); |
771 | 455 unbind_to (speccount); |
428 | 456 } |
457 } | |
458 else | |
459 Lstream_write (XLSTREAM (function), newnonreloc + offset, len); | |
460 | |
461 if (print_unbuffered) | |
462 Lstream_flush (XLSTREAM (function)); | |
463 } | |
464 else if (BUFFERP (function)) | |
465 { | |
466 CHECK_LIVE_BUFFER (function); | |
467 buffer_insert_string (XBUFFER (function), nonreloc, reloc, offset, len); | |
468 } | |
469 else if (MARKERP (function)) | |
470 { | |
471 /* marker_position() will err if marker doesn't point anywhere. */ | |
665 | 472 Charbpos spoint = marker_position (function); |
428 | 473 |
474 buffer_insert_string_1 (XMARKER (function)->buffer, | |
475 spoint, nonreloc, reloc, offset, len, | |
476 0); | |
477 Fset_marker (function, make_int (spoint + cclen), | |
478 Fmarker_buffer (function)); | |
479 } | |
480 else if (FRAMEP (function)) | |
481 { | |
482 /* This gets used by functions not invoking print_prepare(), | |
483 such as Fwrite_char, Fterpri, etc.. */ | |
484 struct frame *f = XFRAME (function); | |
485 CHECK_LIVE_FRAME (function); | |
486 | |
487 if (!EQ (Vprint_message_label, echo_area_status (f))) | |
488 clear_echo_area_from_print (f, Qnil, 1); | |
489 echo_area_append (f, nonreloc, reloc, offset, len, Vprint_message_label); | |
490 } | |
491 else if (EQ (function, Qt) || EQ (function, Qnil)) | |
492 { | |
771 | 493 write_string_to_stdio_stream (stdout, 0, newnonreloc + offset, len, |
494 print_unbuffered); | |
495 } | |
496 else if (EQ (function, Qexternal_debugging_output)) | |
497 { | |
498 /* This is not strictly necessary, and somewhat of a hack, but it | |
499 avoids having each character passed separately to | |
500 `external-debugging-output'. #### Why do we pass each character | |
501 separately, anyway? | |
502 */ | |
503 write_string_to_stdio_stream (stderr, 0, newnonreloc + offset, len, | |
504 print_unbuffered); | |
428 | 505 } |
506 else | |
507 { | |
771 | 508 Charcount ccoff; |
428 | 509 Charcount iii; |
510 | |
771 | 511 if (STRINGP (reloc)) |
793 | 512 ccoff = string_index_byte_to_char (reloc, offset); |
771 | 513 else |
514 ccoff = bytecount_to_charcount (newnonreloc, offset); | |
515 | |
516 if (STRINGP (reloc)) | |
428 | 517 { |
771 | 518 for (iii = ccoff; iii < cclen + ccoff; iii++) |
519 { | |
867 | 520 call1 (function, make_char (string_ichar (reloc, iii))); |
771 | 521 if (STRINGP (reloc)) |
522 newnonreloc = XSTRING_DATA (reloc); | |
523 } | |
524 } | |
525 else | |
526 { | |
527 for (iii = ccoff; iii < cclen + ccoff; iii++) | |
528 { | |
529 call1 (function, | |
867 | 530 make_char (itext_ichar_n (newnonreloc, iii))); |
771 | 531 } |
428 | 532 } |
533 } | |
534 | |
535 UNGCPRO; | |
536 } | |
537 | |
538 #define RESET_PRINT_GENSYM do { \ | |
539 if (!CONSP (Vprint_gensym)) \ | |
540 Vprint_gensym_alist = Qnil; \ | |
541 } while (0) | |
542 | |
1261 | 543 Lisp_Object |
428 | 544 canonicalize_printcharfun (Lisp_Object printcharfun) |
545 { | |
546 if (NILP (printcharfun)) | |
547 printcharfun = Vstandard_output; | |
548 | |
1261 | 549 if (!noninteractive && (EQ (printcharfun, Qt) || NILP (printcharfun))) |
428 | 550 printcharfun = Fselected_frame (Qnil); /* print to minibuffer */ |
551 | |
552 return printcharfun; | |
553 } | |
554 | |
555 static Lisp_Object | |
556 print_prepare (Lisp_Object printcharfun, Lisp_Object *frame_kludge) | |
557 { | |
558 /* Emacs won't print while GCing, but an external debugger might */ | |
771 | 559 #ifdef NO_PRINT_DURING_GC |
428 | 560 if (gc_in_progress) |
561 return Qnil; | |
771 | 562 #endif |
563 | |
428 | 564 RESET_PRINT_GENSYM; |
565 | |
566 printcharfun = canonicalize_printcharfun (printcharfun); | |
567 | |
568 /* Here we could safely return the canonicalized PRINTCHARFUN. | |
569 However, if PRINTCHARFUN is a frame, printing of complex | |
570 structures becomes very expensive, because `append-message' | |
571 (called by echo_area_append) gets called as many times as | |
572 output_string() is called (and that's a *lot*). append-message | |
573 tries to keep top of the message-stack in sync with the contents | |
574 of " *Echo Area" buffer, consing a new string for each component | |
575 of the printed structure. For instance, if you print (a a), | |
576 append-message will cons up the following strings: | |
577 | |
578 "(" | |
579 "(a" | |
580 "(a " | |
581 "(a a" | |
582 "(a a)" | |
583 | |
584 and will use only the last one. With larger objects, this turns | |
585 into an O(n^2) consing frenzy that locks up XEmacs in incessant | |
586 garbage collection. | |
587 | |
588 We prevent this by creating a resizing_buffer stream and letting | |
589 the printer write into it. print_finish() will notice this | |
590 stream, and invoke echo_area_append() with the stream's buffer, | |
591 only once. */ | |
592 if (FRAMEP (printcharfun)) | |
593 { | |
594 CHECK_LIVE_FRAME (printcharfun); | |
595 *frame_kludge = printcharfun; | |
596 printcharfun = make_resizing_buffer_output_stream (); | |
597 } | |
598 | |
599 return printcharfun; | |
600 } | |
601 | |
602 static void | |
603 print_finish (Lisp_Object stream, Lisp_Object frame_kludge) | |
604 { | |
605 /* Emacs won't print while GCing, but an external debugger might */ | |
771 | 606 #ifdef NO_PRINT_DURING_GC |
428 | 607 if (gc_in_progress) |
608 return; | |
771 | 609 #endif |
610 | |
428 | 611 RESET_PRINT_GENSYM; |
612 | |
613 /* See the comment in print_prepare(). */ | |
614 if (FRAMEP (frame_kludge)) | |
615 { | |
616 struct frame *f = XFRAME (frame_kludge); | |
617 Lstream *str = XLSTREAM (stream); | |
618 CHECK_LIVE_FRAME (frame_kludge); | |
619 | |
620 Lstream_flush (str); | |
621 if (!EQ (Vprint_message_label, echo_area_status (f))) | |
622 clear_echo_area_from_print (f, Qnil, 1); | |
623 echo_area_append (f, resizing_buffer_stream_ptr (str), | |
624 Qnil, 0, Lstream_byte_count (str), | |
625 Vprint_message_label); | |
626 Lstream_delete (str); | |
627 } | |
628 } | |
629 | |
630 | |
771 | 631 /* Write internal-format data to STREAM. See output_string() for |
632 interpretation of STREAM. | |
633 | |
634 NOTE: Do not call this with the data of a Lisp_String, as | |
428 | 635 printcharfun might cause a GC, which might cause the string's data |
636 to be relocated. To princ a Lisp string, use: | |
637 | |
638 print_internal (string, printcharfun, 0); | |
639 | |
640 Also note that STREAM should be the result of | |
641 canonicalize_printcharfun() (i.e. Qnil means stdout, not | |
642 Vstandard_output, etc.) */ | |
643 void | |
867 | 644 write_string_1 (Lisp_Object stream, const Ibyte *str, Bytecount size) |
428 | 645 { |
646 /* This function can GC */ | |
800 | 647 #ifdef ERROR_CHECK_TEXT |
428 | 648 assert (size >= 0); |
649 #endif | |
650 output_string (stream, str, Qnil, 0, size); | |
651 } | |
652 | |
653 void | |
867 | 654 write_string (Lisp_Object stream, const Ibyte *str) |
771 | 655 { |
656 /* This function can GC */ | |
826 | 657 write_string_1 (stream, str, qxestrlen (str)); |
771 | 658 } |
659 | |
660 void | |
867 | 661 write_c_string (Lisp_Object stream, const CIbyte *str) |
428 | 662 { |
663 /* This function can GC */ | |
867 | 664 write_string_1 (stream, (const Ibyte *) str, strlen (str)); |
428 | 665 } |
666 | |
793 | 667 void |
826 | 668 write_eistring (Lisp_Object stream, const Eistring *ei) |
793 | 669 { |
826 | 670 write_string_1 (stream, eidata (ei), eilen (ei)); |
793 | 671 } |
672 | |
771 | 673 /* Write a printf-style string to STREAM; see output_string(). */ |
674 | |
675 void | |
867 | 676 write_fmt_string (Lisp_Object stream, const CIbyte *fmt, ...) |
771 | 677 { |
678 va_list va; | |
867 | 679 Ibyte *str; |
771 | 680 Bytecount len; |
681 int count; | |
682 | |
683 va_start (va, fmt); | |
684 str = emacs_vsprintf_malloc (fmt, va, &len); | |
685 va_end (va); | |
686 count = record_unwind_protect_freeing (str); | |
826 | 687 write_string_1 (stream, str, len); |
771 | 688 unbind_to (count); |
689 } | |
690 | |
691 /* Write a printf-style string to STREAM, where the arguments are | |
692 Lisp objects and not C strings or integers; see output_string(). | |
693 | |
694 #### It shouldn't be necessary to specify the number of arguments. | |
695 This would require some rewriting of the doprnt() functions, though. */ | |
696 | |
697 void | |
867 | 698 write_fmt_string_lisp (Lisp_Object stream, const CIbyte *fmt, int nargs, ...) |
771 | 699 { |
700 Lisp_Object *args = alloca_array (Lisp_Object, nargs); | |
701 va_list va; | |
702 int i; | |
867 | 703 Ibyte *str; |
771 | 704 Bytecount len; |
705 int count; | |
706 | |
707 va_start (va, nargs); | |
708 for (i = 0; i < nargs; i++) | |
709 args[i] = va_arg (va, Lisp_Object); | |
710 va_end (va); | |
711 str = emacs_vsprintf_malloc_lisp (fmt, Qnil, nargs, args, &len); | |
712 count = record_unwind_protect_freeing (str); | |
826 | 713 write_string_1 (stream, str, len); |
771 | 714 unbind_to (count); |
715 } | |
716 | |
717 void | |
867 | 718 stderr_out_lisp (const CIbyte *fmt, int nargs, ...) |
771 | 719 { |
720 Lisp_Object *args = alloca_array (Lisp_Object, nargs); | |
721 va_list va; | |
722 int i; | |
867 | 723 Ibyte *str; |
771 | 724 Bytecount len; |
725 int count; | |
726 | |
727 va_start (va, nargs); | |
728 for (i = 0; i < nargs; i++) | |
729 args[i] = va_arg (va, Lisp_Object); | |
730 va_end (va); | |
731 str = emacs_vsprintf_malloc_lisp (fmt, Qnil, nargs, args, &len); | |
732 count = record_unwind_protect_freeing (str); | |
826 | 733 write_string_1 (Qexternal_debugging_output, str, len); |
771 | 734 unbind_to (count); |
735 } | |
736 | |
428 | 737 |
738 DEFUN ("write-char", Fwrite_char, 1, 2, 0, /* | |
444 | 739 Output character CHARACTER to stream STREAM. |
428 | 740 STREAM defaults to the value of `standard-output' (which see). |
741 */ | |
444 | 742 (character, stream)) |
428 | 743 { |
744 /* This function can GC */ | |
867 | 745 Ibyte str[MAX_ICHAR_LEN]; |
428 | 746 Bytecount len; |
747 | |
444 | 748 CHECK_CHAR_COERCE_INT (character); |
867 | 749 len = set_itext_ichar (str, XCHAR (character)); |
428 | 750 output_string (canonicalize_printcharfun (stream), str, Qnil, 0, len); |
444 | 751 return character; |
428 | 752 } |
753 | |
754 void | |
755 temp_output_buffer_setup (Lisp_Object bufname) | |
756 { | |
757 /* This function can GC */ | |
758 struct buffer *old = current_buffer; | |
759 Lisp_Object buf; | |
760 | |
761 #ifdef I18N3 | |
762 /* #### This function should accept a Lisp_Object instead of a char *, | |
763 so that proper translation on the buffer name can occur. */ | |
764 #endif | |
765 | |
766 Fset_buffer (Fget_buffer_create (bufname)); | |
767 | |
768 current_buffer->read_only = Qnil; | |
769 Ferase_buffer (Qnil); | |
770 | |
793 | 771 buf = wrap_buffer (current_buffer); |
428 | 772 specbind (Qstandard_output, buf); |
773 | |
774 set_buffer_internal (old); | |
775 } | |
776 | |
777 Lisp_Object | |
778 internal_with_output_to_temp_buffer (Lisp_Object bufname, | |
779 Lisp_Object (*function) (Lisp_Object arg), | |
780 Lisp_Object arg, | |
781 Lisp_Object same_frame) | |
782 { | |
783 int speccount = specpdl_depth (); | |
784 struct gcpro gcpro1, gcpro2, gcpro3; | |
785 Lisp_Object buf = Qnil; | |
786 | |
787 GCPRO3 (buf, arg, same_frame); | |
788 | |
789 temp_output_buffer_setup (bufname); | |
790 buf = Vstandard_output; | |
791 | |
792 arg = (*function) (arg); | |
793 | |
794 temp_output_buffer_show (buf, same_frame); | |
795 UNGCPRO; | |
796 | |
771 | 797 return unbind_to_1 (speccount, arg); |
428 | 798 } |
799 | |
800 DEFUN ("with-output-to-temp-buffer", Fwith_output_to_temp_buffer, 1, UNEVALLED, 0, /* | |
801 Bind `standard-output' to buffer BUFNAME, eval BODY, then show that buffer. | |
802 The buffer is cleared out initially, and marked as unmodified when done. | |
803 All output done by BODY is inserted in that buffer by default. | |
804 The buffer is displayed in another window, but not selected. | |
805 The value of the last form in BODY is returned. | |
806 If BODY does not finish normally, the buffer BUFNAME is not displayed. | |
807 | |
808 If variable `temp-buffer-show-function' is non-nil, call it at the end | |
809 to get the buffer displayed. It gets one argument, the buffer to display. | |
810 */ | |
811 (args)) | |
812 { | |
813 /* This function can GC */ | |
814 Lisp_Object name = Qnil; | |
815 int speccount = specpdl_depth (); | |
816 struct gcpro gcpro1, gcpro2; | |
817 Lisp_Object val = Qnil; | |
818 | |
819 #ifdef I18N3 | |
820 /* #### should set the buffer to be translating. See print_internal(). */ | |
821 #endif | |
822 | |
823 GCPRO2 (name, val); | |
824 name = Feval (XCAR (args)); | |
825 | |
826 CHECK_STRING (name); | |
827 | |
828 temp_output_buffer_setup (name); | |
829 UNGCPRO; | |
830 | |
831 val = Fprogn (XCDR (args)); | |
832 | |
833 temp_output_buffer_show (Vstandard_output, Qnil); | |
834 | |
771 | 835 return unbind_to_1 (speccount, val); |
428 | 836 } |
837 | |
838 DEFUN ("terpri", Fterpri, 0, 1, 0, /* | |
839 Output a newline to STREAM. | |
840 If STREAM is omitted or nil, the value of `standard-output' is used. | |
841 */ | |
842 (stream)) | |
843 { | |
844 /* This function can GC */ | |
826 | 845 write_c_string (canonicalize_printcharfun (stream), "\n"); |
428 | 846 return Qt; |
847 } | |
848 | |
849 DEFUN ("prin1", Fprin1, 1, 2, 0, /* | |
850 Output the printed representation of OBJECT, any Lisp object. | |
851 Quoting characters are printed when needed to make output that `read' | |
852 can handle, whenever this is possible. | |
853 Output stream is STREAM, or value of `standard-output' (which see). | |
854 */ | |
855 (object, stream)) | |
856 { | |
857 /* This function can GC */ | |
858 Lisp_Object frame = Qnil; | |
859 struct gcpro gcpro1, gcpro2; | |
860 GCPRO2 (object, stream); | |
861 | |
862 stream = print_prepare (stream, &frame); | |
863 print_internal (object, stream, 1); | |
864 print_finish (stream, frame); | |
865 | |
866 UNGCPRO; | |
867 return object; | |
868 } | |
869 | |
870 DEFUN ("prin1-to-string", Fprin1_to_string, 1, 2, 0, /* | |
871 Return a string containing the printed representation of OBJECT, | |
872 any Lisp object. Quoting characters are used when needed to make output | |
873 that `read' can handle, whenever this is possible, unless the optional | |
874 second argument NOESCAPE is non-nil. | |
875 */ | |
876 (object, noescape)) | |
877 { | |
878 /* This function can GC */ | |
879 Lisp_Object result = Qnil; | |
880 Lisp_Object stream = make_resizing_buffer_output_stream (); | |
881 Lstream *str = XLSTREAM (stream); | |
882 /* gcpro OBJECT in case a caller forgot to do so */ | |
883 struct gcpro gcpro1, gcpro2, gcpro3; | |
884 GCPRO3 (object, stream, result); | |
885 | |
886 RESET_PRINT_GENSYM; | |
887 print_internal (object, stream, NILP (noescape)); | |
888 RESET_PRINT_GENSYM; | |
889 Lstream_flush (str); | |
890 UNGCPRO; | |
891 result = make_string (resizing_buffer_stream_ptr (str), | |
892 Lstream_byte_count (str)); | |
893 Lstream_delete (str); | |
894 return result; | |
895 } | |
896 | |
897 DEFUN ("princ", Fprinc, 1, 2, 0, /* | |
898 Output the printed representation of OBJECT, any Lisp object. | |
899 No quoting characters are used; no delimiters are printed around | |
900 the contents of strings. | |
444 | 901 Output stream is STREAM, or value of `standard-output' (which see). |
428 | 902 */ |
903 (object, stream)) | |
904 { | |
905 /* This function can GC */ | |
906 Lisp_Object frame = Qnil; | |
907 struct gcpro gcpro1, gcpro2; | |
908 | |
909 GCPRO2 (object, stream); | |
910 stream = print_prepare (stream, &frame); | |
911 print_internal (object, stream, 0); | |
912 print_finish (stream, frame); | |
913 UNGCPRO; | |
914 return object; | |
915 } | |
916 | |
917 DEFUN ("print", Fprint, 1, 2, 0, /* | |
918 Output the printed representation of OBJECT, with newlines around it. | |
919 Quoting characters are printed when needed to make output that `read' | |
920 can handle, whenever this is possible. | |
921 Output stream is STREAM, or value of `standard-output' (which see). | |
922 */ | |
923 (object, stream)) | |
924 { | |
925 /* This function can GC */ | |
926 Lisp_Object frame = Qnil; | |
927 struct gcpro gcpro1, gcpro2; | |
928 | |
929 GCPRO2 (object, stream); | |
930 stream = print_prepare (stream, &frame); | |
826 | 931 write_c_string (stream, "\n"); |
428 | 932 print_internal (object, stream, 1); |
826 | 933 write_c_string (stream, "\n"); |
428 | 934 print_finish (stream, frame); |
935 UNGCPRO; | |
936 return object; | |
937 } | |
938 | |
939 /* Print an error message for the error DATA to STREAM. This is a | |
940 complete implementation of `display-error', which used to be in | |
941 Lisp (see prim/cmdloop.el). It was ported to C so it can be used | |
942 efficiently by Ferror_message_string. Fdisplay_error and | |
943 Ferror_message_string are trivial wrappers around this function. | |
944 | |
945 STREAM should be the result of canonicalize_printcharfun(). */ | |
946 static void | |
947 print_error_message (Lisp_Object error_object, Lisp_Object stream) | |
948 { | |
949 /* This function can GC */ | |
950 Lisp_Object type = Fcar_safe (error_object); | |
951 Lisp_Object method = Qnil; | |
952 Lisp_Object tail; | |
953 | |
954 /* No need to GCPRO anything under the assumption that ERROR_OBJECT | |
955 is GCPRO'd. */ | |
956 | |
957 if (! (CONSP (error_object) && SYMBOLP (type) | |
958 && CONSP (Fget (type, Qerror_conditions, Qnil)))) | |
959 goto error_throw; | |
960 | |
961 tail = XCDR (error_object); | |
962 while (!NILP (tail)) | |
963 { | |
964 if (CONSP (tail)) | |
965 tail = XCDR (tail); | |
966 else | |
967 goto error_throw; | |
968 } | |
969 tail = Fget (type, Qerror_conditions, Qnil); | |
970 while (!NILP (tail)) | |
971 { | |
972 if (!(CONSP (tail) && SYMBOLP (XCAR (tail)))) | |
973 goto error_throw; | |
974 else if (!NILP (Fget (XCAR (tail), Qdisplay_error, Qnil))) | |
975 { | |
976 method = Fget (XCAR (tail), Qdisplay_error, Qnil); | |
977 goto error_throw; | |
978 } | |
979 else | |
980 tail = XCDR (tail); | |
981 } | |
982 /* Default method */ | |
983 { | |
984 int first = 1; | |
985 int speccount = specpdl_depth (); | |
438 | 986 Lisp_Object frame = Qnil; |
987 struct gcpro gcpro1; | |
988 GCPRO1 (stream); | |
428 | 989 |
990 specbind (Qprint_message_label, Qerror); | |
438 | 991 stream = print_prepare (stream, &frame); |
992 | |
428 | 993 tail = Fcdr (error_object); |
994 if (EQ (type, Qerror)) | |
995 { | |
996 print_internal (Fcar (tail), stream, 0); | |
997 tail = Fcdr (tail); | |
998 } | |
999 else | |
1000 { | |
1001 Lisp_Object errmsg = Fget (type, Qerror_message, Qnil); | |
1002 if (NILP (errmsg)) | |
1003 print_internal (type, stream, 0); | |
1004 else | |
1005 print_internal (LISP_GETTEXT (errmsg), stream, 0); | |
1006 } | |
1007 while (!NILP (tail)) | |
1008 { | |
826 | 1009 write_c_string (stream, first ? ": " : ", "); |
563 | 1010 /* Most errors have an explanatory string as their first argument, |
1011 and it looks better not to put the quotes around it. */ | |
1012 print_internal (Fcar (tail), stream, | |
1013 !(first && STRINGP (Fcar (tail))) || | |
1014 !NILP (Fget (type, Qerror_lacks_explanatory_string, | |
1015 Qnil))); | |
428 | 1016 tail = Fcdr (tail); |
1017 first = 0; | |
1018 } | |
438 | 1019 print_finish (stream, frame); |
1020 UNGCPRO; | |
771 | 1021 unbind_to (speccount); |
428 | 1022 return; |
1023 /* not reached */ | |
1024 } | |
1025 | |
1026 error_throw: | |
1027 if (NILP (method)) | |
1028 { | |
826 | 1029 write_c_string (stream, GETTEXT ("Peculiar error ")); |
428 | 1030 print_internal (error_object, stream, 1); |
1031 return; | |
1032 } | |
1033 else | |
1034 { | |
1035 call2 (method, error_object, stream); | |
1036 } | |
1037 } | |
1038 | |
1039 DEFUN ("error-message-string", Ferror_message_string, 1, 1, 0, /* | |
1040 Convert ERROR-OBJECT to an error message, and return it. | |
1041 | |
1042 The format of ERROR-OBJECT should be (ERROR-SYMBOL . DATA). The | |
1043 message is equivalent to the one that would be issued by | |
1044 `display-error' with the same argument. | |
1045 */ | |
1046 (error_object)) | |
1047 { | |
1048 /* This function can GC */ | |
1049 Lisp_Object result = Qnil; | |
1050 Lisp_Object stream = make_resizing_buffer_output_stream (); | |
1051 struct gcpro gcpro1; | |
1052 GCPRO1 (stream); | |
1053 | |
1054 print_error_message (error_object, stream); | |
1055 Lstream_flush (XLSTREAM (stream)); | |
1056 result = make_string (resizing_buffer_stream_ptr (XLSTREAM (stream)), | |
1057 Lstream_byte_count (XLSTREAM (stream))); | |
1058 Lstream_delete (XLSTREAM (stream)); | |
1059 | |
1060 UNGCPRO; | |
1061 return result; | |
1062 } | |
1063 | |
1064 DEFUN ("display-error", Fdisplay_error, 2, 2, 0, /* | |
1065 Display ERROR-OBJECT on STREAM in a user-friendly way. | |
1066 */ | |
1067 (error_object, stream)) | |
1068 { | |
1069 /* This function can GC */ | |
1070 print_error_message (error_object, canonicalize_printcharfun (stream)); | |
1071 return Qnil; | |
1072 } | |
1073 | |
1074 | |
1075 Lisp_Object Vfloat_output_format; | |
1076 | |
1077 /* | |
1078 * This buffer should be at least as large as the max string size of the | |
440 | 1079 * largest float, printed in the biggest notation. This is undoubtedly |
428 | 1080 * 20d float_output_format, with the negative of the C-constant "HUGE" |
1081 * from <math.h>. | |
1082 * | |
1083 * On the vax the worst case is -1e38 in 20d format which takes 61 bytes. | |
1084 * | |
1085 * I assume that IEEE-754 format numbers can take 329 bytes for the worst | |
1086 * case of -1e307 in 20d float_output_format. What is one to do (short of | |
1087 * re-writing _doprnt to be more sane)? | |
1088 * -wsr | |
1089 */ | |
1090 void | |
1091 float_to_string (char *buf, double data) | |
1092 { | |
867 | 1093 Ibyte *cp, c; |
428 | 1094 int width; |
1095 | |
1096 if (NILP (Vfloat_output_format) | |
1097 || !STRINGP (Vfloat_output_format)) | |
1098 lose: | |
1099 sprintf (buf, "%.16g", data); | |
1100 else /* oink oink */ | |
1101 { | |
1102 /* Check that the spec we have is fully valid. | |
1103 This means not only valid for printf, | |
1104 but meant for floats, and reasonable. */ | |
1105 cp = XSTRING_DATA (Vfloat_output_format); | |
1106 | |
1107 if (cp[0] != '%') | |
1108 goto lose; | |
1109 if (cp[1] != '.') | |
1110 goto lose; | |
1111 | |
1112 cp += 2; | |
1113 for (width = 0; (c = *cp, isdigit (c)); cp++) | |
1114 { | |
1115 width *= 10; | |
1116 width += c - '0'; | |
1117 } | |
1118 | |
1119 if (*cp != 'e' && *cp != 'f' && *cp != 'g' && *cp != 'E' && *cp != 'G') | |
1120 goto lose; | |
1121 | |
1122 if (width < (int) (*cp != 'e' && *cp != 'E') || width > DBL_DIG) | |
1123 goto lose; | |
1124 | |
1125 if (cp[1] != 0) | |
1126 goto lose; | |
1127 | |
1128 sprintf (buf, (char *) XSTRING_DATA (Vfloat_output_format), | |
1129 data); | |
1130 } | |
1131 | |
1132 /* added by jwz: don't allow "1.0" to print as "1"; that destroys | |
1133 the read-equivalence of lisp objects. (* x 1) and (* x 1.0) do | |
1134 not do the same thing, so it's important that the printed | |
1135 representation of that form not be corrupted by the printer. | |
1136 */ | |
1137 { | |
867 | 1138 Ibyte *s = (Ibyte *) buf; /* don't use signed chars here! |
428 | 1139 isdigit() can't hack them! */ |
1140 if (*s == '-') s++; | |
1141 for (; *s; s++) | |
1142 /* if there's a non-digit, then there is a decimal point, or | |
1143 it's in exponential notation, both of which are ok. */ | |
1144 if (!isdigit (*s)) | |
1145 goto DONE_LABEL; | |
1146 /* otherwise, we need to hack it. */ | |
1147 *s++ = '.'; | |
1148 *s++ = '0'; | |
1149 *s = 0; | |
1150 } | |
1151 DONE_LABEL: | |
1152 | |
1153 /* Some machines print "0.4" as ".4". I don't like that. */ | |
1154 if (buf [0] == '.' || (buf [0] == '-' && buf [1] == '.')) | |
1155 { | |
1156 int i; | |
1157 for (i = strlen (buf) + 1; i >= 0; i--) | |
1158 buf [i+1] = buf [i]; | |
1159 buf [(buf [0] == '-' ? 1 : 0)] = '0'; | |
1160 } | |
1161 } | |
1162 | |
2500 | 1163 #define ONE_DIGIT(figure) *p++ = (char) (n / (figure) + '0') |
577 | 1164 #define ONE_DIGIT_ADVANCE(figure) (ONE_DIGIT (figure), n %= (figure)) |
1165 | |
1166 #define DIGITS_1(figure) ONE_DIGIT (figure) | |
1167 #define DIGITS_2(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_1 ((figure) / 10) | |
1168 #define DIGITS_3(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_2 ((figure) / 10) | |
1169 #define DIGITS_4(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_3 ((figure) / 10) | |
1170 #define DIGITS_5(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_4 ((figure) / 10) | |
1171 #define DIGITS_6(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_5 ((figure) / 10) | |
1172 #define DIGITS_7(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_6 ((figure) / 10) | |
1173 #define DIGITS_8(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_7 ((figure) / 10) | |
1174 #define DIGITS_9(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_8 ((figure) / 10) | |
1175 #define DIGITS_10(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_9 ((figure) / 10) | |
1176 | |
1177 /* DIGITS_<11-20> are only used on machines with 64-bit longs. */ | |
428 | 1178 |
577 | 1179 #define DIGITS_11(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_10 ((figure) / 10) |
1180 #define DIGITS_12(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_11 ((figure) / 10) | |
1181 #define DIGITS_13(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_12 ((figure) / 10) | |
1182 #define DIGITS_14(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_13 ((figure) / 10) | |
1183 #define DIGITS_15(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_14 ((figure) / 10) | |
1184 #define DIGITS_16(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_15 ((figure) / 10) | |
1185 #define DIGITS_17(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_16 ((figure) / 10) | |
1186 #define DIGITS_18(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_17 ((figure) / 10) | |
1187 #define DIGITS_19(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_18 ((figure) / 10) | |
1188 | |
1189 /* Print NUMBER to BUFFER in base 10. This is completely equivalent | |
1190 to `sprintf(buffer, "%ld", number)', only much faster. | |
1191 | |
1192 The speedup may make a difference in programs that frequently | |
1193 convert numbers to strings. Some implementations of sprintf, | |
1194 particularly the one in GNU libc, have been known to be extremely | |
1195 slow compared to this function. | |
1196 | |
1197 BUFFER should accept as many bytes as you expect the number to take | |
1198 up. On machines with 64-bit longs the maximum needed size is 24 | |
1199 bytes. That includes the worst-case digits, the optional `-' sign, | |
1200 and the trailing \0. */ | |
1201 | |
1202 void | |
428 | 1203 long_to_string (char *buffer, long number) |
1204 { | |
577 | 1205 char *p = buffer; |
1206 long n = number; | |
1207 | |
428 | 1208 #if (SIZEOF_LONG != 4) && (SIZEOF_LONG != 8) |
577 | 1209 /* We are running in a strange or misconfigured environment. Let |
1210 sprintf cope with it. */ | |
1211 sprintf (buffer, "%ld", n); | |
1212 #else /* (SIZEOF_LONG == 4) || (SIZEOF_LONG == 8) */ | |
428 | 1213 |
577 | 1214 if (n < 0) |
428 | 1215 { |
1216 *p++ = '-'; | |
577 | 1217 n = -n; |
428 | 1218 } |
1219 | |
577 | 1220 if (n < 10) { DIGITS_1 (1); } |
1221 else if (n < 100) { DIGITS_2 (10); } | |
1222 else if (n < 1000) { DIGITS_3 (100); } | |
1223 else if (n < 10000) { DIGITS_4 (1000); } | |
1224 else if (n < 100000) { DIGITS_5 (10000); } | |
1225 else if (n < 1000000) { DIGITS_6 (100000); } | |
1226 else if (n < 10000000) { DIGITS_7 (1000000); } | |
1227 else if (n < 100000000) { DIGITS_8 (10000000); } | |
1228 else if (n < 1000000000) { DIGITS_9 (100000000); } | |
1229 #if SIZEOF_LONG == 4 | |
1230 /* ``if (1)'' serves only to preserve editor indentation. */ | |
1231 else if (1) { DIGITS_10 (1000000000); } | |
1232 #else /* SIZEOF_LONG != 4 */ | |
1233 else if (n < 10000000000L) { DIGITS_10 (1000000000L); } | |
1234 else if (n < 100000000000L) { DIGITS_11 (10000000000L); } | |
1235 else if (n < 1000000000000L) { DIGITS_12 (100000000000L); } | |
1236 else if (n < 10000000000000L) { DIGITS_13 (1000000000000L); } | |
1237 else if (n < 100000000000000L) { DIGITS_14 (10000000000000L); } | |
1238 else if (n < 1000000000000000L) { DIGITS_15 (100000000000000L); } | |
1239 else if (n < 10000000000000000L) { DIGITS_16 (1000000000000000L); } | |
1240 else if (n < 100000000000000000L) { DIGITS_17 (10000000000000000L); } | |
1241 else if (n < 1000000000000000000L) { DIGITS_18 (100000000000000000L); } | |
1242 else { DIGITS_19 (1000000000000000000L); } | |
1243 #endif /* SIZEOF_LONG != 4 */ | |
1244 | |
428 | 1245 *p = '\0'; |
1246 #endif /* (SIZEOF_LONG == 4) || (SIZEOF_LONG == 8) */ | |
1247 } | |
577 | 1248 |
1249 #undef ONE_DIGIT | |
1250 #undef ONE_DIGIT_ADVANCE | |
1251 | |
1252 #undef DIGITS_1 | |
1253 #undef DIGITS_2 | |
1254 #undef DIGITS_3 | |
1255 #undef DIGITS_4 | |
1256 #undef DIGITS_5 | |
1257 #undef DIGITS_6 | |
1258 #undef DIGITS_7 | |
1259 #undef DIGITS_8 | |
1260 #undef DIGITS_9 | |
1261 #undef DIGITS_10 | |
1262 #undef DIGITS_11 | |
1263 #undef DIGITS_12 | |
1264 #undef DIGITS_13 | |
1265 #undef DIGITS_14 | |
1266 #undef DIGITS_15 | |
1267 #undef DIGITS_16 | |
1268 #undef DIGITS_17 | |
1269 #undef DIGITS_18 | |
1270 #undef DIGITS_19 | |
428 | 1271 |
1272 static void | |
442 | 1273 print_vector_internal (const char *start, const char *end, |
428 | 1274 Lisp_Object obj, |
1275 Lisp_Object printcharfun, int escapeflag) | |
1276 { | |
1277 /* This function can GC */ | |
1278 int i; | |
1279 int len = XVECTOR_LENGTH (obj); | |
1280 int last = len; | |
1281 struct gcpro gcpro1, gcpro2; | |
1282 GCPRO2 (obj, printcharfun); | |
1283 | |
1284 if (INTP (Vprint_length)) | |
1285 { | |
1286 int max = XINT (Vprint_length); | |
1287 if (max < len) last = max; | |
1288 } | |
1289 | |
826 | 1290 write_c_string (printcharfun, start); |
428 | 1291 for (i = 0; i < last; i++) |
1292 { | |
1293 Lisp_Object elt = XVECTOR_DATA (obj)[i]; | |
826 | 1294 if (i != 0) write_c_string (printcharfun, " "); |
428 | 1295 print_internal (elt, printcharfun, escapeflag); |
1296 } | |
1297 UNGCPRO; | |
1298 if (last != len) | |
826 | 1299 write_c_string (printcharfun, " ..."); |
1300 write_c_string (printcharfun, end); | |
428 | 1301 } |
1302 | |
1303 void | |
1304 print_cons (Lisp_Object obj, Lisp_Object printcharfun, int escapeflag) | |
1305 { | |
1306 /* This function can GC */ | |
1307 struct gcpro gcpro1, gcpro2; | |
1308 | |
1309 /* If print_readably is on, print (quote -foo-) as '-foo- | |
1310 (Yeah, this should really be what print-pretty does, but we | |
1311 don't have the rest of a pretty printer, and this actually | |
1312 has non-negligible impact on size/speed of .elc files.) | |
1313 */ | |
1314 if (print_readably && | |
1315 EQ (XCAR (obj), Qquote) && | |
1316 CONSP (XCDR (obj)) && | |
1317 NILP (XCDR (XCDR (obj)))) | |
1318 { | |
1319 obj = XCAR (XCDR (obj)); | |
1320 GCPRO2 (obj, printcharfun); | |
826 | 1321 write_c_string (printcharfun, "\'"); |
428 | 1322 UNGCPRO; |
1323 print_internal (obj, printcharfun, escapeflag); | |
1324 return; | |
1325 } | |
1326 | |
1327 GCPRO2 (obj, printcharfun); | |
826 | 1328 write_c_string (printcharfun, "("); |
428 | 1329 |
1330 { | |
1331 int len; | |
1332 int max = INTP (Vprint_length) ? XINT (Vprint_length) : INT_MAX; | |
1333 Lisp_Object tortoise; | |
1334 /* Use tortoise/hare to make sure circular lists don't infloop */ | |
1335 | |
1336 for (tortoise = obj, len = 0; | |
1337 CONSP (obj); | |
1338 obj = XCDR (obj), len++) | |
1339 { | |
1340 if (len > 0) | |
826 | 1341 write_c_string (printcharfun, " "); |
428 | 1342 if (EQ (obj, tortoise) && len > 0) |
1343 { | |
1344 if (print_readably) | |
563 | 1345 printing_unreadable_object ("circular list"); |
428 | 1346 else |
826 | 1347 write_c_string (printcharfun, "... <circular list>"); |
428 | 1348 break; |
1349 } | |
1350 if (len & 1) | |
1351 tortoise = XCDR (tortoise); | |
1352 if (len > max) | |
1353 { | |
826 | 1354 write_c_string (printcharfun, "..."); |
428 | 1355 break; |
1356 } | |
1357 print_internal (XCAR (obj), printcharfun, escapeflag); | |
1358 } | |
1359 } | |
1360 if (!LISTP (obj)) | |
1361 { | |
826 | 1362 write_c_string (printcharfun, " . "); |
428 | 1363 print_internal (obj, printcharfun, escapeflag); |
1364 } | |
1365 UNGCPRO; | |
1366 | |
826 | 1367 write_c_string (printcharfun, ")"); |
428 | 1368 return; |
1369 } | |
1370 | |
1371 void | |
1372 print_vector (Lisp_Object obj, Lisp_Object printcharfun, int escapeflag) | |
1373 { | |
1374 print_vector_internal ("[", "]", obj, printcharfun, escapeflag); | |
1375 } | |
1376 | |
1377 void | |
1378 print_string (Lisp_Object obj, Lisp_Object printcharfun, int escapeflag) | |
1379 { | |
1380 /* We distinguish between Bytecounts and Charcounts, to make | |
1381 Vprint_string_length work correctly under Mule. */ | |
826 | 1382 Charcount size = string_char_length (obj); |
428 | 1383 Charcount max = size; |
793 | 1384 Bytecount bcmax = XSTRING_LENGTH (obj); |
428 | 1385 struct gcpro gcpro1, gcpro2; |
1386 GCPRO2 (obj, printcharfun); | |
1387 | |
1388 if (INTP (Vprint_string_length) && | |
1389 XINT (Vprint_string_length) < max) | |
1390 { | |
1391 max = XINT (Vprint_string_length); | |
793 | 1392 bcmax = string_index_char_to_byte (obj, max); |
428 | 1393 } |
1394 if (max < 0) | |
1395 { | |
1396 max = 0; | |
1397 bcmax = 0; | |
1398 } | |
1399 | |
1400 if (!escapeflag) | |
1401 { | |
1402 /* This deals with GC-relocation and Mule. */ | |
1403 output_string (printcharfun, 0, obj, 0, bcmax); | |
1404 if (max < size) | |
826 | 1405 write_c_string (printcharfun, " ..."); |
428 | 1406 } |
1407 else | |
1408 { | |
1409 Bytecount i, last = 0; | |
1410 | |
826 | 1411 write_c_string (printcharfun, "\""); |
428 | 1412 for (i = 0; i < bcmax; i++) |
1413 { | |
867 | 1414 Ibyte ch = string_byte (obj, i); |
428 | 1415 if (ch == '\"' || ch == '\\' |
1416 || (ch == '\n' && print_escape_newlines)) | |
1417 { | |
1418 if (i > last) | |
1419 { | |
1420 output_string (printcharfun, 0, obj, last, | |
1421 i - last); | |
1422 } | |
1423 if (ch == '\n') | |
1424 { | |
826 | 1425 write_c_string (printcharfun, "\\n"); |
428 | 1426 } |
1427 else | |
1428 { | |
867 | 1429 Ibyte temp[2]; |
826 | 1430 write_c_string (printcharfun, "\\"); |
428 | 1431 /* This is correct for Mule because the |
1432 character is either \ or " */ | |
826 | 1433 temp[0] = string_byte (obj, i); |
1434 temp[1] = '\0'; | |
1435 write_string (printcharfun, temp); | |
428 | 1436 } |
1437 last = i + 1; | |
1438 } | |
1439 } | |
1440 if (bcmax > last) | |
1441 { | |
1442 output_string (printcharfun, 0, obj, last, | |
1443 bcmax - last); | |
1444 } | |
1445 if (max < size) | |
826 | 1446 write_c_string (printcharfun, " ..."); |
1447 write_c_string (printcharfun, "\""); | |
428 | 1448 } |
1449 UNGCPRO; | |
1450 } | |
1451 | |
5117
3742ea8250b5
Checking in final CVS version of workspace 'ben-lisp-object'
Ben Wing <ben@xemacs.org>
parents:
3063
diff
changeset
|
1452 void |
3742ea8250b5
Checking in final CVS version of workspace 'ben-lisp-object'
Ben Wing <ben@xemacs.org>
parents:
3063
diff
changeset
|
1453 external_object_printer (Lisp_Object obj, Lisp_Object printcharfun, |
3742ea8250b5
Checking in final CVS version of workspace 'ben-lisp-object'
Ben Wing <ben@xemacs.org>
parents:
3063
diff
changeset
|
1454 int UNUSED (escapeflag)) |
428 | 1455 { |
3017 | 1456 struct LCRECORD_HEADER *header = (struct LCRECORD_HEADER *) XPNTR (obj); |
428 | 1457 |
1458 if (print_readably) | |
563 | 1459 printing_unreadable_object |
1460 ("#<%s 0x%x>", | |
2720 | 1461 #ifdef MC_ALLOC |
1462 LHEADER_IMPLEMENTATION (header)->name, | |
1463 #else /* not MC_ALLOC */ | |
563 | 1464 LHEADER_IMPLEMENTATION (&header->lheader)->name, |
2720 | 1465 #endif /* not MC_ALLOC */ |
563 | 1466 header->uid); |
428 | 1467 |
800 | 1468 write_fmt_string (printcharfun, "#<%s 0x%x>", |
2720 | 1469 #ifdef MC_ALLOC |
1470 LHEADER_IMPLEMENTATION (header)->name, | |
1471 #else /* not MC_ALLOC */ | |
800 | 1472 LHEADER_IMPLEMENTATION (&header->lheader)->name, |
2720 | 1473 #endif /* not MC_ALLOC */ |
800 | 1474 header->uid); |
428 | 1475 } |
1476 | |
5117
3742ea8250b5
Checking in final CVS version of workspace 'ben-lisp-object'
Ben Wing <ben@xemacs.org>
parents:
3063
diff
changeset
|
1477 static void |
428 | 1478 internal_object_printer (Lisp_Object obj, Lisp_Object printcharfun, |
2286 | 1479 int UNUSED (escapeflag)) |
428 | 1480 { |
5117
3742ea8250b5
Checking in final CVS version of workspace 'ben-lisp-object'
Ben Wing <ben@xemacs.org>
parents:
3063
diff
changeset
|
1481 if (print_readably) |
3742ea8250b5
Checking in final CVS version of workspace 'ben-lisp-object'
Ben Wing <ben@xemacs.org>
parents:
3063
diff
changeset
|
1482 printing_unreadable_object |
3742ea8250b5
Checking in final CVS version of workspace 'ben-lisp-object'
Ben Wing <ben@xemacs.org>
parents:
3063
diff
changeset
|
1483 ("#<INTERNAL OBJECT (XEmacs bug?) (%s) 0x%lx>", |
3742ea8250b5
Checking in final CVS version of workspace 'ben-lisp-object'
Ben Wing <ben@xemacs.org>
parents:
3063
diff
changeset
|
1484 XRECORD_LHEADER_IMPLEMENTATION (obj)->name, |
3742ea8250b5
Checking in final CVS version of workspace 'ben-lisp-object'
Ben Wing <ben@xemacs.org>
parents:
3063
diff
changeset
|
1485 (unsigned long) XPNTR (obj)) |
3742ea8250b5
Checking in final CVS version of workspace 'ben-lisp-object'
Ben Wing <ben@xemacs.org>
parents:
3063
diff
changeset
|
1486 |
800 | 1487 write_fmt_string (printcharfun, |
1488 "#<INTERNAL OBJECT (XEmacs bug?) (%s) 0x%lx>", | |
1489 XRECORD_LHEADER_IMPLEMENTATION (obj)->name, | |
1490 (unsigned long) XPNTR (obj)); | |
428 | 1491 } |
1492 | |
1204 | 1493 enum printing_badness |
1494 { | |
1495 BADNESS_INTEGER_OBJECT, | |
1496 BADNESS_POINTER_OBJECT, | |
1497 BADNESS_NO_TYPE | |
1498 }; | |
1499 | |
1500 static void | |
1501 printing_major_badness (Lisp_Object printcharfun, | |
2367 | 1502 Ascbyte *badness_string, int type, void *val, |
1204 | 1503 enum printing_badness badness) |
1504 { | |
1505 Ibyte buf[666]; | |
1506 | |
1507 switch (badness) | |
1508 { | |
1509 case BADNESS_INTEGER_OBJECT: | |
1510 qxesprintf (buf, "%s %d object %ld", badness_string, type, | |
1511 (EMACS_INT) val); | |
1512 break; | |
1513 | |
1514 case BADNESS_POINTER_OBJECT: | |
1515 qxesprintf (buf, "%s %d object %p", badness_string, type, val); | |
1516 break; | |
1517 | |
1518 case BADNESS_NO_TYPE: | |
1519 qxesprintf (buf, "%s object %p", badness_string, val); | |
1520 break; | |
1521 } | |
1522 | |
1523 /* Don't abort or signal if called from debug_print() or already | |
1524 crashing */ | |
2367 | 1525 if (!inhibit_non_essential_conversion_operations) |
1204 | 1526 { |
1527 #ifdef ERROR_CHECK_TYPES | |
2500 | 1528 ABORT (); |
1204 | 1529 #else /* not ERROR_CHECK_TYPES */ |
1530 if (print_readably) | |
1531 signal_ferror (Qinternal_error, "printing %s", buf); | |
1532 #endif /* not ERROR_CHECK_TYPES */ | |
1533 } | |
1534 write_fmt_string (printcharfun, | |
1535 "#<EMACS BUG: %s Save your buffers immediately and " | |
1536 "please report this bug>", buf); | |
1537 } | |
1538 | |
428 | 1539 void |
1540 print_internal (Lisp_Object obj, Lisp_Object printcharfun, int escapeflag) | |
1541 { | |
1542 /* This function can GC */ | |
2001 | 1543 int specdepth = 0; |
1204 | 1544 struct gcpro gcpro1, gcpro2; |
428 | 1545 |
1546 QUIT; | |
1547 | |
771 | 1548 #ifdef NO_PRINT_DURING_GC |
428 | 1549 /* Emacs won't print while GCing, but an external debugger might */ |
1550 if (gc_in_progress) return; | |
771 | 1551 #endif |
1552 | |
1204 | 1553 /* Just to be safe ... */ |
1554 GCPRO2 (obj, printcharfun); | |
428 | 1555 |
1556 #ifdef I18N3 | |
1557 /* #### Both input and output streams should have a flag associated | |
1558 with them indicating whether output to that stream, or strings | |
1559 read from the stream, get translated using Fgettext(). Such a | |
1560 stream is called a "translating stream". For the minibuffer and | |
1561 external-debugging-output this is always true on output, and | |
1562 with-output-to-temp-buffer sets the flag to true for the buffer | |
1563 it creates. This flag should also be user-settable. Perhaps it | |
1564 should be split up into two flags, one for input and one for | |
1565 output. */ | |
1566 #endif | |
1567 | |
1568 /* Detect circularities and truncate them. | |
1569 No need to offer any alternative--this is better than an error. */ | |
1570 if (CONSP (obj) || VECTORP (obj) || COMPILED_FUNCTIONP (obj)) | |
1571 { | |
1572 int i; | |
1573 for (i = 0; i < print_depth; i++) | |
1574 if (EQ (obj, being_printed[i])) | |
1575 { | |
603 | 1576 char buf[DECIMAL_PRINT_SIZE (long) + 1]; |
428 | 1577 *buf = '#'; |
1578 long_to_string (buf + 1, i); | |
826 | 1579 write_c_string (printcharfun, buf); |
1204 | 1580 UNGCPRO; |
428 | 1581 return; |
1582 } | |
1583 } | |
1584 | |
1585 being_printed[print_depth] = obj; | |
1586 | |
1957 | 1587 /* Avoid calling internal_bind_int, which conses, when called from |
1588 debug_prin1. In that case, we have bound print_depth to 0 anyway. */ | |
2367 | 1589 if (!inhibit_non_essential_conversion_operations) |
1957 | 1590 { |
1591 specdepth = internal_bind_int (&print_depth, print_depth + 1); | |
1592 | |
1593 if (print_depth > PRINT_CIRCLE) | |
1594 signal_error (Qstack_overflow, "Apparently circular structure being printed", Qunbound); | |
1595 } | |
428 | 1596 |
1597 switch (XTYPE (obj)) | |
1598 { | |
1599 case Lisp_Type_Int_Even: | |
1600 case Lisp_Type_Int_Odd: | |
1601 { | |
603 | 1602 char buf[DECIMAL_PRINT_SIZE (EMACS_INT)]; |
428 | 1603 long_to_string (buf, XINT (obj)); |
826 | 1604 write_c_string (printcharfun, buf); |
428 | 1605 break; |
1606 } | |
1607 | |
1608 case Lisp_Type_Char: | |
1609 { | |
1610 /* God intended that this be #\..., you know. */ | |
1611 char buf[16]; | |
867 | 1612 Ichar ch = XCHAR (obj); |
428 | 1613 char *p = buf; |
1614 *p++ = '?'; | |
434 | 1615 if (ch < 32) |
1616 { | |
1617 *p++ = '\\'; | |
1618 switch (ch) | |
1619 { | |
1620 case '\t': *p++ = 't'; break; | |
1621 case '\n': *p++ = 'n'; break; | |
1622 case '\r': *p++ = 'r'; break; | |
1623 default: | |
1624 *p++ = '^'; | |
1625 *p++ = ch + 64; | |
1626 if ((ch + 64) == '\\') | |
1627 *p++ = '\\'; | |
1628 break; | |
1629 } | |
1630 } | |
1631 else if (ch < 127) | |
428 | 1632 { |
434 | 1633 /* syntactically special characters should be escaped. */ |
1634 switch (ch) | |
1635 { | |
1636 case ' ': | |
1637 case '"': | |
1638 case '#': | |
1639 case '\'': | |
1640 case '(': | |
1641 case ')': | |
1642 case ',': | |
1643 case '.': | |
1644 case ';': | |
1645 case '?': | |
1646 case '[': | |
1647 case '\\': | |
1648 case ']': | |
1649 case '`': | |
1650 *p++ = '\\'; | |
1651 } | |
1652 *p++ = ch; | |
428 | 1653 } |
1654 else if (ch == 127) | |
434 | 1655 { |
1656 *p++ = '\\', *p++ = '^', *p++ = '?'; | |
1657 } | |
1658 else if (ch < 160) | |
428 | 1659 { |
1660 *p++ = '\\', *p++ = '^'; | |
867 | 1661 p += set_itext_ichar ((Ibyte *) p, ch + 64); |
428 | 1662 } |
1663 else | |
434 | 1664 { |
867 | 1665 p += set_itext_ichar ((Ibyte *) p, ch); |
434 | 1666 } |
440 | 1667 |
867 | 1668 output_string (printcharfun, (Ibyte *) buf, Qnil, 0, p - buf); |
434 | 1669 |
428 | 1670 break; |
1671 } | |
1672 | |
1673 case Lisp_Type_Record: | |
1674 { | |
1675 struct lrecord_header *lheader = XRECORD_LHEADER (obj); | |
1204 | 1676 |
1677 /* Try to check for various sorts of bogus pointers if we're in a | |
1678 situation where it may be likely -- i.e. called from | |
1679 debug_print() or we're already crashing. In such cases, | |
1680 (further) crashing is counterproductive. */ | |
428 | 1681 |
2367 | 1682 if (inhibit_non_essential_conversion_operations && |
1204 | 1683 !debug_can_access_memory (lheader, sizeof (*lheader))) |
1684 { | |
1685 write_fmt_string (printcharfun, "#<EMACS BUG: BAD MEMORY %p>", | |
1686 lheader); | |
1687 break; | |
1688 } | |
1689 | |
1690 if (CONSP (obj) || VECTORP (obj)) | |
428 | 1691 { |
1692 /* If deeper than spec'd depth, print placeholder. */ | |
1693 if (INTP (Vprint_level) | |
1694 && print_depth > XINT (Vprint_level)) | |
1695 { | |
826 | 1696 write_c_string (printcharfun, "..."); |
428 | 1697 break; |
1698 } | |
1699 } | |
1700 | |
2720 | 1701 #ifndef MC_ALLOC |
1204 | 1702 if (lheader->type == lrecord_type_free) |
1703 { | |
1704 printing_major_badness (printcharfun, "freed lrecord", 0, | |
1705 lheader, BADNESS_NO_TYPE); | |
1706 break; | |
1707 } | |
1708 else if (lheader->type == lrecord_type_undefined) | |
1709 { | |
1710 printing_major_badness (printcharfun, "lrecord_type_undefined", 0, | |
1711 lheader, BADNESS_NO_TYPE); | |
1712 break; | |
1713 } | |
2720 | 1714 #endif /* not MC_ALLOC */ |
1204 | 1715 else if ((int) (lheader->type) >= lrecord_type_count) |
1716 { | |
1717 printing_major_badness (printcharfun, "illegal lrecord type", | |
1718 (int) (lheader->type), | |
1719 lheader, BADNESS_POINTER_OBJECT); | |
1720 break; | |
1721 } | |
1722 | |
1723 /* Further checks for bad memory in critical situations. We don't | |
1724 normally do these because they may be expensive or weird | |
1725 (e.g. under Unix we typically have to set a SIGSEGV handler and | |
1726 try to trigger a seg fault). */ | |
1727 | |
2367 | 1728 if (inhibit_non_essential_conversion_operations) |
1204 | 1729 { |
1730 if (!debug_can_access_memory | |
1731 (lheader, detagged_lisp_object_size (lheader))) | |
1732 { | |
1733 write_fmt_string (printcharfun, | |
1734 "#<EMACS BUG: type %s BAD MEMORY %p>", | |
1735 LHEADER_IMPLEMENTATION (lheader)->name, | |
1736 lheader); | |
1737 break; | |
1738 } | |
1739 | |
1740 if (STRINGP (obj)) | |
1741 { | |
1742 Lisp_String *l = (Lisp_String *) lheader; | |
1743 if (!debug_can_access_memory (l->data_, l->size_)) | |
1744 { | |
1745 write_fmt_string | |
1746 (printcharfun, | |
1747 "#<EMACS BUG: %p (BAD STRING DATA %p)>", | |
1748 lheader, l->data_); | |
1749 break; | |
1750 } | |
1751 } | |
1752 } | |
1753 | |
428 | 1754 if (LHEADER_IMPLEMENTATION (lheader)->printer) |
1755 ((LHEADER_IMPLEMENTATION (lheader)->printer) | |
1756 (obj, printcharfun, escapeflag)); | |
1757 else | |
5117
3742ea8250b5
Checking in final CVS version of workspace 'ben-lisp-object'
Ben Wing <ben@xemacs.org>
parents:
3063
diff
changeset
|
1758 internal_object_printer (obj, printcharfun, escapeflag); |
428 | 1759 break; |
1760 } | |
1761 | |
1762 default: | |
1763 { | |
1764 /* We're in trouble if this happens! */ | |
1204 | 1765 printing_major_badness (printcharfun, "illegal data type", XTYPE (obj), |
1766 LISP_TO_VOID (obj), BADNESS_INTEGER_OBJECT); | |
428 | 1767 break; |
1768 } | |
1769 } | |
1770 | |
2367 | 1771 if (!inhibit_non_essential_conversion_operations) |
1957 | 1772 unbind_to (specdepth); |
1204 | 1773 UNGCPRO; |
428 | 1774 } |
1775 | |
1776 void | |
2286 | 1777 print_float (Lisp_Object obj, Lisp_Object printcharfun, |
1778 int UNUSED (escapeflag)) | |
428 | 1779 { |
1780 char pigbuf[350]; /* see comments in float_to_string */ | |
1781 | |
1782 float_to_string (pigbuf, XFLOAT_DATA (obj)); | |
826 | 1783 write_c_string (printcharfun, pigbuf); |
428 | 1784 } |
1785 | |
1786 void | |
1787 print_symbol (Lisp_Object obj, Lisp_Object printcharfun, int escapeflag) | |
1788 { | |
1789 /* This function can GC */ | |
1790 /* #### Bug!! (intern "") isn't printed in some distinguished way */ | |
1791 /* #### (the reader also loses on it) */ | |
793 | 1792 Lisp_Object name = symbol_name (XSYMBOL (obj)); |
1793 Bytecount size = XSTRING_LENGTH (name); | |
428 | 1794 struct gcpro gcpro1, gcpro2; |
1795 | |
1796 if (!escapeflag) | |
1797 { | |
1798 /* This deals with GC-relocation */ | |
793 | 1799 output_string (printcharfun, 0, name, 0, size); |
428 | 1800 return; |
1801 } | |
1802 GCPRO2 (obj, printcharfun); | |
1803 | |
1804 /* If we print an uninterned symbol as part of a complex object and | |
1805 the flag print-gensym is non-nil, prefix it with #n= to read the | |
1806 object back with the #n# reader syntax later if needed. */ | |
1807 if (!NILP (Vprint_gensym) | |
442 | 1808 /* #### Test whether this produces a noticeable slow-down for |
428 | 1809 printing when print-gensym is non-nil. */ |
1810 && !EQ (obj, oblookup (Vobarray, | |
793 | 1811 XSTRING_DATA (symbol_name (XSYMBOL (obj))), |
1812 XSTRING_LENGTH (symbol_name (XSYMBOL (obj)))))) | |
428 | 1813 { |
1814 if (print_depth > 1) | |
1815 { | |
1816 Lisp_Object tem = Fassq (obj, Vprint_gensym_alist); | |
1817 if (CONSP (tem)) | |
1818 { | |
826 | 1819 write_c_string (printcharfun, "#"); |
428 | 1820 print_internal (XCDR (tem), printcharfun, escapeflag); |
826 | 1821 write_c_string (printcharfun, "#"); |
446 | 1822 UNGCPRO; |
428 | 1823 return; |
1824 } | |
1825 else | |
1826 { | |
1827 if (CONSP (Vprint_gensym_alist)) | |
1828 { | |
1829 /* Vprint_gensym_alist is exposed to Lisp, so we | |
1830 have to be careful. */ | |
1831 CHECK_CONS (XCAR (Vprint_gensym_alist)); | |
1832 CHECK_INT (XCDR (XCAR (Vprint_gensym_alist))); | |
793 | 1833 tem = make_int (XINT (XCDR (XCAR (Vprint_gensym_alist))) + 1); |
428 | 1834 } |
1835 else | |
793 | 1836 tem = make_int (1); |
428 | 1837 Vprint_gensym_alist = Fcons (Fcons (obj, tem), Vprint_gensym_alist); |
1838 | |
826 | 1839 write_c_string (printcharfun, "#"); |
428 | 1840 print_internal (tem, printcharfun, escapeflag); |
826 | 1841 write_c_string (printcharfun, "="); |
428 | 1842 } |
1843 } | |
826 | 1844 write_c_string (printcharfun, "#:"); |
428 | 1845 } |
1846 | |
1847 /* Does it look like an integer or a float? */ | |
1848 { | |
867 | 1849 Ibyte *data = XSTRING_DATA (name); |
428 | 1850 Bytecount confusing = 0; |
1851 | |
1852 if (size == 0) | |
1853 goto not_yet_confused; /* Really confusing */ | |
1854 else if (isdigit (data[0])) | |
1855 confusing = 0; | |
1856 else if (size == 1) | |
1857 goto not_yet_confused; | |
1858 else if (data[0] == '-' || data[0] == '+') | |
1859 confusing = 1; | |
1860 else | |
1861 goto not_yet_confused; | |
1862 | |
1863 for (; confusing < size; confusing++) | |
1864 { | |
1865 if (!isdigit (data[confusing])) | |
1866 { | |
1867 confusing = 0; | |
1868 break; | |
1869 } | |
1870 } | |
1871 not_yet_confused: | |
1872 | |
1873 if (!confusing) | |
1874 /* #### Ugh, this is needlessly complex and slow for what we | |
1875 need here. It might be a good idea to copy equivalent code | |
1876 from FSF. --hniksic */ | |
1877 confusing = isfloat_string ((char *) data); | |
1878 if (confusing) | |
826 | 1879 write_c_string (printcharfun, "\\"); |
428 | 1880 } |
1881 | |
1882 { | |
1883 Bytecount i; | |
1884 Bytecount last = 0; | |
1885 | |
1886 for (i = 0; i < size; i++) | |
1887 { | |
826 | 1888 switch (string_byte (name, i)) |
428 | 1889 { |
1890 case 0: case 1: case 2: case 3: | |
1891 case 4: case 5: case 6: case 7: | |
1892 case 8: case 9: case 10: case 11: | |
1893 case 12: case 13: case 14: case 15: | |
1894 case 16: case 17: case 18: case 19: | |
1895 case 20: case 21: case 22: case 23: | |
1896 case 24: case 25: case 26: case 27: | |
1897 case 28: case 29: case 30: case 31: | |
1898 case ' ': case '\"': case '\\': case '\'': | |
1899 case ';': case '#' : case '(' : case ')': | |
1900 case ',': case '.' : case '`' : | |
1901 case '[': case ']' : case '?' : | |
1902 if (i > last) | |
793 | 1903 output_string (printcharfun, 0, name, last, i - last); |
826 | 1904 write_c_string (printcharfun, "\\"); |
428 | 1905 last = i; |
1906 } | |
1907 } | |
793 | 1908 output_string (printcharfun, 0, name, last, size - last); |
428 | 1909 } |
1910 UNGCPRO; | |
1911 } | |
1912 | |
1913 | |
442 | 1914 /* Useful on systems or in places where writing to stdout is unavailable or |
1915 not working. */ | |
428 | 1916 |
1917 static int alternate_do_pointer; | |
1957 | 1918 static int alternate_do_size; |
1919 static char *alternate_do_string; | |
428 | 1920 |
1921 DEFUN ("alternate-debugging-output", Falternate_debugging_output, 1, 1, 0, /* | |
1922 Append CHARACTER to the array `alternate_do_string'. | |
1923 This can be used in place of `external-debugging-output' as a function | |
1924 to be passed to `print'. Before calling `print', set `alternate_do_pointer' | |
1925 to 0. | |
1926 */ | |
1927 (character)) | |
1928 { | |
867 | 1929 Ibyte str[MAX_ICHAR_LEN]; |
428 | 1930 Bytecount len; |
1931 | |
1932 CHECK_CHAR_COERCE_INT (character); | |
867 | 1933 len = set_itext_ichar (str, XCHAR (character)); |
771 | 1934 write_string_to_alternate_debugging_output (str, len); |
1935 | |
1936 return character; | |
1937 } | |
1938 | |
1939 static void | |
1346 | 1940 write_string_to_alternate_debugging_output (const Ibyte *str, Bytecount len) |
771 | 1941 { |
1942 int extlen; | |
1943 const Extbyte *extptr; | |
1944 #if 0 /* We want to see the internal representation, don't we? */ | |
2367 | 1945 if (initialized && !inhibit_non_essential_conversion_operations) |
771 | 1946 TO_EXTERNAL_FORMAT (DATA, (str, len), |
1947 ALLOCA, (extptr, extlen), | |
1948 Qterminal); | |
1949 else | |
1950 #endif /* 0 */ | |
1951 { | |
1952 extlen = len; | |
1953 extptr = (Extbyte *) str; | |
1954 } | |
1957 | 1955 |
1956 /* If not yet initialized, just skip it. */ | |
1957 if (alternate_do_string == NULL) | |
1958 return; | |
1959 | |
1960 if (alternate_do_pointer + extlen >= alternate_do_size) | |
1961 { | |
1962 alternate_do_size = | |
1963 max(alternate_do_size * 2, alternate_do_pointer + extlen + 1); | |
1964 XREALLOC_ARRAY (alternate_do_string, char, alternate_do_size); | |
1965 } | |
428 | 1966 memcpy (alternate_do_string + alternate_do_pointer, extptr, extlen); |
1967 alternate_do_pointer += extlen; | |
1968 alternate_do_string[alternate_do_pointer] = 0; | |
1969 } | |
1970 | |
1346 | 1971 |
1972 DEFUN ("set-device-clear-left-side", Fset_device_clear_left_side, 2, 2, 0, /* | |
1973 Set whether to output a newline before the next output to a stream device. | |
1974 This will happen only if the most recently-outputted character was not | |
1975 a newline -- i.e. it will make sure the left side is "clear" of text. | |
1976 */ | |
1977 (device, value)) | |
1978 { | |
1979 if (!NILP (device)) | |
1980 CHECK_LIVE_DEVICE (device); | |
1981 if (NILP (device) || DEVICE_STREAM_P (XDEVICE (device))) | |
1982 /* #### This should be per-device */ | |
1983 stdout_clear_before_next_output = !NILP (value); | |
1984 return Qnil; | |
1985 } | |
1986 | |
1987 DEFUN ("device-left-side-clear-p", Fdevice_left_side_clear_p, 0, 1, 0, /* | |
1988 For stream devices, true if the most recent-outputted character was a newline. | |
1989 */ | |
1990 (device)) | |
1991 { | |
1992 if (!NILP (device)) | |
1993 CHECK_LIVE_DEVICE (device); | |
1994 if (NILP (device) || DEVICE_STREAM_P (XDEVICE (device))) | |
1995 /* #### This should be per-device */ | |
1996 return stdout_needs_newline ? Qt : Qnil; | |
1997 return Qnil; | |
1998 } | |
1999 | |
428 | 2000 DEFUN ("external-debugging-output", Fexternal_debugging_output, 1, 3, 0, /* |
2001 Write CHAR-OR-STRING to stderr or stdout. | |
2002 If optional arg STDOUT-P is non-nil, write to stdout; otherwise, write | |
2003 to stderr. You can use this function to write directly to the terminal. | |
2004 This function can be used as the STREAM argument of Fprint() or the like. | |
2005 | |
442 | 2006 Under MS Windows, this writes output to the console window (which is |
2007 created, if necessary), unless XEmacs is being run noninteractively | |
2008 \(i.e. using the `-batch' argument). | |
2009 | |
428 | 2010 If you have opened a termscript file (using `open-termscript'), then |
2011 the output also will be logged to this file. | |
2012 */ | |
2013 (char_or_string, stdout_p, device)) | |
2014 { | |
2015 FILE *file = 0; | |
2016 struct console *con = 0; | |
2017 | |
2018 if (NILP (device)) | |
2019 { | |
2020 if (!NILP (stdout_p)) | |
2021 file = stdout; | |
2022 else | |
2023 file = stderr; | |
2024 } | |
2025 else | |
2026 { | |
2027 CHECK_LIVE_DEVICE (device); | |
2028 if (!DEVICE_TTY_P (XDEVICE (device)) && | |
2029 !DEVICE_STREAM_P (XDEVICE (device))) | |
563 | 2030 wtaerror ("Must be tty or stream device", device); |
428 | 2031 con = XCONSOLE (DEVICE_CONSOLE (XDEVICE (device))); |
2032 if (DEVICE_TTY_P (XDEVICE (device))) | |
2033 file = 0; | |
2034 else if (!NILP (stdout_p)) | |
2035 file = CONSOLE_STREAM_DATA (con)->out; | |
2036 else | |
2037 file = CONSOLE_STREAM_DATA (con)->err; | |
2038 } | |
2039 | |
2040 if (STRINGP (char_or_string)) | |
2041 write_string_to_stdio_stream (file, con, | |
2042 XSTRING_DATA (char_or_string), | |
771 | 2043 XSTRING_LENGTH (char_or_string), |
2044 print_unbuffered); | |
428 | 2045 else |
2046 { | |
867 | 2047 Ibyte str[MAX_ICHAR_LEN]; |
428 | 2048 Bytecount len; |
2049 | |
2050 CHECK_CHAR_COERCE_INT (char_or_string); | |
867 | 2051 len = set_itext_ichar (str, XCHAR (char_or_string)); |
771 | 2052 write_string_to_stdio_stream (file, con, str, len, print_unbuffered); |
428 | 2053 } |
2054 | |
2055 return char_or_string; | |
2056 } | |
2057 | |
2058 DEFUN ("open-termscript", Fopen_termscript, 1, 1, "FOpen termscript file: ", /* | |
444 | 2059 Start writing all terminal output to FILENAME as well as the terminal. |
2060 FILENAME = nil means just close any termscript file currently open. | |
428 | 2061 */ |
444 | 2062 (filename)) |
428 | 2063 { |
2064 /* This function can GC */ | |
2065 if (termscript != 0) | |
2066 { | |
771 | 2067 retry_fclose (termscript); |
444 | 2068 termscript = 0; |
2069 } | |
2070 | |
2071 if (! NILP (filename)) | |
2072 { | |
2073 filename = Fexpand_file_name (filename, Qnil); | |
771 | 2074 termscript = qxe_fopen (XSTRING_DATA (filename), "w"); |
428 | 2075 if (termscript == NULL) |
563 | 2076 report_file_error ("Opening termscript", filename); |
428 | 2077 } |
2078 return Qnil; | |
2079 } | |
2080 | |
440 | 2081 static int debug_print_length = 50; |
2082 static int debug_print_level = 15; | |
2083 static int debug_print_readably = -1; | |
428 | 2084 |
1957 | 2085 /* Restore values temporarily bound by debug_prin1. We use this approach to |
2086 avoid consing in debug_prin1. That is verboten, since debug_prin1 can be | |
2087 called by cons debugging code. */ | |
2088 static Lisp_Object | |
2286 | 2089 debug_prin1_exit (Lisp_Object UNUSED (ignored)) |
1957 | 2090 { |
2091 struct debug_bindings *bindings = | |
2092 (struct debug_bindings *) XOPAQUE (debug_prin1_bindings)->data; | |
2367 | 2093 inhibit_non_essential_conversion_operations = |
2094 bindings->inhibit_non_essential_conversion_operations; | |
1957 | 2095 print_depth = bindings->print_depth; |
2096 print_readably = bindings->print_readably; | |
2097 print_unbuffered = bindings->print_unbuffered; | |
2098 gc_currently_forbidden = bindings->gc_currently_forbidden; | |
2099 Vprint_length = bindings->Vprint_length; | |
2100 Vprint_level = bindings->Vprint_level; | |
2101 Vinhibit_quit = bindings->Vinhibit_quit; | |
2102 return Qnil; | |
2103 } | |
2104 | |
1346 | 2105 /* Print an object, `prin1'-style, to various possible debugging outputs. |
2106 Make sure it's completely unbuffered so that, in the event of a crash | |
2107 somewhere, we see as much as possible that happened before it. | |
2108 */ | |
428 | 2109 static void |
1346 | 2110 debug_prin1 (Lisp_Object debug_print_obj, int flags) |
428 | 2111 { |
2112 /* This function can GC */ | |
853 | 2113 |
2114 /* by doing this, we trick various things that are non-essential | |
2115 but might cause crashes into not getting executed. */ | |
1957 | 2116 int specdepth; |
2117 struct debug_bindings *bindings = | |
2118 (struct debug_bindings *) XOPAQUE (debug_prin1_bindings)->data; | |
853 | 2119 |
2367 | 2120 bindings->inhibit_non_essential_conversion_operations = |
2121 inhibit_non_essential_conversion_operations; | |
1957 | 2122 bindings->print_depth = print_depth; |
2123 bindings->print_readably = print_readably; | |
2124 bindings->print_unbuffered = print_unbuffered; | |
2125 bindings->gc_currently_forbidden = gc_currently_forbidden; | |
2126 bindings->Vprint_length = Vprint_length; | |
2127 bindings->Vprint_level = Vprint_level; | |
2128 bindings->Vinhibit_quit = Vinhibit_quit; | |
2129 specdepth = record_unwind_protect (debug_prin1_exit, Qnil); | |
2130 | |
2367 | 2131 inhibit_non_essential_conversion_operations = 1; |
1957 | 2132 print_depth = 0; |
2133 print_readably = debug_print_readably != -1 ? debug_print_readably : 0; | |
2134 print_unbuffered++; | |
428 | 2135 if (debug_print_length > 0) |
1957 | 2136 Vprint_length = make_int (debug_print_length); |
428 | 2137 if (debug_print_level > 0) |
1957 | 2138 Vprint_level = make_int (debug_print_level); |
2139 Vinhibit_quit = Qt; | |
1346 | 2140 |
2141 if ((flags & EXT_PRINT_STDOUT) || (flags & EXT_PRINT_STDERR)) | |
2142 print_internal (debug_print_obj, Qexternal_debugging_output, 1); | |
2143 if (flags & EXT_PRINT_ALTERNATE) | |
2144 print_internal (debug_print_obj, Qalternate_debugging_output, 1); | |
442 | 2145 #ifdef WIN32_NATIVE |
1346 | 2146 if (flags & EXT_PRINT_MSWINDOWS) |
2147 { | |
2148 /* Write out to the debugger, as well */ | |
2149 print_internal (debug_print_obj, Qmswindows_debugging_output, 1); | |
2150 } | |
442 | 2151 #endif |
440 | 2152 |
802 | 2153 unbind_to (specdepth); |
428 | 2154 } |
2155 | |
2156 void | |
1204 | 2157 debug_p4 (Lisp_Object obj) |
2158 { | |
2367 | 2159 inhibit_non_essential_conversion_operations = 1; |
1204 | 2160 if (STRINGP (obj)) |
2161 debug_out ("\"%s\"", XSTRING_DATA (obj)); | |
2162 else if (CONSP (obj)) | |
2163 { | |
2164 int first = 1; | |
2165 do { | |
2166 debug_out (first ? "(" : " "); | |
2167 first = 0; | |
2168 debug_p4 (XCAR (obj)); | |
2169 obj = XCDR (obj); | |
2170 } while (CONSP (obj)); | |
2171 if (NILP (obj)) | |
2172 debug_out (")"); | |
2173 else | |
2174 { | |
2175 debug_out (" . "); | |
2176 debug_p4 (obj); | |
2177 debug_out (")"); | |
2178 } | |
2179 } | |
2180 else if (VECTORP (obj)) | |
2181 { | |
2182 int size = XVECTOR_LENGTH (obj); | |
2183 int i; | |
2184 int first = 1; | |
2185 | |
2186 for (i = 0; i < size; i++) | |
2187 { | |
2188 debug_out (first ? "[" : " "); | |
2189 first = 0; | |
2190 debug_p4 (XVECTOR_DATA (obj)[i]); | |
2191 debug_out ("]"); | |
2192 } | |
2193 } | |
2194 else if (SYMBOLP (obj)) | |
2195 { | |
2196 Lisp_Object name = XSYMBOL_NAME (obj); | |
2197 if (!STRINGP (name)) | |
2198 debug_out ("<<bad symbol>>"); | |
2199 else | |
2200 debug_out ("%s", XSTRING_DATA (name)); | |
2201 } | |
2202 else if (INTP (obj)) | |
2203 { | |
2204 debug_out ("%ld", XINT (obj)); | |
2205 } | |
2206 else if (FLOATP (obj)) | |
2207 { | |
2208 debug_out ("%g", XFLOAT_DATA (obj)); | |
2209 } | |
2210 else | |
2211 { | |
2212 struct lrecord_header *header = | |
2213 (struct lrecord_header *) XPNTR (obj); | |
2214 | |
2215 if (header->type >= lrecord_type_last_built_in_type) | |
2216 debug_out ("<< bad object type=%d 0x%lx>>", header->type, | |
2217 (EMACS_INT) header); | |
2218 else | |
2720 | 2219 #ifdef MC_ALLOC |
3063 | 2220 debug_out ("#<%s addr=0x%lx uid=0x%lx>", |
2720 | 2221 LHEADER_IMPLEMENTATION (header)->name, |
3063 | 2222 (EMACS_INT) header, |
2720 | 2223 (EMACS_INT) ((struct lrecord_header *) header)->uid); |
2224 #else /* not MC_ALLOC */ | |
3063 | 2225 debug_out ("#<%s addr=0x%lx uid=0x%lx>", |
1204 | 2226 LHEADER_IMPLEMENTATION (header)->name, |
3063 | 2227 (EMACS_INT) header, |
1204 | 2228 LHEADER_IMPLEMENTATION (header)->basic_p ? |
3063 | 2229 ((struct lrecord_header *) header)->uid : |
3024 | 2230 ((struct old_lcrecord_header *) header)->uid); |
2720 | 2231 #endif /* not MC_ALLOC */ |
1204 | 2232 } |
2233 | |
2367 | 2234 inhibit_non_essential_conversion_operations = 0; |
1204 | 2235 } |
2236 | |
1346 | 2237 static void |
2238 ext_print_begin (int dest) | |
2239 { | |
2240 if (dest & EXT_PRINT_ALTERNATE) | |
2241 alternate_do_pointer = 0; | |
2242 if (dest & (EXT_PRINT_STDERR | EXT_PRINT_STDOUT)) | |
2243 stdout_clear_before_next_output = 1; | |
2244 } | |
2245 | |
2246 static void | |
2247 ext_print_end (int dest) | |
2248 { | |
2249 if (dest & (EXT_PRINT_MSWINDOWS | EXT_PRINT_STDERR | EXT_PRINT_STDOUT)) | |
2250 external_out (dest & (EXT_PRINT_MSWINDOWS | EXT_PRINT_STDERR | | |
2251 EXT_PRINT_STDOUT), "\n"); | |
2252 } | |
2253 | |
2254 static void | |
2255 external_debug_print (Lisp_Object object, int dest) | |
2256 { | |
2257 ext_print_begin (dest); | |
2258 debug_prin1 (object, dest); | |
2259 ext_print_end (dest); | |
2260 } | |
2261 | |
1204 | 2262 void |
2263 debug_p3 (Lisp_Object obj) | |
2264 { | |
2265 debug_p4 (obj); | |
2367 | 2266 inhibit_non_essential_conversion_operations = 1; |
1204 | 2267 debug_out ("\n"); |
2367 | 2268 inhibit_non_essential_conversion_operations = 0; |
1204 | 2269 } |
2270 | |
2271 void | |
428 | 2272 debug_print (Lisp_Object debug_print_obj) |
2273 { | |
1346 | 2274 external_debug_print (debug_print_obj, EXT_PRINT_ALL); |
428 | 2275 } |
2276 | |
1204 | 2277 /* Getting tired of typing debug_print() ... */ |
2278 void dp (Lisp_Object debug_print_obj); | |
2279 void | |
2280 dp (Lisp_Object debug_print_obj) | |
2281 { | |
2282 debug_print (debug_print_obj); | |
2283 } | |
2284 | |
1346 | 2285 /* Alternate debug printer: Return a char * pointer to the output */ |
2286 char *dpa (Lisp_Object debug_print_obj); | |
2287 char * | |
2288 dpa (Lisp_Object debug_print_obj) | |
2289 { | |
2290 external_debug_print (debug_print_obj, EXT_PRINT_ALTERNATE); | |
2291 | |
2292 return alternate_do_string; | |
2293 } | |
2294 | |
428 | 2295 /* Debugging kludge -- unbuffered */ |
2296 /* This function provided for the benefit of the debugger. */ | |
2297 void | |
2298 debug_backtrace (void) | |
2299 { | |
2300 /* This function can GC */ | |
853 | 2301 |
2302 /* by doing this, we trick various things that are non-essential | |
2303 but might cause crashes into not getting executed. */ | |
2304 int specdepth = | |
2367 | 2305 internal_bind_int (&inhibit_non_essential_conversion_operations, 1); |
853 | 2306 |
2307 internal_bind_int (&print_depth, 0); | |
802 | 2308 internal_bind_int (&print_readably, 0); |
2309 internal_bind_int (&print_unbuffered, print_unbuffered + 1); | |
428 | 2310 if (debug_print_length > 0) |
802 | 2311 internal_bind_lisp_object (&Vprint_length, make_int (debug_print_length)); |
428 | 2312 if (debug_print_level > 0) |
802 | 2313 internal_bind_lisp_object (&Vprint_level, make_int (debug_print_level)); |
2314 /* #### Do we need this? It was in the old code. */ | |
2315 internal_bind_lisp_object (&Vinhibit_quit, Vinhibit_quit); | |
428 | 2316 |
2317 Fbacktrace (Qexternal_debugging_output, Qt); | |
2318 stderr_out ("\n"); | |
2319 | |
802 | 2320 unbind_to (specdepth); |
428 | 2321 } |
2322 | |
1204 | 2323 /* Getting tired of typing debug_backtrace() ... */ |
2324 void db (void); | |
2325 void | |
2326 db (void) | |
2327 { | |
2328 debug_backtrace (); | |
2329 } | |
2330 | |
428 | 2331 void |
2332 debug_short_backtrace (int length) | |
2333 { | |
2334 int first = 1; | |
2335 struct backtrace *bt = backtrace_list; | |
771 | 2336 debug_out (" ["); |
428 | 2337 while (length > 0 && bt) |
2338 { | |
2339 if (!first) | |
2340 { | |
771 | 2341 debug_out (", "); |
428 | 2342 } |
2343 if (COMPILED_FUNCTIONP (*bt->function)) | |
2344 { | |
1346 | 2345 #if defined (COMPILED_FUNCTION_ANNOTATION_HACK) |
428 | 2346 Lisp_Object ann = |
2347 compiled_function_annotation (XCOMPILED_FUNCTION (*bt->function)); | |
2348 #else | |
2349 Lisp_Object ann = Qnil; | |
2350 #endif | |
2351 if (!NILP (ann)) | |
2352 { | |
771 | 2353 debug_out ("<compiled-function from "); |
1346 | 2354 debug_prin1 (ann, EXT_PRINT_ALL); |
771 | 2355 debug_out (">"); |
428 | 2356 } |
2357 else | |
2358 { | |
771 | 2359 debug_out ("<compiled-function of unknown origin>"); |
428 | 2360 } |
2361 } | |
2362 else | |
1346 | 2363 debug_prin1 (*bt->function, EXT_PRINT_ALL); |
428 | 2364 first = 0; |
2365 length--; | |
2366 bt = bt->next; | |
2367 } | |
771 | 2368 debug_out ("]\n"); |
428 | 2369 } |
2370 | |
2371 | |
2372 void | |
2373 syms_of_print (void) | |
2374 { | |
563 | 2375 DEFSYMBOL (Qstandard_output); |
428 | 2376 |
563 | 2377 DEFSYMBOL (Qprint_length); |
428 | 2378 |
563 | 2379 DEFSYMBOL (Qprint_string_length); |
428 | 2380 |
563 | 2381 DEFSYMBOL (Qdisplay_error); |
2382 DEFSYMBOL (Qprint_message_label); | |
428 | 2383 |
2384 DEFSUBR (Fprin1); | |
2385 DEFSUBR (Fprin1_to_string); | |
2386 DEFSUBR (Fprinc); | |
2387 DEFSUBR (Fprint); | |
2388 DEFSUBR (Ferror_message_string); | |
2389 DEFSUBR (Fdisplay_error); | |
2390 DEFSUBR (Fterpri); | |
2391 DEFSUBR (Fwrite_char); | |
2392 DEFSUBR (Falternate_debugging_output); | |
1346 | 2393 DEFSUBR (Fset_device_clear_left_side); |
2394 DEFSUBR (Fdevice_left_side_clear_p); | |
428 | 2395 DEFSUBR (Fexternal_debugging_output); |
2396 DEFSUBR (Fopen_termscript); | |
563 | 2397 DEFSYMBOL (Qexternal_debugging_output); |
2398 DEFSYMBOL (Qalternate_debugging_output); | |
442 | 2399 #ifdef HAVE_MS_WINDOWS |
563 | 2400 DEFSYMBOL (Qmswindows_debugging_output); |
442 | 2401 #endif |
428 | 2402 DEFSUBR (Fwith_output_to_temp_buffer); |
2403 } | |
2404 | |
2405 void | |
2406 reinit_vars_of_print (void) | |
2407 { | |
2408 alternate_do_pointer = 0; | |
2409 } | |
2410 | |
2411 void | |
2412 vars_of_print (void) | |
2413 { | |
2414 DEFVAR_LISP ("standard-output", &Vstandard_output /* | |
2415 Output stream `print' uses by default for outputting a character. | |
2416 This may be any function of one argument. | |
2417 It may also be a buffer (output is inserted before point) | |
2418 or a marker (output is inserted and the marker is advanced) | |
2419 or the symbol t (output appears in the minibuffer line). | |
2420 */ ); | |
2421 Vstandard_output = Qt; | |
2422 | |
2423 DEFVAR_LISP ("float-output-format", &Vfloat_output_format /* | |
2424 The format descriptor string that lisp uses to print floats. | |
2425 This is a %-spec like those accepted by `printf' in C, | |
2426 but with some restrictions. It must start with the two characters `%.'. | |
2427 After that comes an integer precision specification, | |
2428 and then a letter which controls the format. | |
2429 The letters allowed are `e', `f' and `g'. | |
2430 Use `e' for exponential notation "DIG.DIGITSeEXPT" | |
2431 Use `f' for decimal point notation "DIGITS.DIGITS". | |
2432 Use `g' to choose the shorter of those two formats for the number at hand. | |
2433 The precision in any of these cases is the number of digits following | |
2434 the decimal point. With `f', a precision of 0 means to omit the | |
2435 decimal point. 0 is not allowed with `f' or `g'. | |
2436 | |
2437 A value of nil means to use `%.16g'. | |
2438 | |
2439 Regardless of the value of `float-output-format', a floating point number | |
2440 will never be printed in such a way that it is ambiguous with an integer; | |
2441 that is, a floating-point number will always be printed with a decimal | |
2442 point and/or an exponent, even if the digits following the decimal point | |
2443 are all zero. This is to preserve read-equivalence. | |
2444 */ ); | |
2445 Vfloat_output_format = Qnil; | |
2446 | |
2447 DEFVAR_LISP ("print-length", &Vprint_length /* | |
2448 Maximum length of list or vector to print before abbreviating. | |
2449 A value of nil means no limit. | |
2450 */ ); | |
2451 Vprint_length = Qnil; | |
2452 | |
2453 DEFVAR_LISP ("print-string-length", &Vprint_string_length /* | |
2454 Maximum length of string to print before abbreviating. | |
2455 A value of nil means no limit. | |
2456 */ ); | |
2457 Vprint_string_length = Qnil; | |
2458 | |
2459 DEFVAR_LISP ("print-level", &Vprint_level /* | |
2460 Maximum depth of list nesting to print before abbreviating. | |
2461 A value of nil means no limit. | |
2462 */ ); | |
2463 Vprint_level = Qnil; | |
2464 | |
2465 DEFVAR_BOOL ("print-escape-newlines", &print_escape_newlines /* | |
2466 Non-nil means print newlines in strings as backslash-n. | |
2467 */ ); | |
2468 print_escape_newlines = 0; | |
2469 | |
2470 DEFVAR_BOOL ("print-readably", &print_readably /* | |
2471 If non-nil, then all objects will be printed in a readable form. | |
2472 If an object has no readable representation, then an error is signalled. | |
2473 When print-readably is true, compiled-function objects will be written in | |
2474 #[...] form instead of in #<compiled-function [...]> form, and two-element | |
2475 lists of the form (quote object) will be written as the equivalent 'object. | |
2476 Do not SET this variable; bind it instead. | |
2477 */ ); | |
2478 print_readably = 0; | |
2479 | |
2480 /* #### I think this should default to t. But we'd better wait | |
2481 until we see that it works out. */ | |
2482 DEFVAR_LISP ("print-gensym", &Vprint_gensym /* | |
2483 If non-nil, then uninterned symbols will be printed specially. | |
2484 Uninterned symbols are those which are not present in `obarray', that is, | |
2485 those which were made with `make-symbol' or by calling `intern' with a | |
2486 second argument. | |
2487 | |
2488 When print-gensym is true, such symbols will be preceded by "#:", | |
2489 which causes the reader to create a new symbol instead of interning | |
2490 and returning an existing one. Beware: the #: syntax creates a new | |
2491 symbol each time it is seen, so if you print an object which contains | |
2492 two pointers to the same uninterned symbol, `read' will not duplicate | |
2493 that structure. | |
2494 | |
2495 If the value of `print-gensym' is a cons cell, then in addition | |
2496 refrain from clearing `print-gensym-alist' on entry to and exit from | |
2497 printing functions, so that the use of #...# and #...= can carry over | |
2498 for several separately printed objects. | |
2499 */ ); | |
2500 Vprint_gensym = Qnil; | |
2501 | |
2502 DEFVAR_LISP ("print-gensym-alist", &Vprint_gensym_alist /* | |
2503 Association list of elements (GENSYM . N) to guide use of #N# and #N=. | |
2504 In each element, GENSYM is an uninterned symbol that has been associated | |
2505 with #N= for the specified value of N. | |
2506 */ ); | |
2507 Vprint_gensym_alist = Qnil; | |
2508 | |
2509 DEFVAR_LISP ("print-message-label", &Vprint_message_label /* | |
2510 Label for minibuffer messages created with `print'. This should | |
2511 generally be bound with `let' rather than set. (See `display-message'.) | |
2512 */ ); | |
2513 Vprint_message_label = Qprint; | |
1957 | 2514 |
2515 debug_prin1_bindings = | |
2516 make_opaque (OPAQUE_UNINIT, sizeof (struct debug_bindings)); | |
2517 staticpro (&debug_prin1_bindings); | |
2518 | |
2519 alternate_do_size = 5000; | |
2520 alternate_do_string = xnew_array(char, 5000); | |
428 | 2521 } |