Mercurial > hg > xemacs-beta
annotate src/print.c @ 4846:a98ca4640147
clean up object print methods
casetab.c, console.c, data.c, database.c, device-msw.c, device.c, eval.c, file-coding.c, frame.c, glyphs.c, gui.c, keymap.c, lisp.h, mule-charset.c, objects.c, print.c, process.c, tooltalk.c, ui-gtk.c, window.c:
New function printing_unreadable_lcrecord(). Automatically
prints the type name and pointer value of the object. Use it
instead of printing_unreadable_object(); make that latter
function local to print.c.
window.c: During creation, window may have Qt as its buffer. Don't
crash if trying to print such a window.
author | Ben Wing <ben@xemacs.org> |
---|---|
date | Wed, 13 Jan 2010 05:49:13 -0600 |
parents | 80cd90837ac5 |
children | 05c519de7353 |
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. | |
4693
80cd90837ac5
Add argument information to remaining MANY or UNEVALLED C subrs.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4677
diff
changeset
|
810 |
80cd90837ac5
Add argument information to remaining MANY or UNEVALLED C subrs.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4677
diff
changeset
|
811 arguments: (BUFNAME &rest BODY) |
428 | 812 */ |
813 (args)) | |
814 { | |
815 /* This function can GC */ | |
816 Lisp_Object name = Qnil; | |
817 int speccount = specpdl_depth (); | |
818 struct gcpro gcpro1, gcpro2; | |
819 Lisp_Object val = Qnil; | |
820 | |
821 #ifdef I18N3 | |
822 /* #### should set the buffer to be translating. See print_internal(). */ | |
823 #endif | |
824 | |
825 GCPRO2 (name, val); | |
4677
8f1ee2d15784
Support full Common Lisp multiple values in C.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4528
diff
changeset
|
826 name = IGNORE_MULTIPLE_VALUES (Feval (XCAR (args))); |
428 | 827 |
828 CHECK_STRING (name); | |
829 | |
830 temp_output_buffer_setup (name); | |
831 UNGCPRO; | |
832 | |
833 val = Fprogn (XCDR (args)); | |
834 | |
835 temp_output_buffer_show (Vstandard_output, Qnil); | |
836 | |
771 | 837 return unbind_to_1 (speccount, val); |
428 | 838 } |
839 | |
840 DEFUN ("terpri", Fterpri, 0, 1, 0, /* | |
841 Output a newline to STREAM. | |
842 If STREAM is omitted or nil, the value of `standard-output' is used. | |
843 */ | |
844 (stream)) | |
845 { | |
846 /* This function can GC */ | |
826 | 847 write_c_string (canonicalize_printcharfun (stream), "\n"); |
428 | 848 return Qt; |
849 } | |
850 | |
851 DEFUN ("prin1", Fprin1, 1, 2, 0, /* | |
852 Output the printed representation of OBJECT, any Lisp object. | |
853 Quoting characters are printed when needed to make output that `read' | |
854 can handle, whenever this is possible. | |
855 Output stream is STREAM, or value of `standard-output' (which see). | |
856 */ | |
857 (object, stream)) | |
858 { | |
859 /* This function can GC */ | |
860 Lisp_Object frame = Qnil; | |
861 struct gcpro gcpro1, gcpro2; | |
862 GCPRO2 (object, stream); | |
863 | |
864 stream = print_prepare (stream, &frame); | |
865 print_internal (object, stream, 1); | |
866 print_finish (stream, frame); | |
867 | |
868 UNGCPRO; | |
869 return object; | |
870 } | |
871 | |
4394
cacc942c0d0f
Avoid clearing print-gensym-alist inappropriately when printing hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
872 Lisp_Object |
cacc942c0d0f
Avoid clearing print-gensym-alist inappropriately when printing hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
873 prin1_to_string (Lisp_Object object, int noescape) |
cacc942c0d0f
Avoid clearing print-gensym-alist inappropriately when printing hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
874 { |
cacc942c0d0f
Avoid clearing print-gensym-alist inappropriately when printing hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
875 /* This function can GC */ |
cacc942c0d0f
Avoid clearing print-gensym-alist inappropriately when printing hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
876 Lisp_Object result = Qnil; |
cacc942c0d0f
Avoid clearing print-gensym-alist inappropriately when printing hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
877 Lisp_Object stream = make_resizing_buffer_output_stream (); |
cacc942c0d0f
Avoid clearing print-gensym-alist inappropriately when printing hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
878 Lstream *str = XLSTREAM (stream); |
cacc942c0d0f
Avoid clearing print-gensym-alist inappropriately when printing hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
879 /* gcpro OBJECT in case a caller forgot to do so */ |
cacc942c0d0f
Avoid clearing print-gensym-alist inappropriately when printing hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
880 struct gcpro gcpro1, gcpro2, gcpro3; |
cacc942c0d0f
Avoid clearing print-gensym-alist inappropriately when printing hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
881 GCPRO3 (object, stream, result); |
cacc942c0d0f
Avoid clearing print-gensym-alist inappropriately when printing hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
882 |
cacc942c0d0f
Avoid clearing print-gensym-alist inappropriately when printing hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
883 print_internal (object, stream, !noescape); |
cacc942c0d0f
Avoid clearing print-gensym-alist inappropriately when printing hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
884 Lstream_flush (str); |
cacc942c0d0f
Avoid clearing print-gensym-alist inappropriately when printing hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
885 UNGCPRO; |
cacc942c0d0f
Avoid clearing print-gensym-alist inappropriately when printing hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
886 result = make_string (resizing_buffer_stream_ptr (str), |
cacc942c0d0f
Avoid clearing print-gensym-alist inappropriately when printing hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
887 Lstream_byte_count (str)); |
cacc942c0d0f
Avoid clearing print-gensym-alist inappropriately when printing hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
888 Lstream_delete (str); |
cacc942c0d0f
Avoid clearing print-gensym-alist inappropriately when printing hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
889 return result; |
cacc942c0d0f
Avoid clearing print-gensym-alist inappropriately when printing hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
890 } |
cacc942c0d0f
Avoid clearing print-gensym-alist inappropriately when printing hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
891 |
428 | 892 DEFUN ("prin1-to-string", Fprin1_to_string, 1, 2, 0, /* |
893 Return a string containing the printed representation of OBJECT, | |
894 any Lisp object. Quoting characters are used when needed to make output | |
895 that `read' can handle, whenever this is possible, unless the optional | |
896 second argument NOESCAPE is non-nil. | |
897 */ | |
898 (object, noescape)) | |
899 { | |
900 /* This function can GC */ | |
901 Lisp_Object result = Qnil; | |
902 | |
903 RESET_PRINT_GENSYM; | |
4394
cacc942c0d0f
Avoid clearing print-gensym-alist inappropriately when printing hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
904 result = prin1_to_string (object, !(EQ(noescape, Qnil))); |
428 | 905 RESET_PRINT_GENSYM; |
4394
cacc942c0d0f
Avoid clearing print-gensym-alist inappropriately when printing hash tables.
Aidan Kehoe <kehoea@parhasard.net>
parents:
4329
diff
changeset
|
906 |
428 | 907 return result; |
908 } | |
909 | |
910 DEFUN ("princ", Fprinc, 1, 2, 0, /* | |
911 Output the printed representation of OBJECT, any Lisp object. | |
912 No quoting characters are used; no delimiters are printed around | |
913 the contents of strings. | |
444 | 914 Output stream is STREAM, or value of `standard-output' (which see). |
428 | 915 */ |
916 (object, stream)) | |
917 { | |
918 /* This function can GC */ | |
919 Lisp_Object frame = Qnil; | |
920 struct gcpro gcpro1, gcpro2; | |
921 | |
922 GCPRO2 (object, stream); | |
923 stream = print_prepare (stream, &frame); | |
924 print_internal (object, stream, 0); | |
925 print_finish (stream, frame); | |
926 UNGCPRO; | |
927 return object; | |
928 } | |
929 | |
930 DEFUN ("print", Fprint, 1, 2, 0, /* | |
931 Output the printed representation of OBJECT, with newlines around it. | |
932 Quoting characters are printed when needed to make output that `read' | |
933 can handle, whenever this is possible. | |
934 Output stream is STREAM, or value of `standard-output' (which see). | |
935 */ | |
936 (object, stream)) | |
937 { | |
938 /* This function can GC */ | |
939 Lisp_Object frame = Qnil; | |
940 struct gcpro gcpro1, gcpro2; | |
941 | |
942 GCPRO2 (object, stream); | |
943 stream = print_prepare (stream, &frame); | |
826 | 944 write_c_string (stream, "\n"); |
428 | 945 print_internal (object, stream, 1); |
826 | 946 write_c_string (stream, "\n"); |
428 | 947 print_finish (stream, frame); |
948 UNGCPRO; | |
949 return object; | |
950 } | |
951 | |
952 /* Print an error message for the error DATA to STREAM. This is a | |
953 complete implementation of `display-error', which used to be in | |
954 Lisp (see prim/cmdloop.el). It was ported to C so it can be used | |
955 efficiently by Ferror_message_string. Fdisplay_error and | |
956 Ferror_message_string are trivial wrappers around this function. | |
957 | |
958 STREAM should be the result of canonicalize_printcharfun(). */ | |
959 static void | |
960 print_error_message (Lisp_Object error_object, Lisp_Object stream) | |
961 { | |
962 /* This function can GC */ | |
963 Lisp_Object type = Fcar_safe (error_object); | |
964 Lisp_Object method = Qnil; | |
965 Lisp_Object tail; | |
966 | |
967 /* No need to GCPRO anything under the assumption that ERROR_OBJECT | |
968 is GCPRO'd. */ | |
969 | |
970 if (! (CONSP (error_object) && SYMBOLP (type) | |
971 && CONSP (Fget (type, Qerror_conditions, Qnil)))) | |
972 goto error_throw; | |
973 | |
974 tail = XCDR (error_object); | |
975 while (!NILP (tail)) | |
976 { | |
977 if (CONSP (tail)) | |
978 tail = XCDR (tail); | |
979 else | |
980 goto error_throw; | |
981 } | |
982 tail = Fget (type, Qerror_conditions, Qnil); | |
983 while (!NILP (tail)) | |
984 { | |
985 if (!(CONSP (tail) && SYMBOLP (XCAR (tail)))) | |
986 goto error_throw; | |
987 else if (!NILP (Fget (XCAR (tail), Qdisplay_error, Qnil))) | |
988 { | |
989 method = Fget (XCAR (tail), Qdisplay_error, Qnil); | |
990 goto error_throw; | |
991 } | |
992 else | |
993 tail = XCDR (tail); | |
994 } | |
995 /* Default method */ | |
996 { | |
997 int first = 1; | |
998 int speccount = specpdl_depth (); | |
438 | 999 Lisp_Object frame = Qnil; |
1000 struct gcpro gcpro1; | |
1001 GCPRO1 (stream); | |
428 | 1002 |
1003 specbind (Qprint_message_label, Qerror); | |
438 | 1004 stream = print_prepare (stream, &frame); |
1005 | |
428 | 1006 tail = Fcdr (error_object); |
1007 if (EQ (type, Qerror)) | |
1008 { | |
1009 print_internal (Fcar (tail), stream, 0); | |
1010 tail = Fcdr (tail); | |
1011 } | |
1012 else | |
1013 { | |
1014 Lisp_Object errmsg = Fget (type, Qerror_message, Qnil); | |
1015 if (NILP (errmsg)) | |
1016 print_internal (type, stream, 0); | |
1017 else | |
1018 print_internal (LISP_GETTEXT (errmsg), stream, 0); | |
1019 } | |
1020 while (!NILP (tail)) | |
1021 { | |
826 | 1022 write_c_string (stream, first ? ": " : ", "); |
563 | 1023 /* Most errors have an explanatory string as their first argument, |
1024 and it looks better not to put the quotes around it. */ | |
1025 print_internal (Fcar (tail), stream, | |
1026 !(first && STRINGP (Fcar (tail))) || | |
1027 !NILP (Fget (type, Qerror_lacks_explanatory_string, | |
1028 Qnil))); | |
428 | 1029 tail = Fcdr (tail); |
1030 first = 0; | |
1031 } | |
438 | 1032 print_finish (stream, frame); |
1033 UNGCPRO; | |
771 | 1034 unbind_to (speccount); |
428 | 1035 return; |
1036 /* not reached */ | |
1037 } | |
1038 | |
1039 error_throw: | |
1040 if (NILP (method)) | |
1041 { | |
826 | 1042 write_c_string (stream, GETTEXT ("Peculiar error ")); |
428 | 1043 print_internal (error_object, stream, 1); |
1044 return; | |
1045 } | |
1046 else | |
1047 { | |
1048 call2 (method, error_object, stream); | |
1049 } | |
1050 } | |
1051 | |
1052 DEFUN ("error-message-string", Ferror_message_string, 1, 1, 0, /* | |
1053 Convert ERROR-OBJECT to an error message, and return it. | |
1054 | |
1055 The format of ERROR-OBJECT should be (ERROR-SYMBOL . DATA). The | |
1056 message is equivalent to the one that would be issued by | |
1057 `display-error' with the same argument. | |
1058 */ | |
1059 (error_object)) | |
1060 { | |
1061 /* This function can GC */ | |
1062 Lisp_Object result = Qnil; | |
1063 Lisp_Object stream = make_resizing_buffer_output_stream (); | |
1064 struct gcpro gcpro1; | |
1065 GCPRO1 (stream); | |
1066 | |
1067 print_error_message (error_object, stream); | |
1068 Lstream_flush (XLSTREAM (stream)); | |
1069 result = make_string (resizing_buffer_stream_ptr (XLSTREAM (stream)), | |
1070 Lstream_byte_count (XLSTREAM (stream))); | |
1071 Lstream_delete (XLSTREAM (stream)); | |
1072 | |
1073 UNGCPRO; | |
1074 return result; | |
1075 } | |
1076 | |
1077 DEFUN ("display-error", Fdisplay_error, 2, 2, 0, /* | |
1078 Display ERROR-OBJECT on STREAM in a user-friendly way. | |
1079 */ | |
1080 (error_object, stream)) | |
1081 { | |
1082 /* This function can GC */ | |
1083 print_error_message (error_object, canonicalize_printcharfun (stream)); | |
1084 return Qnil; | |
1085 } | |
1086 | |
1087 | |
1088 Lisp_Object Vfloat_output_format; | |
1089 | |
1090 /* | |
1091 * This buffer should be at least as large as the max string size of the | |
440 | 1092 * largest float, printed in the biggest notation. This is undoubtedly |
428 | 1093 * 20d float_output_format, with the negative of the C-constant "HUGE" |
1094 * from <math.h>. | |
1095 * | |
1096 * On the vax the worst case is -1e38 in 20d format which takes 61 bytes. | |
1097 * | |
1098 * I assume that IEEE-754 format numbers can take 329 bytes for the worst | |
1099 * case of -1e307 in 20d float_output_format. What is one to do (short of | |
1100 * re-writing _doprnt to be more sane)? | |
1101 * -wsr | |
1102 */ | |
1103 void | |
1104 float_to_string (char *buf, double data) | |
1105 { | |
867 | 1106 Ibyte *cp, c; |
428 | 1107 int width; |
1108 | |
1109 if (NILP (Vfloat_output_format) | |
1110 || !STRINGP (Vfloat_output_format)) | |
1111 lose: | |
1112 sprintf (buf, "%.16g", data); | |
1113 else /* oink oink */ | |
1114 { | |
1115 /* Check that the spec we have is fully valid. | |
1116 This means not only valid for printf, | |
1117 but meant for floats, and reasonable. */ | |
1118 cp = XSTRING_DATA (Vfloat_output_format); | |
1119 | |
1120 if (cp[0] != '%') | |
1121 goto lose; | |
1122 if (cp[1] != '.') | |
1123 goto lose; | |
1124 | |
1125 cp += 2; | |
1126 for (width = 0; (c = *cp, isdigit (c)); cp++) | |
1127 { | |
1128 width *= 10; | |
1129 width += c - '0'; | |
1130 } | |
1131 | |
1132 if (*cp != 'e' && *cp != 'f' && *cp != 'g' && *cp != 'E' && *cp != 'G') | |
1133 goto lose; | |
1134 | |
1135 if (width < (int) (*cp != 'e' && *cp != 'E') || width > DBL_DIG) | |
1136 goto lose; | |
1137 | |
1138 if (cp[1] != 0) | |
1139 goto lose; | |
1140 | |
1141 sprintf (buf, (char *) XSTRING_DATA (Vfloat_output_format), | |
1142 data); | |
1143 } | |
1144 | |
1145 /* added by jwz: don't allow "1.0" to print as "1"; that destroys | |
1146 the read-equivalence of lisp objects. (* x 1) and (* x 1.0) do | |
1147 not do the same thing, so it's important that the printed | |
1148 representation of that form not be corrupted by the printer. | |
1149 */ | |
1150 { | |
867 | 1151 Ibyte *s = (Ibyte *) buf; /* don't use signed chars here! |
428 | 1152 isdigit() can't hack them! */ |
1153 if (*s == '-') s++; | |
1154 for (; *s; s++) | |
1155 /* if there's a non-digit, then there is a decimal point, or | |
1156 it's in exponential notation, both of which are ok. */ | |
1157 if (!isdigit (*s)) | |
1158 goto DONE_LABEL; | |
1159 /* otherwise, we need to hack it. */ | |
1160 *s++ = '.'; | |
1161 *s++ = '0'; | |
1162 *s = 0; | |
1163 } | |
1164 DONE_LABEL: | |
1165 | |
1166 /* Some machines print "0.4" as ".4". I don't like that. */ | |
1167 if (buf [0] == '.' || (buf [0] == '-' && buf [1] == '.')) | |
1168 { | |
1169 int i; | |
1170 for (i = strlen (buf) + 1; i >= 0; i--) | |
1171 buf [i+1] = buf [i]; | |
1172 buf [(buf [0] == '-' ? 1 : 0)] = '0'; | |
1173 } | |
1174 } | |
1175 | |
2500 | 1176 #define ONE_DIGIT(figure) *p++ = (char) (n / (figure) + '0') |
577 | 1177 #define ONE_DIGIT_ADVANCE(figure) (ONE_DIGIT (figure), n %= (figure)) |
1178 | |
1179 #define DIGITS_1(figure) ONE_DIGIT (figure) | |
1180 #define DIGITS_2(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_1 ((figure) / 10) | |
1181 #define DIGITS_3(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_2 ((figure) / 10) | |
1182 #define DIGITS_4(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_3 ((figure) / 10) | |
1183 #define DIGITS_5(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_4 ((figure) / 10) | |
1184 #define DIGITS_6(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_5 ((figure) / 10) | |
1185 #define DIGITS_7(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_6 ((figure) / 10) | |
1186 #define DIGITS_8(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_7 ((figure) / 10) | |
1187 #define DIGITS_9(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_8 ((figure) / 10) | |
1188 #define DIGITS_10(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_9 ((figure) / 10) | |
1189 | |
1190 /* DIGITS_<11-20> are only used on machines with 64-bit longs. */ | |
428 | 1191 |
577 | 1192 #define DIGITS_11(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_10 ((figure) / 10) |
1193 #define DIGITS_12(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_11 ((figure) / 10) | |
1194 #define DIGITS_13(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_12 ((figure) / 10) | |
1195 #define DIGITS_14(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_13 ((figure) / 10) | |
1196 #define DIGITS_15(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_14 ((figure) / 10) | |
1197 #define DIGITS_16(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_15 ((figure) / 10) | |
1198 #define DIGITS_17(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_16 ((figure) / 10) | |
1199 #define DIGITS_18(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_17 ((figure) / 10) | |
1200 #define DIGITS_19(figure) ONE_DIGIT_ADVANCE (figure); DIGITS_18 ((figure) / 10) | |
1201 | |
1202 /* Print NUMBER to BUFFER in base 10. This is completely equivalent | |
1203 to `sprintf(buffer, "%ld", number)', only much faster. | |
1204 | |
1205 The speedup may make a difference in programs that frequently | |
1206 convert numbers to strings. Some implementations of sprintf, | |
1207 particularly the one in GNU libc, have been known to be extremely | |
1208 slow compared to this function. | |
1209 | |
1210 BUFFER should accept as many bytes as you expect the number to take | |
1211 up. On machines with 64-bit longs the maximum needed size is 24 | |
1212 bytes. That includes the worst-case digits, the optional `-' sign, | |
1213 and the trailing \0. */ | |
1214 | |
1215 void | |
428 | 1216 long_to_string (char *buffer, long number) |
1217 { | |
577 | 1218 char *p = buffer; |
1219 long n = number; | |
1220 | |
428 | 1221 #if (SIZEOF_LONG != 4) && (SIZEOF_LONG != 8) |
577 | 1222 /* We are running in a strange or misconfigured environment. Let |
1223 sprintf cope with it. */ | |
1224 sprintf (buffer, "%ld", n); | |
1225 #else /* (SIZEOF_LONG == 4) || (SIZEOF_LONG == 8) */ | |
428 | 1226 |
577 | 1227 if (n < 0) |
428 | 1228 { |
1229 *p++ = '-'; | |
577 | 1230 n = -n; |
428 | 1231 } |
1232 | |
577 | 1233 if (n < 10) { DIGITS_1 (1); } |
1234 else if (n < 100) { DIGITS_2 (10); } | |
1235 else if (n < 1000) { DIGITS_3 (100); } | |
1236 else if (n < 10000) { DIGITS_4 (1000); } | |
1237 else if (n < 100000) { DIGITS_5 (10000); } | |
1238 else if (n < 1000000) { DIGITS_6 (100000); } | |
1239 else if (n < 10000000) { DIGITS_7 (1000000); } | |
1240 else if (n < 100000000) { DIGITS_8 (10000000); } | |
1241 else if (n < 1000000000) { DIGITS_9 (100000000); } | |
1242 #if SIZEOF_LONG == 4 | |
1243 /* ``if (1)'' serves only to preserve editor indentation. */ | |
1244 else if (1) { DIGITS_10 (1000000000); } | |
1245 #else /* SIZEOF_LONG != 4 */ | |
1246 else if (n < 10000000000L) { DIGITS_10 (1000000000L); } | |
1247 else if (n < 100000000000L) { DIGITS_11 (10000000000L); } | |
1248 else if (n < 1000000000000L) { DIGITS_12 (100000000000L); } | |
1249 else if (n < 10000000000000L) { DIGITS_13 (1000000000000L); } | |
1250 else if (n < 100000000000000L) { DIGITS_14 (10000000000000L); } | |
1251 else if (n < 1000000000000000L) { DIGITS_15 (100000000000000L); } | |
1252 else if (n < 10000000000000000L) { DIGITS_16 (1000000000000000L); } | |
1253 else if (n < 100000000000000000L) { DIGITS_17 (10000000000000000L); } | |
1254 else if (n < 1000000000000000000L) { DIGITS_18 (100000000000000000L); } | |
1255 else { DIGITS_19 (1000000000000000000L); } | |
1256 #endif /* SIZEOF_LONG != 4 */ | |
1257 | |
428 | 1258 *p = '\0'; |
1259 #endif /* (SIZEOF_LONG == 4) || (SIZEOF_LONG == 8) */ | |
1260 } | |
577 | 1261 |
1262 #undef ONE_DIGIT | |
1263 #undef ONE_DIGIT_ADVANCE | |
1264 | |
1265 #undef DIGITS_1 | |
1266 #undef DIGITS_2 | |
1267 #undef DIGITS_3 | |
1268 #undef DIGITS_4 | |
1269 #undef DIGITS_5 | |
1270 #undef DIGITS_6 | |
1271 #undef DIGITS_7 | |
1272 #undef DIGITS_8 | |
1273 #undef DIGITS_9 | |
1274 #undef DIGITS_10 | |
1275 #undef DIGITS_11 | |
1276 #undef DIGITS_12 | |
1277 #undef DIGITS_13 | |
1278 #undef DIGITS_14 | |
1279 #undef DIGITS_15 | |
1280 #undef DIGITS_16 | |
1281 #undef DIGITS_17 | |
1282 #undef DIGITS_18 | |
1283 #undef DIGITS_19 | |
428 | 1284 |
4329
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
3263
diff
changeset
|
1285 void |
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
3263
diff
changeset
|
1286 ulong_to_bit_string (char *p, unsigned long number) |
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
3263
diff
changeset
|
1287 { |
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
3263
diff
changeset
|
1288 int i, seen_high_order = 0;; |
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
3263
diff
changeset
|
1289 |
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
3263
diff
changeset
|
1290 for (i = ((SIZEOF_LONG * 8) - 1); i >= 0; --i) |
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
3263
diff
changeset
|
1291 { |
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
3263
diff
changeset
|
1292 if (number & (unsigned long)1 << i) |
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
3263
diff
changeset
|
1293 { |
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
3263
diff
changeset
|
1294 seen_high_order = 1; |
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
3263
diff
changeset
|
1295 *p++ = '1'; |
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
3263
diff
changeset
|
1296 } |
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
3263
diff
changeset
|
1297 else |
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
3263
diff
changeset
|
1298 { |
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
3263
diff
changeset
|
1299 if (seen_high_order) |
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
3263
diff
changeset
|
1300 { |
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
3263
diff
changeset
|
1301 *p++ = '0'; |
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
3263
diff
changeset
|
1302 } |
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
3263
diff
changeset
|
1303 } |
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
3263
diff
changeset
|
1304 } |
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
3263
diff
changeset
|
1305 *p = '\0'; |
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
3263
diff
changeset
|
1306 } |
d9eb5ea14f65
Provide %b in #'format; use it for converting between ints and bit vectors.
Aidan Kehoe <kehoea@parhasard.net>
parents:
3263
diff
changeset
|
1307 |
428 | 1308 static void |
442 | 1309 print_vector_internal (const char *start, const char *end, |
428 | 1310 Lisp_Object obj, |
1311 Lisp_Object printcharfun, int escapeflag) | |
1312 { | |
1313 /* This function can GC */ | |
1314 int i; | |
1315 int len = XVECTOR_LENGTH (obj); | |
1316 int last = len; | |
1317 struct gcpro gcpro1, gcpro2; | |
1318 GCPRO2 (obj, printcharfun); | |
1319 | |
1320 if (INTP (Vprint_length)) | |
1321 { | |
1322 int max = XINT (Vprint_length); | |
1323 if (max < len) last = max; | |
1324 } | |
1325 | |
826 | 1326 write_c_string (printcharfun, start); |
428 | 1327 for (i = 0; i < last; i++) |
1328 { | |
1329 Lisp_Object elt = XVECTOR_DATA (obj)[i]; | |
826 | 1330 if (i != 0) write_c_string (printcharfun, " "); |
428 | 1331 print_internal (elt, printcharfun, escapeflag); |
1332 } | |
1333 UNGCPRO; | |
1334 if (last != len) | |
826 | 1335 write_c_string (printcharfun, " ..."); |
1336 write_c_string (printcharfun, end); | |
428 | 1337 } |
1338 | |
1339 void | |
1340 print_cons (Lisp_Object obj, Lisp_Object printcharfun, int escapeflag) | |
1341 { | |
1342 /* This function can GC */ | |
1343 struct gcpro gcpro1, gcpro2; | |
1344 | |
1345 /* If print_readably is on, print (quote -foo-) as '-foo- | |
1346 (Yeah, this should really be what print-pretty does, but we | |
1347 don't have the rest of a pretty printer, and this actually | |
1348 has non-negligible impact on size/speed of .elc files.) | |
1349 */ | |
1350 if (print_readably && | |
1351 EQ (XCAR (obj), Qquote) && | |
1352 CONSP (XCDR (obj)) && | |
1353 NILP (XCDR (XCDR (obj)))) | |
1354 { | |
1355 obj = XCAR (XCDR (obj)); | |
1356 GCPRO2 (obj, printcharfun); | |
826 | 1357 write_c_string (printcharfun, "\'"); |
428 | 1358 UNGCPRO; |
1359 print_internal (obj, printcharfun, escapeflag); | |
1360 return; | |
1361 } | |
1362 | |
1363 GCPRO2 (obj, printcharfun); | |
826 | 1364 write_c_string (printcharfun, "("); |
428 | 1365 |
1366 { | |
1367 int len; | |
1368 int max = INTP (Vprint_length) ? XINT (Vprint_length) : INT_MAX; | |
1369 Lisp_Object tortoise; | |
1370 /* Use tortoise/hare to make sure circular lists don't infloop */ | |
1371 | |
1372 for (tortoise = obj, len = 0; | |
1373 CONSP (obj); | |
1374 obj = XCDR (obj), len++) | |
1375 { | |
1376 if (len > 0) | |
826 | 1377 write_c_string (printcharfun, " "); |
428 | 1378 if (EQ (obj, tortoise) && len > 0) |
1379 { | |
1380 if (print_readably) | |
563 | 1381 printing_unreadable_object ("circular list"); |
428 | 1382 else |
826 | 1383 write_c_string (printcharfun, "... <circular list>"); |
428 | 1384 break; |
1385 } | |
1386 if (len & 1) | |
1387 tortoise = XCDR (tortoise); | |
1388 if (len > max) | |
1389 { | |
826 | 1390 write_c_string (printcharfun, "..."); |
428 | 1391 break; |
1392 } | |
1393 print_internal (XCAR (obj), printcharfun, escapeflag); | |
1394 } | |
1395 } | |
1396 if (!LISTP (obj)) | |
1397 { | |
826 | 1398 write_c_string (printcharfun, " . "); |
428 | 1399 print_internal (obj, printcharfun, escapeflag); |
1400 } | |
1401 UNGCPRO; | |
1402 | |
826 | 1403 write_c_string (printcharfun, ")"); |
428 | 1404 return; |
1405 } | |
1406 | |
1407 void | |
1408 print_vector (Lisp_Object obj, Lisp_Object printcharfun, int escapeflag) | |
1409 { | |
1410 print_vector_internal ("[", "]", obj, printcharfun, escapeflag); | |
1411 } | |
1412 | |
1413 void | |
1414 print_string (Lisp_Object obj, Lisp_Object printcharfun, int escapeflag) | |
1415 { | |
1416 /* We distinguish between Bytecounts and Charcounts, to make | |
1417 Vprint_string_length work correctly under Mule. */ | |
826 | 1418 Charcount size = string_char_length (obj); |
428 | 1419 Charcount max = size; |
793 | 1420 Bytecount bcmax = XSTRING_LENGTH (obj); |
428 | 1421 struct gcpro gcpro1, gcpro2; |
1422 GCPRO2 (obj, printcharfun); | |
1423 | |
1424 if (INTP (Vprint_string_length) && | |
1425 XINT (Vprint_string_length) < max) | |
1426 { | |
1427 max = XINT (Vprint_string_length); | |
793 | 1428 bcmax = string_index_char_to_byte (obj, max); |
428 | 1429 } |
1430 if (max < 0) | |
1431 { | |
1432 max = 0; | |
1433 bcmax = 0; | |
1434 } | |
1435 | |
1436 if (!escapeflag) | |
1437 { | |
1438 /* This deals with GC-relocation and Mule. */ | |
1439 output_string (printcharfun, 0, obj, 0, bcmax); | |
1440 if (max < size) | |
826 | 1441 write_c_string (printcharfun, " ..."); |
428 | 1442 } |
1443 else | |
1444 { | |
1445 Bytecount i, last = 0; | |
1446 | |
826 | 1447 write_c_string (printcharfun, "\""); |
428 | 1448 for (i = 0; i < bcmax; i++) |
1449 { | |
867 | 1450 Ibyte ch = string_byte (obj, i); |
428 | 1451 if (ch == '\"' || ch == '\\' |
1452 || (ch == '\n' && print_escape_newlines)) | |
1453 { | |
1454 if (i > last) | |
1455 { | |
1456 output_string (printcharfun, 0, obj, last, | |
1457 i - last); | |
1458 } | |
1459 if (ch == '\n') | |
1460 { | |
826 | 1461 write_c_string (printcharfun, "\\n"); |
428 | 1462 } |
1463 else | |
1464 { | |
867 | 1465 Ibyte temp[2]; |
826 | 1466 write_c_string (printcharfun, "\\"); |
428 | 1467 /* This is correct for Mule because the |
1468 character is either \ or " */ | |
826 | 1469 temp[0] = string_byte (obj, i); |
1470 temp[1] = '\0'; | |
1471 write_string (printcharfun, temp); | |
428 | 1472 } |
1473 last = i + 1; | |
1474 } | |
1475 } | |
1476 if (bcmax > last) | |
1477 { | |
1478 output_string (printcharfun, 0, obj, last, | |
1479 bcmax - last); | |
1480 } | |
1481 if (max < size) | |
826 | 1482 write_c_string (printcharfun, " ..."); |
1483 write_c_string (printcharfun, "\""); | |
428 | 1484 } |
1485 UNGCPRO; | |
1486 } | |
1487 | |
4846 | 1488 DOESNT_RETURN |
1489 printing_unreadable_object (const CIbyte *fmt, ...) | |
1490 { | |
1491 Lisp_Object obj; | |
1492 va_list args; | |
1493 | |
1494 va_start (args, fmt); | |
1495 obj = emacs_vsprintf_string (CGETTEXT (fmt), args); | |
1496 va_end (args); | |
1497 | |
1498 /* Fsignal GC-protects its args */ | |
1499 signal_error (Qprinting_unreadable_object, 0, obj); | |
1500 } | |
1501 | |
1502 DOESNT_RETURN | |
1503 printing_unreadable_lcrecord (Lisp_Object obj, const Ibyte *name) | |
428 | 1504 { |
3017 | 1505 struct LCRECORD_HEADER *header = (struct LCRECORD_HEADER *) XPNTR (obj); |
428 | 1506 |
4846 | 1507 #ifndef NEW_GC |
1508 /* This must be a real lcrecord */ | |
1509 assert (!LHEADER_IMPLEMENTATION (&header->lheader)->basic_p); | |
1510 #endif | |
1511 | |
1512 if (name) | |
1513 printing_unreadable_object | |
1514 ("#<%s %s 0x%x>", | |
1515 #ifdef NEW_GC | |
1516 LHEADER_IMPLEMENTATION (header)->name, | |
1517 #else /* not NEW_GC */ | |
1518 LHEADER_IMPLEMENTATION (&header->lheader)->name, | |
1519 #endif /* not NEW_GC */ | |
1520 name, | |
1521 header->uid); | |
1522 else | |
563 | 1523 printing_unreadable_object |
1524 ("#<%s 0x%x>", | |
3263 | 1525 #ifdef NEW_GC |
2720 | 1526 LHEADER_IMPLEMENTATION (header)->name, |
3263 | 1527 #else /* not NEW_GC */ |
563 | 1528 LHEADER_IMPLEMENTATION (&header->lheader)->name, |
3263 | 1529 #endif /* not NEW_GC */ |
563 | 1530 header->uid); |
4846 | 1531 } |
1532 | |
1533 void | |
1534 default_object_printer (Lisp_Object obj, Lisp_Object printcharfun, | |
1535 int UNUSED (escapeflag)) | |
1536 { | |
1537 struct LCRECORD_HEADER *header = (struct LCRECORD_HEADER *) XPNTR (obj); | |
1538 | |
1539 #ifndef NEW_GC | |
1540 /* This must be a real lcrecord */ | |
1541 assert (!LHEADER_IMPLEMENTATION (&header->lheader)->basic_p); | |
1542 #endif | |
1543 | |
1544 if (print_readably) | |
1545 printing_unreadable_lcrecord (obj, 0); | |
428 | 1546 |
800 | 1547 write_fmt_string (printcharfun, "#<%s 0x%x>", |
3263 | 1548 #ifdef NEW_GC |
2720 | 1549 LHEADER_IMPLEMENTATION (header)->name, |
3263 | 1550 #else /* not NEW_GC */ |
800 | 1551 LHEADER_IMPLEMENTATION (&header->lheader)->name, |
3263 | 1552 #endif /* not NEW_GC */ |
800 | 1553 header->uid); |
428 | 1554 } |
1555 | |
1556 void | |
1557 internal_object_printer (Lisp_Object obj, Lisp_Object printcharfun, | |
2286 | 1558 int UNUSED (escapeflag)) |
428 | 1559 { |
800 | 1560 write_fmt_string (printcharfun, |
1561 "#<INTERNAL OBJECT (XEmacs bug?) (%s) 0x%lx>", | |
1562 XRECORD_LHEADER_IMPLEMENTATION (obj)->name, | |
1563 (unsigned long) XPNTR (obj)); | |
428 | 1564 } |
1565 | |
1204 | 1566 enum printing_badness |
1567 { | |
1568 BADNESS_INTEGER_OBJECT, | |
1569 BADNESS_POINTER_OBJECT, | |
1570 BADNESS_NO_TYPE | |
1571 }; | |
1572 | |
1573 static void | |
1574 printing_major_badness (Lisp_Object printcharfun, | |
4528
726060ee587c
First draft of g++ 4.3 warning removal patch. Builds. *Needs ChangeLogs.*
Stephen J. Turnbull <stephen@xemacs.org>
parents:
4522
diff
changeset
|
1575 const Ascbyte *badness_string, int type, void *val, |
1204 | 1576 enum printing_badness badness) |
1577 { | |
1578 Ibyte buf[666]; | |
1579 | |
1580 switch (badness) | |
1581 { | |
1582 case BADNESS_INTEGER_OBJECT: | |
1583 qxesprintf (buf, "%s %d object %ld", badness_string, type, | |
1584 (EMACS_INT) val); | |
1585 break; | |
1586 | |
1587 case BADNESS_POINTER_OBJECT: | |
1588 qxesprintf (buf, "%s %d object %p", badness_string, type, val); | |
1589 break; | |
1590 | |
1591 case BADNESS_NO_TYPE: | |
1592 qxesprintf (buf, "%s object %p", badness_string, val); | |
1593 break; | |
1594 } | |
1595 | |
1596 /* Don't abort or signal if called from debug_print() or already | |
1597 crashing */ | |
2367 | 1598 if (!inhibit_non_essential_conversion_operations) |
1204 | 1599 { |
1600 #ifdef ERROR_CHECK_TYPES | |
2500 | 1601 ABORT (); |
1204 | 1602 #else /* not ERROR_CHECK_TYPES */ |
1603 if (print_readably) | |
1604 signal_ferror (Qinternal_error, "printing %s", buf); | |
1605 #endif /* not ERROR_CHECK_TYPES */ | |
1606 } | |
1607 write_fmt_string (printcharfun, | |
1608 "#<EMACS BUG: %s Save your buffers immediately and " | |
1609 "please report this bug>", buf); | |
1610 } | |
1611 | |
428 | 1612 void |
1613 print_internal (Lisp_Object obj, Lisp_Object printcharfun, int escapeflag) | |
1614 { | |
1615 /* This function can GC */ | |
2001 | 1616 int specdepth = 0; |
1204 | 1617 struct gcpro gcpro1, gcpro2; |
428 | 1618 |
1619 QUIT; | |
1620 | |
771 | 1621 #ifdef NO_PRINT_DURING_GC |
428 | 1622 /* Emacs won't print while GCing, but an external debugger might */ |
1623 if (gc_in_progress) return; | |
771 | 1624 #endif |
1625 | |
1204 | 1626 /* Just to be safe ... */ |
1627 GCPRO2 (obj, printcharfun); | |
428 | 1628 |
1629 #ifdef I18N3 | |
1630 /* #### Both input and output streams should have a flag associated | |
1631 with them indicating whether output to that stream, or strings | |
1632 read from the stream, get translated using Fgettext(). Such a | |
1633 stream is called a "translating stream". For the minibuffer and | |
1634 external-debugging-output this is always true on output, and | |
1635 with-output-to-temp-buffer sets the flag to true for the buffer | |
1636 it creates. This flag should also be user-settable. Perhaps it | |
1637 should be split up into two flags, one for input and one for | |
1638 output. */ | |
1639 #endif | |
1640 | |
1641 /* Detect circularities and truncate them. | |
1642 No need to offer any alternative--this is better than an error. */ | |
1643 if (CONSP (obj) || VECTORP (obj) || COMPILED_FUNCTIONP (obj)) | |
1644 { | |
1645 int i; | |
1646 for (i = 0; i < print_depth; i++) | |
1647 if (EQ (obj, being_printed[i])) | |
1648 { | |
603 | 1649 char buf[DECIMAL_PRINT_SIZE (long) + 1]; |
428 | 1650 *buf = '#'; |
1651 long_to_string (buf + 1, i); | |
826 | 1652 write_c_string (printcharfun, buf); |
1204 | 1653 UNGCPRO; |
428 | 1654 return; |
1655 } | |
1656 } | |
1657 | |
1658 being_printed[print_depth] = obj; | |
1659 | |
1957 | 1660 /* Avoid calling internal_bind_int, which conses, when called from |
1661 debug_prin1. In that case, we have bound print_depth to 0 anyway. */ | |
2367 | 1662 if (!inhibit_non_essential_conversion_operations) |
1957 | 1663 { |
1664 specdepth = internal_bind_int (&print_depth, print_depth + 1); | |
1665 | |
1666 if (print_depth > PRINT_CIRCLE) | |
1667 signal_error (Qstack_overflow, "Apparently circular structure being printed", Qunbound); | |
1668 } | |
428 | 1669 |
1670 switch (XTYPE (obj)) | |
1671 { | |
1672 case Lisp_Type_Int_Even: | |
1673 case Lisp_Type_Int_Odd: | |
1674 { | |
603 | 1675 char buf[DECIMAL_PRINT_SIZE (EMACS_INT)]; |
428 | 1676 long_to_string (buf, XINT (obj)); |
826 | 1677 write_c_string (printcharfun, buf); |
428 | 1678 break; |
1679 } | |
1680 | |
1681 case Lisp_Type_Char: | |
1682 { | |
1683 /* God intended that this be #\..., you know. */ | |
1684 char buf[16]; | |
867 | 1685 Ichar ch = XCHAR (obj); |
428 | 1686 char *p = buf; |
1687 *p++ = '?'; | |
434 | 1688 if (ch < 32) |
1689 { | |
1690 *p++ = '\\'; | |
1691 switch (ch) | |
1692 { | |
1693 case '\t': *p++ = 't'; break; | |
1694 case '\n': *p++ = 'n'; break; | |
1695 case '\r': *p++ = 'r'; break; | |
1696 default: | |
1697 *p++ = '^'; | |
1698 *p++ = ch + 64; | |
1699 if ((ch + 64) == '\\') | |
1700 *p++ = '\\'; | |
1701 break; | |
1702 } | |
1703 } | |
1704 else if (ch < 127) | |
428 | 1705 { |
434 | 1706 /* syntactically special characters should be escaped. */ |
1707 switch (ch) | |
1708 { | |
1709 case ' ': | |
1710 case '"': | |
1711 case '#': | |
1712 case '\'': | |
1713 case '(': | |
1714 case ')': | |
1715 case ',': | |
1716 case '.': | |
1717 case ';': | |
1718 case '?': | |
1719 case '[': | |
1720 case '\\': | |
1721 case ']': | |
1722 case '`': | |
1723 *p++ = '\\'; | |
1724 } | |
1725 *p++ = ch; | |
428 | 1726 } |
1727 else if (ch == 127) | |
434 | 1728 { |
1729 *p++ = '\\', *p++ = '^', *p++ = '?'; | |
1730 } | |
1731 else if (ch < 160) | |
428 | 1732 { |
1733 *p++ = '\\', *p++ = '^'; | |
867 | 1734 p += set_itext_ichar ((Ibyte *) p, ch + 64); |
428 | 1735 } |
1736 else | |
434 | 1737 { |
867 | 1738 p += set_itext_ichar ((Ibyte *) p, ch); |
434 | 1739 } |
440 | 1740 |
867 | 1741 output_string (printcharfun, (Ibyte *) buf, Qnil, 0, p - buf); |
434 | 1742 |
428 | 1743 break; |
1744 } | |
1745 | |
1746 case Lisp_Type_Record: | |
1747 { | |
1748 struct lrecord_header *lheader = XRECORD_LHEADER (obj); | |
1204 | 1749 |
1750 /* Try to check for various sorts of bogus pointers if we're in a | |
1751 situation where it may be likely -- i.e. called from | |
1752 debug_print() or we're already crashing. In such cases, | |
1753 (further) crashing is counterproductive. */ | |
428 | 1754 |
2367 | 1755 if (inhibit_non_essential_conversion_operations && |
1204 | 1756 !debug_can_access_memory (lheader, sizeof (*lheader))) |
1757 { | |
1758 write_fmt_string (printcharfun, "#<EMACS BUG: BAD MEMORY %p>", | |
1759 lheader); | |
1760 break; | |
1761 } | |
1762 | |
1763 if (CONSP (obj) || VECTORP (obj)) | |
428 | 1764 { |
1765 /* If deeper than spec'd depth, print placeholder. */ | |
1766 if (INTP (Vprint_level) | |
1767 && print_depth > XINT (Vprint_level)) | |
1768 { | |
826 | 1769 write_c_string (printcharfun, "..."); |
428 | 1770 break; |
1771 } | |
1772 } | |
1773 | |
3263 | 1774 #ifndef NEW_GC |
1204 | 1775 if (lheader->type == lrecord_type_free) |
1776 { | |
1777 printing_major_badness (printcharfun, "freed lrecord", 0, | |
1778 lheader, BADNESS_NO_TYPE); | |
1779 break; | |
1780 } | |
1781 else if (lheader->type == lrecord_type_undefined) | |
1782 { | |
1783 printing_major_badness (printcharfun, "lrecord_type_undefined", 0, | |
1784 lheader, BADNESS_NO_TYPE); | |
1785 break; | |
1786 } | |
3263 | 1787 #endif /* not NEW_GC */ |
1204 | 1788 else if ((int) (lheader->type) >= lrecord_type_count) |
1789 { | |
1790 printing_major_badness (printcharfun, "illegal lrecord type", | |
1791 (int) (lheader->type), | |
1792 lheader, BADNESS_POINTER_OBJECT); | |
1793 break; | |
1794 } | |
1795 | |
1796 /* Further checks for bad memory in critical situations. We don't | |
1797 normally do these because they may be expensive or weird | |
1798 (e.g. under Unix we typically have to set a SIGSEGV handler and | |
1799 try to trigger a seg fault). */ | |
1800 | |
2367 | 1801 if (inhibit_non_essential_conversion_operations) |
1204 | 1802 { |
1803 if (!debug_can_access_memory | |
1804 (lheader, detagged_lisp_object_size (lheader))) | |
1805 { | |
1806 write_fmt_string (printcharfun, | |
1807 "#<EMACS BUG: type %s BAD MEMORY %p>", | |
1808 LHEADER_IMPLEMENTATION (lheader)->name, | |
1809 lheader); | |
1810 break; | |
1811 } | |
1812 | |
1813 if (STRINGP (obj)) | |
1814 { | |
3092 | 1815 #ifdef NEW_GC |
1816 if (!debug_can_access_memory (XSTRING_DATA (obj), | |
1817 XSTRING_LENGTH (obj))) | |
1818 { | |
1819 write_fmt_string | |
1820 (printcharfun, | |
1821 "#<EMACS BUG: %p (BAD STRING DATA %p)>", | |
1822 lheader, XSTRING_DATA (obj)); | |
1823 break; | |
1824 } | |
1825 #else /* not NEW_GC */ | |
1204 | 1826 Lisp_String *l = (Lisp_String *) lheader; |
1827 if (!debug_can_access_memory (l->data_, l->size_)) | |
1828 { | |
1829 write_fmt_string | |
1830 (printcharfun, | |
1831 "#<EMACS BUG: %p (BAD STRING DATA %p)>", | |
1832 lheader, l->data_); | |
1833 break; | |
1834 } | |
3092 | 1835 #endif /* not NEW_GC */ |
1204 | 1836 } |
1837 } | |
1838 | |
428 | 1839 if (LHEADER_IMPLEMENTATION (lheader)->printer) |
1840 ((LHEADER_IMPLEMENTATION (lheader)->printer) | |
1841 (obj, printcharfun, escapeflag)); | |
1842 else | |
3085 | 1843 internal_object_printer (obj, printcharfun, escapeflag); |
428 | 1844 break; |
1845 } | |
1846 | |
1847 default: | |
1848 { | |
1849 /* We're in trouble if this happens! */ | |
1204 | 1850 printing_major_badness (printcharfun, "illegal data type", XTYPE (obj), |
1851 LISP_TO_VOID (obj), BADNESS_INTEGER_OBJECT); | |
428 | 1852 break; |
1853 } | |
1854 } | |
1855 | |
2367 | 1856 if (!inhibit_non_essential_conversion_operations) |
1957 | 1857 unbind_to (specdepth); |
1204 | 1858 UNGCPRO; |
428 | 1859 } |
1860 | |
1861 void | |
2286 | 1862 print_float (Lisp_Object obj, Lisp_Object printcharfun, |
1863 int UNUSED (escapeflag)) | |
428 | 1864 { |
1865 char pigbuf[350]; /* see comments in float_to_string */ | |
1866 | |
1867 float_to_string (pigbuf, XFLOAT_DATA (obj)); | |
826 | 1868 write_c_string (printcharfun, pigbuf); |
428 | 1869 } |
1870 | |
1871 void | |
1872 print_symbol (Lisp_Object obj, Lisp_Object printcharfun, int escapeflag) | |
1873 { | |
1874 /* This function can GC */ | |
1875 /* #### Bug!! (intern "") isn't printed in some distinguished way */ | |
1876 /* #### (the reader also loses on it) */ | |
793 | 1877 Lisp_Object name = symbol_name (XSYMBOL (obj)); |
1878 Bytecount size = XSTRING_LENGTH (name); | |
428 | 1879 struct gcpro gcpro1, gcpro2; |
1880 | |
1881 if (!escapeflag) | |
1882 { | |
1883 /* This deals with GC-relocation */ | |
793 | 1884 output_string (printcharfun, 0, name, 0, size); |
428 | 1885 return; |
1886 } | |
1887 GCPRO2 (obj, printcharfun); | |
1888 | |
1889 /* If we print an uninterned symbol as part of a complex object and | |
1890 the flag print-gensym is non-nil, prefix it with #n= to read the | |
1891 object back with the #n# reader syntax later if needed. */ | |
1892 if (!NILP (Vprint_gensym) | |
442 | 1893 /* #### Test whether this produces a noticeable slow-down for |
428 | 1894 printing when print-gensym is non-nil. */ |
1895 && !EQ (obj, oblookup (Vobarray, | |
793 | 1896 XSTRING_DATA (symbol_name (XSYMBOL (obj))), |
1897 XSTRING_LENGTH (symbol_name (XSYMBOL (obj)))))) | |
428 | 1898 { |
1899 if (print_depth > 1) | |
1900 { | |
1901 Lisp_Object tem = Fassq (obj, Vprint_gensym_alist); | |
1902 if (CONSP (tem)) | |
1903 { | |
826 | 1904 write_c_string (printcharfun, "#"); |
428 | 1905 print_internal (XCDR (tem), printcharfun, escapeflag); |
826 | 1906 write_c_string (printcharfun, "#"); |
446 | 1907 UNGCPRO; |
428 | 1908 return; |
1909 } | |
1910 else | |
1911 { | |
1912 if (CONSP (Vprint_gensym_alist)) | |
1913 { | |
1914 /* Vprint_gensym_alist is exposed to Lisp, so we | |
1915 have to be careful. */ | |
1916 CHECK_CONS (XCAR (Vprint_gensym_alist)); | |
1917 CHECK_INT (XCDR (XCAR (Vprint_gensym_alist))); | |
793 | 1918 tem = make_int (XINT (XCDR (XCAR (Vprint_gensym_alist))) + 1); |
428 | 1919 } |
1920 else | |
793 | 1921 tem = make_int (1); |
428 | 1922 Vprint_gensym_alist = Fcons (Fcons (obj, tem), Vprint_gensym_alist); |
1923 | |
826 | 1924 write_c_string (printcharfun, "#"); |
428 | 1925 print_internal (tem, printcharfun, escapeflag); |
826 | 1926 write_c_string (printcharfun, "="); |
428 | 1927 } |
1928 } | |
826 | 1929 write_c_string (printcharfun, "#:"); |
428 | 1930 } |
1931 | |
1932 /* Does it look like an integer or a float? */ | |
1933 { | |
867 | 1934 Ibyte *data = XSTRING_DATA (name); |
428 | 1935 Bytecount confusing = 0; |
1936 | |
1937 if (size == 0) | |
1938 goto not_yet_confused; /* Really confusing */ | |
1939 else if (isdigit (data[0])) | |
1940 confusing = 0; | |
1941 else if (size == 1) | |
1942 goto not_yet_confused; | |
1943 else if (data[0] == '-' || data[0] == '+') | |
1944 confusing = 1; | |
1945 else | |
1946 goto not_yet_confused; | |
1947 | |
1948 for (; confusing < size; confusing++) | |
1949 { | |
1950 if (!isdigit (data[confusing])) | |
1951 { | |
1952 confusing = 0; | |
1953 break; | |
1954 } | |
1955 } | |
1956 not_yet_confused: | |
1957 | |
1958 if (!confusing) | |
1959 /* #### Ugh, this is needlessly complex and slow for what we | |
1960 need here. It might be a good idea to copy equivalent code | |
1961 from FSF. --hniksic */ | |
1962 confusing = isfloat_string ((char *) data); | |
1963 if (confusing) | |
826 | 1964 write_c_string (printcharfun, "\\"); |
428 | 1965 } |
1966 | |
1967 { | |
1968 Bytecount i; | |
1969 Bytecount last = 0; | |
1970 | |
1971 for (i = 0; i < size; i++) | |
1972 { | |
826 | 1973 switch (string_byte (name, i)) |
428 | 1974 { |
1975 case 0: case 1: case 2: case 3: | |
1976 case 4: case 5: case 6: case 7: | |
1977 case 8: case 9: case 10: case 11: | |
1978 case 12: case 13: case 14: case 15: | |
1979 case 16: case 17: case 18: case 19: | |
1980 case 20: case 21: case 22: case 23: | |
1981 case 24: case 25: case 26: case 27: | |
1982 case 28: case 29: case 30: case 31: | |
1983 case ' ': case '\"': case '\\': case '\'': | |
1984 case ';': case '#' : case '(' : case ')': | |
1985 case ',': case '.' : case '`' : | |
1986 case '[': case ']' : case '?' : | |
1987 if (i > last) | |
793 | 1988 output_string (printcharfun, 0, name, last, i - last); |
826 | 1989 write_c_string (printcharfun, "\\"); |
428 | 1990 last = i; |
1991 } | |
1992 } | |
793 | 1993 output_string (printcharfun, 0, name, last, size - last); |
428 | 1994 } |
1995 UNGCPRO; | |
1996 } | |
1997 | |
1998 | |
442 | 1999 /* Useful on systems or in places where writing to stdout is unavailable or |
2000 not working. */ | |
428 | 2001 |
2002 static int alternate_do_pointer; | |
1957 | 2003 static int alternate_do_size; |
2004 static char *alternate_do_string; | |
428 | 2005 |
2006 DEFUN ("alternate-debugging-output", Falternate_debugging_output, 1, 1, 0, /* | |
2007 Append CHARACTER to the array `alternate_do_string'. | |
2008 This can be used in place of `external-debugging-output' as a function | |
2009 to be passed to `print'. Before calling `print', set `alternate_do_pointer' | |
2010 to 0. | |
2011 */ | |
2012 (character)) | |
2013 { | |
867 | 2014 Ibyte str[MAX_ICHAR_LEN]; |
428 | 2015 Bytecount len; |
2016 | |
2017 CHECK_CHAR_COERCE_INT (character); | |
867 | 2018 len = set_itext_ichar (str, XCHAR (character)); |
771 | 2019 write_string_to_alternate_debugging_output (str, len); |
2020 | |
2021 return character; | |
2022 } | |
2023 | |
2024 static void | |
1346 | 2025 write_string_to_alternate_debugging_output (const Ibyte *str, Bytecount len) |
771 | 2026 { |
2027 int extlen; | |
2028 const Extbyte *extptr; | |
2029 #if 0 /* We want to see the internal representation, don't we? */ | |
2367 | 2030 if (initialized && !inhibit_non_essential_conversion_operations) |
771 | 2031 TO_EXTERNAL_FORMAT (DATA, (str, len), |
2032 ALLOCA, (extptr, extlen), | |
2033 Qterminal); | |
2034 else | |
2035 #endif /* 0 */ | |
2036 { | |
2037 extlen = len; | |
2038 extptr = (Extbyte *) str; | |
2039 } | |
1957 | 2040 |
2041 /* If not yet initialized, just skip it. */ | |
2042 if (alternate_do_string == NULL) | |
2043 return; | |
2044 | |
2045 if (alternate_do_pointer + extlen >= alternate_do_size) | |
2046 { | |
2047 alternate_do_size = | |
2048 max(alternate_do_size * 2, alternate_do_pointer + extlen + 1); | |
2049 XREALLOC_ARRAY (alternate_do_string, char, alternate_do_size); | |
2050 } | |
428 | 2051 memcpy (alternate_do_string + alternate_do_pointer, extptr, extlen); |
2052 alternate_do_pointer += extlen; | |
2053 alternate_do_string[alternate_do_pointer] = 0; | |
2054 } | |
2055 | |
1346 | 2056 |
2057 DEFUN ("set-device-clear-left-side", Fset_device_clear_left_side, 2, 2, 0, /* | |
2058 Set whether to output a newline before the next output to a stream device. | |
2059 This will happen only if the most recently-outputted character was not | |
2060 a newline -- i.e. it will make sure the left side is "clear" of text. | |
2061 */ | |
2062 (device, value)) | |
2063 { | |
2064 if (!NILP (device)) | |
2065 CHECK_LIVE_DEVICE (device); | |
2066 if (NILP (device) || DEVICE_STREAM_P (XDEVICE (device))) | |
2067 /* #### This should be per-device */ | |
2068 stdout_clear_before_next_output = !NILP (value); | |
2069 return Qnil; | |
2070 } | |
2071 | |
2072 DEFUN ("device-left-side-clear-p", Fdevice_left_side_clear_p, 0, 1, 0, /* | |
2073 For stream devices, true if the most recent-outputted character was a newline. | |
2074 */ | |
2075 (device)) | |
2076 { | |
2077 if (!NILP (device)) | |
2078 CHECK_LIVE_DEVICE (device); | |
2079 if (NILP (device) || DEVICE_STREAM_P (XDEVICE (device))) | |
2080 /* #### This should be per-device */ | |
2081 return stdout_needs_newline ? Qt : Qnil; | |
2082 return Qnil; | |
2083 } | |
2084 | |
428 | 2085 DEFUN ("external-debugging-output", Fexternal_debugging_output, 1, 3, 0, /* |
2086 Write CHAR-OR-STRING to stderr or stdout. | |
2087 If optional arg STDOUT-P is non-nil, write to stdout; otherwise, write | |
2088 to stderr. You can use this function to write directly to the terminal. | |
2089 This function can be used as the STREAM argument of Fprint() or the like. | |
2090 | |
442 | 2091 Under MS Windows, this writes output to the console window (which is |
2092 created, if necessary), unless XEmacs is being run noninteractively | |
2093 \(i.e. using the `-batch' argument). | |
2094 | |
428 | 2095 If you have opened a termscript file (using `open-termscript'), then |
2096 the output also will be logged to this file. | |
2097 */ | |
2098 (char_or_string, stdout_p, device)) | |
2099 { | |
2100 FILE *file = 0; | |
2101 struct console *con = 0; | |
2102 | |
2103 if (NILP (device)) | |
2104 { | |
2105 if (!NILP (stdout_p)) | |
2106 file = stdout; | |
2107 else | |
2108 file = stderr; | |
2109 } | |
2110 else | |
2111 { | |
2112 CHECK_LIVE_DEVICE (device); | |
2113 if (!DEVICE_TTY_P (XDEVICE (device)) && | |
2114 !DEVICE_STREAM_P (XDEVICE (device))) | |
563 | 2115 wtaerror ("Must be tty or stream device", device); |
428 | 2116 con = XCONSOLE (DEVICE_CONSOLE (XDEVICE (device))); |
2117 if (DEVICE_TTY_P (XDEVICE (device))) | |
2118 file = 0; | |
2119 else if (!NILP (stdout_p)) | |
2120 file = CONSOLE_STREAM_DATA (con)->out; | |
2121 else | |
2122 file = CONSOLE_STREAM_DATA (con)->err; | |
2123 } | |
2124 | |
2125 if (STRINGP (char_or_string)) | |
2126 write_string_to_stdio_stream (file, con, | |
2127 XSTRING_DATA (char_or_string), | |
771 | 2128 XSTRING_LENGTH (char_or_string), |
2129 print_unbuffered); | |
428 | 2130 else |
2131 { | |
867 | 2132 Ibyte str[MAX_ICHAR_LEN]; |
428 | 2133 Bytecount len; |
2134 | |
2135 CHECK_CHAR_COERCE_INT (char_or_string); | |
867 | 2136 len = set_itext_ichar (str, XCHAR (char_or_string)); |
771 | 2137 write_string_to_stdio_stream (file, con, str, len, print_unbuffered); |
428 | 2138 } |
2139 | |
2140 return char_or_string; | |
2141 } | |
2142 | |
2143 DEFUN ("open-termscript", Fopen_termscript, 1, 1, "FOpen termscript file: ", /* | |
444 | 2144 Start writing all terminal output to FILENAME as well as the terminal. |
2145 FILENAME = nil means just close any termscript file currently open. | |
428 | 2146 */ |
444 | 2147 (filename)) |
428 | 2148 { |
2149 /* This function can GC */ | |
2150 if (termscript != 0) | |
2151 { | |
771 | 2152 retry_fclose (termscript); |
444 | 2153 termscript = 0; |
2154 } | |
2155 | |
2156 if (! NILP (filename)) | |
2157 { | |
2158 filename = Fexpand_file_name (filename, Qnil); | |
771 | 2159 termscript = qxe_fopen (XSTRING_DATA (filename), "w"); |
428 | 2160 if (termscript == NULL) |
563 | 2161 report_file_error ("Opening termscript", filename); |
428 | 2162 } |
2163 return Qnil; | |
2164 } | |
2165 | |
440 | 2166 static int debug_print_length = 50; |
2167 static int debug_print_level = 15; | |
2168 static int debug_print_readably = -1; | |
428 | 2169 |
1957 | 2170 /* Restore values temporarily bound by debug_prin1. We use this approach to |
2171 avoid consing in debug_prin1. That is verboten, since debug_prin1 can be | |
2172 called by cons debugging code. */ | |
2173 static Lisp_Object | |
2286 | 2174 debug_prin1_exit (Lisp_Object UNUSED (ignored)) |
1957 | 2175 { |
2176 struct debug_bindings *bindings = | |
2177 (struct debug_bindings *) XOPAQUE (debug_prin1_bindings)->data; | |
2367 | 2178 inhibit_non_essential_conversion_operations = |
2179 bindings->inhibit_non_essential_conversion_operations; | |
1957 | 2180 print_depth = bindings->print_depth; |
2181 print_readably = bindings->print_readably; | |
2182 print_unbuffered = bindings->print_unbuffered; | |
2183 gc_currently_forbidden = bindings->gc_currently_forbidden; | |
2184 Vprint_length = bindings->Vprint_length; | |
2185 Vprint_level = bindings->Vprint_level; | |
2186 Vinhibit_quit = bindings->Vinhibit_quit; | |
2187 return Qnil; | |
2188 } | |
2189 | |
1346 | 2190 /* Print an object, `prin1'-style, to various possible debugging outputs. |
2191 Make sure it's completely unbuffered so that, in the event of a crash | |
2192 somewhere, we see as much as possible that happened before it. | |
2193 */ | |
428 | 2194 static void |
1346 | 2195 debug_prin1 (Lisp_Object debug_print_obj, int flags) |
428 | 2196 { |
2197 /* This function can GC */ | |
853 | 2198 |
2199 /* by doing this, we trick various things that are non-essential | |
2200 but might cause crashes into not getting executed. */ | |
1957 | 2201 int specdepth; |
2202 struct debug_bindings *bindings = | |
2203 (struct debug_bindings *) XOPAQUE (debug_prin1_bindings)->data; | |
853 | 2204 |
2367 | 2205 bindings->inhibit_non_essential_conversion_operations = |
2206 inhibit_non_essential_conversion_operations; | |
1957 | 2207 bindings->print_depth = print_depth; |
2208 bindings->print_readably = print_readably; | |
2209 bindings->print_unbuffered = print_unbuffered; | |
2210 bindings->gc_currently_forbidden = gc_currently_forbidden; | |
2211 bindings->Vprint_length = Vprint_length; | |
2212 bindings->Vprint_level = Vprint_level; | |
2213 bindings->Vinhibit_quit = Vinhibit_quit; | |
2214 specdepth = record_unwind_protect (debug_prin1_exit, Qnil); | |
2215 | |
2367 | 2216 inhibit_non_essential_conversion_operations = 1; |
1957 | 2217 print_depth = 0; |
2218 print_readably = debug_print_readably != -1 ? debug_print_readably : 0; | |
2219 print_unbuffered++; | |
428 | 2220 if (debug_print_length > 0) |
1957 | 2221 Vprint_length = make_int (debug_print_length); |
428 | 2222 if (debug_print_level > 0) |
1957 | 2223 Vprint_level = make_int (debug_print_level); |
2224 Vinhibit_quit = Qt; | |
1346 | 2225 |
2226 if ((flags & EXT_PRINT_STDOUT) || (flags & EXT_PRINT_STDERR)) | |
2227 print_internal (debug_print_obj, Qexternal_debugging_output, 1); | |
2228 if (flags & EXT_PRINT_ALTERNATE) | |
2229 print_internal (debug_print_obj, Qalternate_debugging_output, 1); | |
442 | 2230 #ifdef WIN32_NATIVE |
1346 | 2231 if (flags & EXT_PRINT_MSWINDOWS) |
2232 { | |
2233 /* Write out to the debugger, as well */ | |
2234 print_internal (debug_print_obj, Qmswindows_debugging_output, 1); | |
2235 } | |
442 | 2236 #endif |
440 | 2237 |
802 | 2238 unbind_to (specdepth); |
428 | 2239 } |
2240 | |
2241 void | |
1204 | 2242 debug_p4 (Lisp_Object obj) |
2243 { | |
2367 | 2244 inhibit_non_essential_conversion_operations = 1; |
1204 | 2245 if (STRINGP (obj)) |
2246 debug_out ("\"%s\"", XSTRING_DATA (obj)); | |
2247 else if (CONSP (obj)) | |
2248 { | |
2249 int first = 1; | |
2250 do { | |
2251 debug_out (first ? "(" : " "); | |
2252 first = 0; | |
2253 debug_p4 (XCAR (obj)); | |
2254 obj = XCDR (obj); | |
2255 } while (CONSP (obj)); | |
2256 if (NILP (obj)) | |
2257 debug_out (")"); | |
2258 else | |
2259 { | |
2260 debug_out (" . "); | |
2261 debug_p4 (obj); | |
2262 debug_out (")"); | |
2263 } | |
2264 } | |
2265 else if (VECTORP (obj)) | |
2266 { | |
2267 int size = XVECTOR_LENGTH (obj); | |
2268 int i; | |
2269 int first = 1; | |
2270 | |
2271 for (i = 0; i < size; i++) | |
2272 { | |
2273 debug_out (first ? "[" : " "); | |
2274 first = 0; | |
2275 debug_p4 (XVECTOR_DATA (obj)[i]); | |
2276 debug_out ("]"); | |
2277 } | |
2278 } | |
2279 else if (SYMBOLP (obj)) | |
2280 { | |
2281 Lisp_Object name = XSYMBOL_NAME (obj); | |
2282 if (!STRINGP (name)) | |
2283 debug_out ("<<bad symbol>>"); | |
2284 else | |
2285 debug_out ("%s", XSTRING_DATA (name)); | |
2286 } | |
2287 else if (INTP (obj)) | |
2288 { | |
2289 debug_out ("%ld", XINT (obj)); | |
2290 } | |
2291 else if (FLOATP (obj)) | |
2292 { | |
2293 debug_out ("%g", XFLOAT_DATA (obj)); | |
2294 } | |
2295 else | |
2296 { | |
2297 struct lrecord_header *header = | |
2298 (struct lrecord_header *) XPNTR (obj); | |
2299 | |
2300 if (header->type >= lrecord_type_last_built_in_type) | |
2301 debug_out ("<< bad object type=%d 0x%lx>>", header->type, | |
2302 (EMACS_INT) header); | |
2303 else | |
3263 | 2304 #ifdef NEW_GC |
3063 | 2305 debug_out ("#<%s addr=0x%lx uid=0x%lx>", |
2720 | 2306 LHEADER_IMPLEMENTATION (header)->name, |
3063 | 2307 (EMACS_INT) header, |
2720 | 2308 (EMACS_INT) ((struct lrecord_header *) header)->uid); |
3263 | 2309 #else /* not NEW_GC */ |
3063 | 2310 debug_out ("#<%s addr=0x%lx uid=0x%lx>", |
1204 | 2311 LHEADER_IMPLEMENTATION (header)->name, |
3063 | 2312 (EMACS_INT) header, |
3092 | 2313 (EMACS_INT) (LHEADER_IMPLEMENTATION (header)->basic_p ? |
2314 ((struct lrecord_header *) header)->uid : | |
2315 ((struct old_lcrecord_header *) header)->uid)); | |
3263 | 2316 #endif /* not NEW_GC */ |
1204 | 2317 } |
2318 | |
2367 | 2319 inhibit_non_essential_conversion_operations = 0; |
1204 | 2320 } |
2321 | |
1346 | 2322 static void |
2323 ext_print_begin (int dest) | |
2324 { | |
2325 if (dest & EXT_PRINT_ALTERNATE) | |
2326 alternate_do_pointer = 0; | |
2327 if (dest & (EXT_PRINT_STDERR | EXT_PRINT_STDOUT)) | |
2328 stdout_clear_before_next_output = 1; | |
2329 } | |
2330 | |
2331 static void | |
2332 ext_print_end (int dest) | |
2333 { | |
2334 if (dest & (EXT_PRINT_MSWINDOWS | EXT_PRINT_STDERR | EXT_PRINT_STDOUT)) | |
2335 external_out (dest & (EXT_PRINT_MSWINDOWS | EXT_PRINT_STDERR | | |
2336 EXT_PRINT_STDOUT), "\n"); | |
2337 } | |
2338 | |
2339 static void | |
2340 external_debug_print (Lisp_Object object, int dest) | |
2341 { | |
2342 ext_print_begin (dest); | |
2343 debug_prin1 (object, dest); | |
2344 ext_print_end (dest); | |
2345 } | |
2346 | |
1204 | 2347 void |
2348 debug_p3 (Lisp_Object obj) | |
2349 { | |
2350 debug_p4 (obj); | |
2367 | 2351 inhibit_non_essential_conversion_operations = 1; |
1204 | 2352 debug_out ("\n"); |
2367 | 2353 inhibit_non_essential_conversion_operations = 0; |
1204 | 2354 } |
2355 | |
2356 void | |
428 | 2357 debug_print (Lisp_Object debug_print_obj) |
2358 { | |
1346 | 2359 external_debug_print (debug_print_obj, EXT_PRINT_ALL); |
428 | 2360 } |
2361 | |
1204 | 2362 /* Getting tired of typing debug_print() ... */ |
2363 void dp (Lisp_Object debug_print_obj); | |
2364 void | |
2365 dp (Lisp_Object debug_print_obj) | |
2366 { | |
2367 debug_print (debug_print_obj); | |
2368 } | |
2369 | |
1346 | 2370 /* Alternate debug printer: Return a char * pointer to the output */ |
2371 char *dpa (Lisp_Object debug_print_obj); | |
2372 char * | |
2373 dpa (Lisp_Object debug_print_obj) | |
2374 { | |
2375 external_debug_print (debug_print_obj, EXT_PRINT_ALTERNATE); | |
2376 | |
2377 return alternate_do_string; | |
2378 } | |
2379 | |
428 | 2380 /* Debugging kludge -- unbuffered */ |
2381 /* This function provided for the benefit of the debugger. */ | |
2382 void | |
2383 debug_backtrace (void) | |
2384 { | |
2385 /* This function can GC */ | |
853 | 2386 |
2387 /* by doing this, we trick various things that are non-essential | |
2388 but might cause crashes into not getting executed. */ | |
2389 int specdepth = | |
2367 | 2390 internal_bind_int (&inhibit_non_essential_conversion_operations, 1); |
853 | 2391 |
2392 internal_bind_int (&print_depth, 0); | |
802 | 2393 internal_bind_int (&print_readably, 0); |
2394 internal_bind_int (&print_unbuffered, print_unbuffered + 1); | |
428 | 2395 if (debug_print_length > 0) |
802 | 2396 internal_bind_lisp_object (&Vprint_length, make_int (debug_print_length)); |
428 | 2397 if (debug_print_level > 0) |
802 | 2398 internal_bind_lisp_object (&Vprint_level, make_int (debug_print_level)); |
2399 /* #### Do we need this? It was in the old code. */ | |
2400 internal_bind_lisp_object (&Vinhibit_quit, Vinhibit_quit); | |
428 | 2401 |
2402 Fbacktrace (Qexternal_debugging_output, Qt); | |
2403 stderr_out ("\n"); | |
2404 | |
802 | 2405 unbind_to (specdepth); |
428 | 2406 } |
2407 | |
1204 | 2408 /* Getting tired of typing debug_backtrace() ... */ |
2409 void db (void); | |
2410 void | |
2411 db (void) | |
2412 { | |
2413 debug_backtrace (); | |
2414 } | |
2415 | |
428 | 2416 void |
2417 debug_short_backtrace (int length) | |
2418 { | |
2419 int first = 1; | |
2420 struct backtrace *bt = backtrace_list; | |
771 | 2421 debug_out (" ["); |
428 | 2422 while (length > 0 && bt) |
2423 { | |
2424 if (!first) | |
2425 { | |
771 | 2426 debug_out (", "); |
428 | 2427 } |
2428 if (COMPILED_FUNCTIONP (*bt->function)) | |
2429 { | |
1346 | 2430 #if defined (COMPILED_FUNCTION_ANNOTATION_HACK) |
428 | 2431 Lisp_Object ann = |
2432 compiled_function_annotation (XCOMPILED_FUNCTION (*bt->function)); | |
2433 #else | |
2434 Lisp_Object ann = Qnil; | |
2435 #endif | |
2436 if (!NILP (ann)) | |
2437 { | |
771 | 2438 debug_out ("<compiled-function from "); |
1346 | 2439 debug_prin1 (ann, EXT_PRINT_ALL); |
771 | 2440 debug_out (">"); |
428 | 2441 } |
2442 else | |
2443 { | |
771 | 2444 debug_out ("<compiled-function of unknown origin>"); |
428 | 2445 } |
2446 } | |
2447 else | |
1346 | 2448 debug_prin1 (*bt->function, EXT_PRINT_ALL); |
428 | 2449 first = 0; |
2450 length--; | |
2451 bt = bt->next; | |
2452 } | |
771 | 2453 debug_out ("]\n"); |
428 | 2454 } |
2455 | |
2456 | |
2457 void | |
2458 syms_of_print (void) | |
2459 { | |
563 | 2460 DEFSYMBOL (Qstandard_output); |
428 | 2461 |
563 | 2462 DEFSYMBOL (Qprint_length); |
428 | 2463 |
563 | 2464 DEFSYMBOL (Qprint_string_length); |
428 | 2465 |
563 | 2466 DEFSYMBOL (Qdisplay_error); |
2467 DEFSYMBOL (Qprint_message_label); | |
428 | 2468 |
2469 DEFSUBR (Fprin1); | |
2470 DEFSUBR (Fprin1_to_string); | |
2471 DEFSUBR (Fprinc); | |
2472 DEFSUBR (Fprint); | |
2473 DEFSUBR (Ferror_message_string); | |
2474 DEFSUBR (Fdisplay_error); | |
2475 DEFSUBR (Fterpri); | |
2476 DEFSUBR (Fwrite_char); | |
2477 DEFSUBR (Falternate_debugging_output); | |
1346 | 2478 DEFSUBR (Fset_device_clear_left_side); |
2479 DEFSUBR (Fdevice_left_side_clear_p); | |
428 | 2480 DEFSUBR (Fexternal_debugging_output); |
2481 DEFSUBR (Fopen_termscript); | |
563 | 2482 DEFSYMBOL (Qexternal_debugging_output); |
2483 DEFSYMBOL (Qalternate_debugging_output); | |
442 | 2484 #ifdef HAVE_MS_WINDOWS |
563 | 2485 DEFSYMBOL (Qmswindows_debugging_output); |
442 | 2486 #endif |
428 | 2487 DEFSUBR (Fwith_output_to_temp_buffer); |
2488 } | |
2489 | |
2490 void | |
2491 reinit_vars_of_print (void) | |
2492 { | |
2493 alternate_do_pointer = 0; | |
2494 } | |
2495 | |
2496 void | |
2497 vars_of_print (void) | |
2498 { | |
2499 DEFVAR_LISP ("standard-output", &Vstandard_output /* | |
2500 Output stream `print' uses by default for outputting a character. | |
2501 This may be any function of one argument. | |
2502 It may also be a buffer (output is inserted before point) | |
2503 or a marker (output is inserted and the marker is advanced) | |
2504 or the symbol t (output appears in the minibuffer line). | |
2505 */ ); | |
2506 Vstandard_output = Qt; | |
2507 | |
2508 DEFVAR_LISP ("float-output-format", &Vfloat_output_format /* | |
2509 The format descriptor string that lisp uses to print floats. | |
2510 This is a %-spec like those accepted by `printf' in C, | |
2511 but with some restrictions. It must start with the two characters `%.'. | |
2512 After that comes an integer precision specification, | |
2513 and then a letter which controls the format. | |
2514 The letters allowed are `e', `f' and `g'. | |
2515 Use `e' for exponential notation "DIG.DIGITSeEXPT" | |
2516 Use `f' for decimal point notation "DIGITS.DIGITS". | |
2517 Use `g' to choose the shorter of those two formats for the number at hand. | |
2518 The precision in any of these cases is the number of digits following | |
2519 the decimal point. With `f', a precision of 0 means to omit the | |
2520 decimal point. 0 is not allowed with `f' or `g'. | |
2521 | |
2522 A value of nil means to use `%.16g'. | |
2523 | |
2524 Regardless of the value of `float-output-format', a floating point number | |
2525 will never be printed in such a way that it is ambiguous with an integer; | |
2526 that is, a floating-point number will always be printed with a decimal | |
2527 point and/or an exponent, even if the digits following the decimal point | |
2528 are all zero. This is to preserve read-equivalence. | |
2529 */ ); | |
2530 Vfloat_output_format = Qnil; | |
2531 | |
2532 DEFVAR_LISP ("print-length", &Vprint_length /* | |
2533 Maximum length of list or vector to print before abbreviating. | |
2534 A value of nil means no limit. | |
2535 */ ); | |
2536 Vprint_length = Qnil; | |
2537 | |
2538 DEFVAR_LISP ("print-string-length", &Vprint_string_length /* | |
2539 Maximum length of string to print before abbreviating. | |
2540 A value of nil means no limit. | |
2541 */ ); | |
2542 Vprint_string_length = Qnil; | |
2543 | |
2544 DEFVAR_LISP ("print-level", &Vprint_level /* | |
2545 Maximum depth of list nesting to print before abbreviating. | |
2546 A value of nil means no limit. | |
2547 */ ); | |
2548 Vprint_level = Qnil; | |
2549 | |
2550 DEFVAR_BOOL ("print-escape-newlines", &print_escape_newlines /* | |
2551 Non-nil means print newlines in strings as backslash-n. | |
2552 */ ); | |
2553 print_escape_newlines = 0; | |
2554 | |
2555 DEFVAR_BOOL ("print-readably", &print_readably /* | |
2556 If non-nil, then all objects will be printed in a readable form. | |
2557 If an object has no readable representation, then an error is signalled. | |
2558 When print-readably is true, compiled-function objects will be written in | |
2559 #[...] form instead of in #<compiled-function [...]> form, and two-element | |
2560 lists of the form (quote object) will be written as the equivalent 'object. | |
2561 Do not SET this variable; bind it instead. | |
2562 */ ); | |
2563 print_readably = 0; | |
2564 | |
2565 /* #### I think this should default to t. But we'd better wait | |
2566 until we see that it works out. */ | |
2567 DEFVAR_LISP ("print-gensym", &Vprint_gensym /* | |
2568 If non-nil, then uninterned symbols will be printed specially. | |
2569 Uninterned symbols are those which are not present in `obarray', that is, | |
2570 those which were made with `make-symbol' or by calling `intern' with a | |
2571 second argument. | |
2572 | |
2573 When print-gensym is true, such symbols will be preceded by "#:", | |
2574 which causes the reader to create a new symbol instead of interning | |
2575 and returning an existing one. Beware: the #: syntax creates a new | |
2576 symbol each time it is seen, so if you print an object which contains | |
2577 two pointers to the same uninterned symbol, `read' will not duplicate | |
2578 that structure. | |
2579 | |
2580 If the value of `print-gensym' is a cons cell, then in addition | |
2581 refrain from clearing `print-gensym-alist' on entry to and exit from | |
2582 printing functions, so that the use of #...# and #...= can carry over | |
2583 for several separately printed objects. | |
2584 */ ); | |
2585 Vprint_gensym = Qnil; | |
2586 | |
2587 DEFVAR_LISP ("print-gensym-alist", &Vprint_gensym_alist /* | |
2588 Association list of elements (GENSYM . N) to guide use of #N# and #N=. | |
2589 In each element, GENSYM is an uninterned symbol that has been associated | |
2590 with #N= for the specified value of N. | |
2591 */ ); | |
2592 Vprint_gensym_alist = Qnil; | |
2593 | |
2594 DEFVAR_LISP ("print-message-label", &Vprint_message_label /* | |
2595 Label for minibuffer messages created with `print'. This should | |
2596 generally be bound with `let' rather than set. (See `display-message'.) | |
2597 */ ); | |
2598 Vprint_message_label = Qprint; | |
1957 | 2599 |
2600 debug_prin1_bindings = | |
2601 make_opaque (OPAQUE_UNINIT, sizeof (struct debug_bindings)); | |
2602 staticpro (&debug_prin1_bindings); | |
2603 | |
2604 alternate_do_size = 5000; | |
2605 alternate_do_string = xnew_array(char, 5000); | |
428 | 2606 } |