1 /* Lisp object printing and output streams.
2 Copyright (C) 1985, 1986, 1988, 1993, 1994 Free Software Foundation, Inc.
4 This file is part of GNU Emacs.
6 GNU Emacs is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2, or (at your option)
11 GNU Emacs is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GNU Emacs; see the file COPYING. If not, write to
18 the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */
31 #include "dispextern.h"
33 #endif /* not standalone */
35 #ifdef USE_TEXT_PROPERTIES
36 #include "intervals.h"
39 Lisp_Object Vstandard_output
, Qstandard_output
;
41 #ifdef LISP_FLOAT_TYPE
42 Lisp_Object Vfloat_output_format
, Qfloat_output_format
;
43 #endif /* LISP_FLOAT_TYPE */
45 /* Avoid actual stack overflow in print. */
48 /* Detect most circularities to print finite output. */
49 #define PRINT_CIRCLE 200
50 Lisp_Object being_printed
[PRINT_CIRCLE
];
52 /* Maximum length of list to print in full; noninteger means
53 effectively infinity */
55 Lisp_Object Vprint_length
;
57 /* Maximum depth of list to print in full; noninteger means
58 effectively infinity. */
60 Lisp_Object Vprint_level
;
62 /* Nonzero means print newlines in strings as \n. */
64 int print_escape_newlines
;
66 Lisp_Object Qprint_escape_newlines
;
68 /* Nonzero means print newline before next minibuffer message.
71 extern int noninteractive_need_newline
;
72 #ifdef MAX_PRINT_CHARS
73 static int print_chars
;
75 #endif /* MAX_PRINT_CHARS */
77 void print_interval ();
80 /* Convert between chars and GLYPHs */
84 register GLYPH
*glyphs
;
94 str_to_glyph_cpy (str
, glyphs
)
98 register GLYPH
*gp
= glyphs
;
99 register char *cp
= str
;
106 str_to_glyph_ncpy (str
, glyphs
, n
)
111 register GLYPH
*gp
= glyphs
;
112 register char *cp
= str
;
119 glyph_to_str_cpy (glyphs
, str
)
123 register GLYPH
*gp
= glyphs
;
124 register char *cp
= str
;
127 *str
++ = *gp
++ & 0377;
131 /* Low level output routines for characters and strings */
133 /* Lisp functions to do output using a stream
134 must have the stream in a variable called printcharfun
135 and must start with PRINTPREPARE and end with PRINTFINISH.
136 Use PRINTCHAR to output one character,
137 or call strout to output a block of characters.
138 Also, each one must have the declarations
139 struct buffer *old = current_buffer;
140 int old_point = -1, start_point;
141 Lisp_Object original;
144 #define PRINTPREPARE \
145 original = printcharfun; \
146 if (NILP (printcharfun)) printcharfun = Qt; \
147 if (XTYPE (printcharfun) == Lisp_Buffer) \
148 { if (XBUFFER (printcharfun) != current_buffer) \
149 Fset_buffer (printcharfun); \
150 printcharfun = Qnil;} \
151 if (XTYPE (printcharfun) == Lisp_Marker) \
152 { if (!(XMARKER (original)->buffer)) \
153 error ("Marker does not point anywhere"); \
154 if (XMARKER (original)->buffer != current_buffer) \
155 set_buffer_internal (XMARKER (original)->buffer); \
157 SET_PT (marker_position (printcharfun)); \
158 start_point = point; \
159 printcharfun = Qnil;}
161 #define PRINTFINISH \
162 if (XTYPE (original) == Lisp_Marker) \
163 Fset_marker (original, make_number (point), Qnil); \
164 if (old_point >= 0) \
165 SET_PT (old_point + (old_point >= start_point \
166 ? point - start_point : 0)); \
167 if (old != current_buffer) \
168 set_buffer_internal (old)
170 #define PRINTCHAR(ch) printchar (ch, printcharfun)
172 /* Index of first unused element of FRAME_MESSAGE_BUF(mini_frame). */
173 static int printbufidx
;
182 #ifdef MAX_PRINT_CHARS
185 #endif /* MAX_PRINT_CHARS */
196 struct frame
*mini_frame
197 = XFRAME (WINDOW_FRAME (XWINDOW (minibuf_window
)));
202 noninteractive_need_newline
= 1;
206 if (echo_area_glyphs
!= FRAME_MESSAGE_BUF (mini_frame
)
207 || !message_buf_print
)
209 echo_area_glyphs
= FRAME_MESSAGE_BUF (mini_frame
);
211 echo_area_glyphs_length
= 0;
212 message_buf_print
= 1;
215 if (printbufidx
< FRAME_WIDTH (mini_frame
) - 1)
216 FRAME_MESSAGE_BUF (mini_frame
)[printbufidx
++] = ch
;
217 FRAME_MESSAGE_BUF (mini_frame
)[printbufidx
] = 0;
218 echo_area_glyphs_length
= printbufidx
;
222 #endif /* not standalone */
229 strout (ptr
, size
, printcharfun
)
232 Lisp_Object printcharfun
;
236 if (EQ (printcharfun
, Qnil
))
238 insert (ptr
, size
>= 0 ? size
: strlen (ptr
));
239 #ifdef MAX_PRINT_CHARS
241 print_chars
+= size
>= 0 ? size
: strlen(ptr
);
242 #endif /* MAX_PRINT_CHARS */
245 if (EQ (printcharfun
, Qt
))
247 struct frame
*mini_frame
248 = XFRAME (WINDOW_FRAME (XWINDOW (minibuf_window
)));
250 i
= size
>= 0 ? size
: strlen (ptr
);
251 #ifdef MAX_PRINT_CHARS
254 #endif /* MAX_PRINT_CHARS */
258 fwrite (ptr
, 1, i
, stdout
);
259 noninteractive_need_newline
= 1;
263 if (echo_area_glyphs
!= FRAME_MESSAGE_BUF (mini_frame
)
264 || !message_buf_print
)
266 echo_area_glyphs
= FRAME_MESSAGE_BUF (mini_frame
);
268 echo_area_glyphs_length
= 0;
269 message_buf_print
= 1;
272 if (i
> FRAME_WIDTH (mini_frame
) - printbufidx
- 1)
273 i
= FRAME_WIDTH (mini_frame
) - printbufidx
- 1;
274 bcopy (ptr
, &FRAME_MESSAGE_BUF (mini_frame
) [printbufidx
], i
);
276 echo_area_glyphs_length
= printbufidx
;
277 FRAME_MESSAGE_BUF (mini_frame
) [printbufidx
] = 0;
284 PRINTCHAR (ptr
[i
++]);
287 PRINTCHAR (ptr
[i
++]);
290 /* Print the contents of a string STRING using PRINTCHARFUN.
291 It isn't safe to use strout, because printing one char can relocate. */
293 print_string (string
, printcharfun
)
295 Lisp_Object printcharfun
;
297 if (EQ (printcharfun
, Qnil
) || EQ (printcharfun
, Qt
))
298 /* In predictable cases, strout is safe: output to buffer or frame. */
299 strout (XSTRING (string
)->data
, XSTRING (string
)->size
, printcharfun
);
302 /* Otherwise, fetch the string address for each character. */
304 int size
= XSTRING (string
)->size
;
307 for (i
= 0; i
< size
; i
++)
308 PRINTCHAR (XSTRING (string
)->data
[i
]);
313 DEFUN ("write-char", Fwrite_char
, Swrite_char
, 1, 2, 0,
314 "Output character CHAR to stream STREAM.\n\
315 STREAM defaults to the value of `standard-output' (which see).")
317 Lisp_Object ch
, printcharfun
;
319 struct buffer
*old
= current_buffer
;
322 Lisp_Object original
;
324 if (NILP (printcharfun
))
325 printcharfun
= Vstandard_output
;
326 CHECK_NUMBER (ch
, 0);
328 PRINTCHAR (XINT (ch
));
333 /* Used from outside of print.c to print a block of SIZE chars at DATA
334 on the default output stream.
335 Do not use this on the contents of a Lisp string. */
337 write_string (data
, size
)
341 struct buffer
*old
= current_buffer
;
342 Lisp_Object printcharfun
;
345 Lisp_Object original
;
347 printcharfun
= Vstandard_output
;
350 strout (data
, size
, printcharfun
);
354 /* Used from outside of print.c to print a block of SIZE chars at DATA
355 on a specified stream PRINTCHARFUN.
356 Do not use this on the contents of a Lisp string. */
358 write_string_1 (data
, size
, printcharfun
)
361 Lisp_Object printcharfun
;
363 struct buffer
*old
= current_buffer
;
366 Lisp_Object original
;
369 strout (data
, size
, printcharfun
);
377 temp_output_buffer_setup (bufname
)
380 register struct buffer
*old
= current_buffer
;
381 register Lisp_Object buf
;
383 Fset_buffer (Fget_buffer_create (build_string (bufname
)));
385 current_buffer
->read_only
= Qnil
;
388 XSET (buf
, Lisp_Buffer
, current_buffer
);
389 specbind (Qstandard_output
, buf
);
391 set_buffer_internal (old
);
395 internal_with_output_to_temp_buffer (bufname
, function
, args
)
397 Lisp_Object (*function
) ();
400 int count
= specpdl_ptr
- specpdl
;
401 Lisp_Object buf
, val
;
403 record_unwind_protect (Fset_buffer
, Fcurrent_buffer ());
404 temp_output_buffer_setup (bufname
);
405 buf
= Vstandard_output
;
407 val
= (*function
) (args
);
409 temp_output_buffer_show (buf
);
411 return unbind_to (count
, val
);
414 DEFUN ("with-output-to-temp-buffer", Fwith_output_to_temp_buffer
, Swith_output_to_temp_buffer
,
416 "Bind `standard-output' to buffer BUFNAME, eval BODY, then show that buffer.\n\
417 The buffer is cleared out initially, and marked as unmodified when done.\n\
418 All output done by BODY is inserted in that buffer by default.\n\
419 The buffer is displayed in another window, but not selected.\n\
420 The value of the last form in BODY is returned.\n\
421 If BODY does not finish normally, the buffer BUFNAME is not displayed.\n\n\
422 If variable `temp-buffer-show-function' is non-nil, call it at the end\n\
423 to get the buffer displayed. It gets one argument, the buffer to display.")
429 int count
= specpdl_ptr
- specpdl
;
430 Lisp_Object buf
, val
;
433 name
= Feval (Fcar (args
));
436 CHECK_STRING (name
, 0);
437 temp_output_buffer_setup (XSTRING (name
)->data
);
438 buf
= Vstandard_output
;
440 val
= Fprogn (Fcdr (args
));
442 temp_output_buffer_show (buf
);
444 return unbind_to (count
, val
);
446 #endif /* not standalone */
448 static void print ();
450 DEFUN ("terpri", Fterpri
, Sterpri
, 0, 1, 0,
451 "Output a newline to STREAM.\n\
452 If STREAM is omitted or nil, the value of `standard-output' is used.")
454 Lisp_Object printcharfun
;
456 struct buffer
*old
= current_buffer
;
459 Lisp_Object original
;
461 if (NILP (printcharfun
))
462 printcharfun
= Vstandard_output
;
469 DEFUN ("prin1", Fprin1
, Sprin1
, 1, 2, 0,
470 "Output the printed representation of OBJECT, any Lisp object.\n\
471 Quoting characters are printed when needed to make output that `read'\n\
472 can handle, whenever this is possible.\n\
473 Output stream is STREAM, or value of `standard-output' (which see).")
475 Lisp_Object obj
, printcharfun
;
477 struct buffer
*old
= current_buffer
;
480 Lisp_Object original
;
482 #ifdef MAX_PRINT_CHARS
484 #endif /* MAX_PRINT_CHARS */
485 if (NILP (printcharfun
))
486 printcharfun
= Vstandard_output
;
489 print (obj
, printcharfun
, 1);
494 /* a buffer which is used to hold output being built by prin1-to-string */
495 Lisp_Object Vprin1_to_string_buffer
;
497 DEFUN ("prin1-to-string", Fprin1_to_string
, Sprin1_to_string
, 1, 2, 0,
498 "Return a string containing the printed representation of OBJECT,\n\
499 any Lisp object. Quoting characters are used when needed to make output\n\
500 that `read' can handle, whenever this is possible, unless the optional\n\
501 second argument NOESCAPE is non-nil.")
503 Lisp_Object obj
, noescape
;
505 struct buffer
*old
= current_buffer
;
508 Lisp_Object original
, printcharfun
;
511 printcharfun
= Vprin1_to_string_buffer
;
514 print (obj
, printcharfun
, NILP (noescape
));
515 /* Make Vprin1_to_string_buffer be the default buffer after PRINTFINSH */
517 set_buffer_internal (XBUFFER (Vprin1_to_string_buffer
));
518 obj
= Fbuffer_string ();
522 set_buffer_internal (old
);
528 DEFUN ("princ", Fprinc
, Sprinc
, 1, 2, 0,
529 "Output the printed representation of OBJECT, any Lisp object.\n\
530 No quoting characters are used; no delimiters are printed around\n\
531 the contents of strings.\n\
532 Output stream is STREAM, or value of standard-output (which see).")
534 Lisp_Object obj
, printcharfun
;
536 struct buffer
*old
= current_buffer
;
539 Lisp_Object original
;
541 if (NILP (printcharfun
))
542 printcharfun
= Vstandard_output
;
545 print (obj
, printcharfun
, 0);
550 DEFUN ("print", Fprint
, Sprint
, 1, 2, 0,
551 "Output the printed representation of OBJECT, with newlines around it.\n\
552 Quoting characters are printed when needed to make output that `read'\n\
553 can handle, whenever this is possible.\n\
554 Output stream is STREAM, or value of `standard-output' (which see).")
556 Lisp_Object obj
, printcharfun
;
558 struct buffer
*old
= current_buffer
;
561 Lisp_Object original
;
564 #ifdef MAX_PRINT_CHARS
566 max_print
= MAX_PRINT_CHARS
;
567 #endif /* MAX_PRINT_CHARS */
568 if (NILP (printcharfun
))
569 printcharfun
= Vstandard_output
;
574 print (obj
, printcharfun
, 1);
577 #ifdef MAX_PRINT_CHARS
580 #endif /* MAX_PRINT_CHARS */
585 /* The subroutine object for external-debugging-output is kept here
586 for the convenience of the debugger. */
587 Lisp_Object Qexternal_debugging_output
;
589 DEFUN ("external-debugging-output", Fexternal_debugging_output
, Sexternal_debugging_output
, 1, 1, 0,
590 "Write CHARACTER to stderr.\n\
591 You can call print while debugging emacs, and pass it this function\n\
592 to make it write to the debugging output.\n")
594 Lisp_Object character
;
596 CHECK_NUMBER (character
, 0);
597 putc (XINT (character
), stderr
);
602 #ifdef LISP_FLOAT_TYPE
605 * The buffer should be at least as large as the max string size of the
606 * largest float, printed in the biggest notation. This is undoubtably
607 * 20d float_output_format, with the negative of the C-constant "HUGE"
610 * On the vax the worst case is -1e38 in 20d format which takes 61 bytes.
612 * I assume that IEEE-754 format numbers can take 329 bytes for the worst
613 * case of -1e307 in 20d float_output_format. What is one to do (short of
614 * re-writing _doprnt to be more sane)?
619 float_to_string (buf
, data
)
626 if (NILP (Vfloat_output_format
)
627 || XTYPE (Vfloat_output_format
) != Lisp_String
)
630 sprintf (buf
, "%.17g", data
);
635 /* Check that the spec we have is fully valid.
636 This means not only valid for printf,
637 but meant for floats, and reasonable. */
638 cp
= XSTRING (Vfloat_output_format
)->data
;
647 /* Check the width specification. */
649 if ('0' <= *cp
&& *cp
<= '9')
650 for (width
= 0; (*cp
>= '0' && *cp
<= '9'); cp
++)
651 width
= (width
* 10) + (*cp
- '0');
653 if (*cp
!= 'e' && *cp
!= 'f' && *cp
!= 'g')
656 /* A precision of zero is valid for %f; everything else requires
657 at least one. Width may be omitted anywhere. */
659 && (width
< (*cp
!= 'f')
666 sprintf (buf
, XSTRING (Vfloat_output_format
)->data
, data
);
669 /* Make sure there is a decimal point with digit after, or an
670 exponent, so that the value is readable as a float. But don't do
671 this with "%.0f"; it's valid for that not to produce a decimal
672 point. Note that width can be 0 only for %.0f. */
675 for (cp
= buf
; *cp
; cp
++)
676 if ((*cp
< '0' || *cp
> '9') && *cp
!= '-')
679 if (*cp
== '.' && cp
[1] == 0)
693 #endif /* LISP_FLOAT_TYPE */
696 print (obj
, printcharfun
, escapeflag
)
698 register Lisp_Object printcharfun
;
705 #if 1 /* I'm not sure this is really worth doing. */
706 /* Detect circularities and truncate them.
707 No need to offer any alternative--this is better than an error. */
708 if (XTYPE (obj
) == Lisp_Cons
|| XTYPE (obj
) == Lisp_Vector
709 || XTYPE (obj
) == Lisp_Compiled
)
712 for (i
= 0; i
< print_depth
; i
++)
713 if (EQ (obj
, being_printed
[i
]))
715 sprintf (buf
, "#%d", i
);
716 strout (buf
, -1, printcharfun
);
722 being_printed
[print_depth
] = obj
;
725 if (print_depth
> PRINT_CIRCLE
)
726 error ("Apparently circular structure being printed");
727 #ifdef MAX_PRINT_CHARS
728 if (max_print
&& print_chars
> max_print
)
733 #endif /* MAX_PRINT_CHARS */
735 #ifdef SWITCH_ENUM_BUG
736 switch ((int) XTYPE (obj
))
742 /* We're in trouble if this happens!
743 Probably should just abort () */
744 strout ("#<EMACS BUG: INVALID DATATYPE ", -1, printcharfun
);
745 sprintf (buf
, "(#o%3o)", (int) XTYPE (obj
));
746 strout (buf
, -1, printcharfun
);
747 strout (" Save your buffers immediately and please report this bug>",
751 #ifdef LISP_FLOAT_TYPE
754 char pigbuf
[350]; /* see comments in float_to_string */
756 float_to_string (pigbuf
, XFLOAT(obj
)->data
);
757 strout (pigbuf
, -1, printcharfun
);
760 #endif /* LISP_FLOAT_TYPE */
763 sprintf (buf
, "%d", XINT (obj
));
764 strout (buf
, -1, printcharfun
);
769 print_string (obj
, printcharfun
);
773 register unsigned char c
;
778 #ifdef USE_TEXT_PROPERTIES
779 if (!NULL_INTERVAL_P (XSTRING (obj
)->intervals
))
787 for (i
= 0; i
< XSTRING (obj
)->size
; i
++)
790 c
= XSTRING (obj
)->data
[i
];
791 if (c
== '\n' && print_escape_newlines
)
796 else if (c
== '\f' && print_escape_newlines
)
803 if (c
== '\"' || c
== '\\')
810 #ifdef USE_TEXT_PROPERTIES
811 if (!NULL_INTERVAL_P (XSTRING (obj
)->intervals
))
813 traverse_intervals (XSTRING (obj
)->intervals
,
814 0, 0, print_interval
, printcharfun
);
825 register int confusing
;
826 register unsigned char *p
= XSYMBOL (obj
)->name
->data
;
827 register unsigned char *end
= p
+ XSYMBOL (obj
)->name
->size
;
828 register unsigned char c
;
830 if (p
!= end
&& (*p
== '-' || *p
== '+')) p
++;
835 while (p
!= end
&& *p
>= '0' && *p
<= '9')
837 confusing
= (end
== p
);
840 p
= XSYMBOL (obj
)->name
->data
;
847 if (c
== '\"' || c
== '\\' || c
== '\'' || c
== ';' || c
== '#' ||
848 c
== '(' || c
== ')' || c
== ',' || c
=='.' || c
== '`' ||
849 c
== '[' || c
== ']' || c
== '?' || c
<= 040 || confusing
)
850 PRINTCHAR ('\\'), confusing
= 0;
858 /* If deeper than spec'd depth, print placeholder. */
859 if (XTYPE (Vprint_level
) == Lisp_Int
860 && print_depth
> XINT (Vprint_level
))
862 strout ("...", -1, printcharfun
);
869 register int max
= 0;
871 if (XTYPE (Vprint_length
) == Lisp_Int
)
872 max
= XINT (Vprint_length
);
873 /* Could recognize circularities in cdrs here,
874 but that would make printing of long lists quadratic.
875 It's not worth doing. */
882 strout ("...", 3, printcharfun
);
885 print (Fcar (obj
), printcharfun
, escapeflag
);
889 if (!NILP (obj
) && !CONSP (obj
))
891 strout (" . ", 3, printcharfun
);
892 print (obj
, printcharfun
, escapeflag
);
898 strout ("#", -1, printcharfun
);
903 register Lisp_Object tem
;
904 for (i
= 0; i
< XVECTOR (obj
)->size
; i
++)
906 if (i
) PRINTCHAR (' ');
907 tem
= XVECTOR (obj
)->contents
[i
];
908 print (tem
, printcharfun
, escapeflag
);
916 if (NILP (XBUFFER (obj
)->name
))
917 strout ("#<killed buffer>", -1, printcharfun
);
920 strout ("#<buffer ", -1, printcharfun
);
921 print_string (XBUFFER (obj
)->name
, printcharfun
);
925 print_string (XBUFFER (obj
)->name
, printcharfun
);
931 strout ("#<process ", -1, printcharfun
);
932 print_string (XPROCESS (obj
)->name
, printcharfun
);
936 print_string (XPROCESS (obj
)->name
, printcharfun
);
940 strout ("#<window ", -1, printcharfun
);
941 sprintf (buf
, "%d", XFASTINT (XWINDOW (obj
)->sequence_number
));
942 strout (buf
, -1, printcharfun
);
943 if (!NILP (XWINDOW (obj
)->buffer
))
945 strout (" on ", -1, printcharfun
);
946 print_string (XBUFFER (XWINDOW (obj
)->buffer
)->name
, printcharfun
);
951 case Lisp_Window_Configuration
:
952 strout ("#<window-configuration>", -1, printcharfun
);
957 strout ((FRAME_LIVE_P (XFRAME (obj
))
958 ? "#<frame " : "#<dead frame "),
960 print_string (XFRAME (obj
)->name
, printcharfun
);
961 sprintf (buf
, " 0x%x", (unsigned int) (XFRAME (obj
)));
962 strout (buf
, -1, printcharfun
);
963 strout (">", -1, printcharfun
);
965 #endif /* MULTI_FRAME */
968 strout ("#<marker ", -1, printcharfun
);
969 if (!(XMARKER (obj
)->buffer
))
970 strout ("in no buffer", -1, printcharfun
);
973 sprintf (buf
, "at %d", marker_position (obj
));
974 strout (buf
, -1, printcharfun
);
975 strout (" in ", -1, printcharfun
);
976 print_string (XMARKER (obj
)->buffer
->name
, printcharfun
);
982 strout ("#<overlay ", -1, printcharfun
);
983 if (!(XMARKER (OVERLAY_START (obj
))->buffer
))
984 strout ("in no buffer", -1, printcharfun
);
987 sprintf (buf
, "from %d to %d in ",
988 marker_position (OVERLAY_START (obj
)),
989 marker_position (OVERLAY_END (obj
)));
990 strout (buf
, -1, printcharfun
);
991 print_string (XMARKER (OVERLAY_START (obj
))->buffer
->name
,
997 #endif /* standalone */
1000 strout ("#<subr ", -1, printcharfun
);
1001 strout (XSUBR (obj
)->symbol_name
, -1, printcharfun
);
1009 #ifdef USE_TEXT_PROPERTIES
1011 /* Print a description of INTERVAL using PRINTCHARFUN.
1012 This is part of printing a string that has text properties. */
1015 print_interval (interval
, printcharfun
)
1017 Lisp_Object printcharfun
;
1020 print (make_number (interval
->position
), printcharfun
, 1);
1022 print (make_number (interval
->position
+ LENGTH (interval
)),
1025 print (interval
->plist
, printcharfun
, 1);
1028 #endif /* USE_TEXT_PROPERTIES */
1033 staticpro (&Qprint_escape_newlines
);
1034 Qprint_escape_newlines
= intern ("print-escape-newlines");
1036 DEFVAR_LISP ("standard-output", &Vstandard_output
,
1037 "Output stream `print' uses by default for outputting a character.\n\
1038 This may be any function of one argument.\n\
1039 It may also be a buffer (output is inserted before point)\n\
1040 or a marker (output is inserted and the marker is advanced)\n\
1041 or the symbol t (output appears in the minibuffer line).");
1042 Vstandard_output
= Qt
;
1043 Qstandard_output
= intern ("standard-output");
1044 staticpro (&Qstandard_output
);
1046 #ifdef LISP_FLOAT_TYPE
1047 DEFVAR_LISP ("float-output-format", &Vfloat_output_format
,
1048 "The format descriptor string used to print floats.\n\
1049 This is a %-spec like those accepted by `printf' in C,\n\
1050 but with some restrictions. It must start with the two characters `%.'.\n\
1051 After that comes an integer precision specification,\n\
1052 and then a letter which controls the format.\n\
1053 The letters allowed are `e', `f' and `g'.\n\
1054 Use `e' for exponential notation \"DIG.DIGITSeEXPT\"\n\
1055 Use `f' for decimal point notation \"DIGITS.DIGITS\".\n\
1056 Use `g' to choose the shorter of those two formats for the number at hand.\n\
1057 The precision in any of these cases is the number of digits following\n\
1058 the decimal point. With `f', a precision of 0 means to omit the\n\
1059 decimal point. 0 is not allowed with `e' or `g'.\n\n\
1060 A value of nil means to use `%.17g'.");
1061 Vfloat_output_format
= Qnil
;
1062 Qfloat_output_format
= intern ("float-output-format");
1063 staticpro (&Qfloat_output_format
);
1064 #endif /* LISP_FLOAT_TYPE */
1066 DEFVAR_LISP ("print-length", &Vprint_length
,
1067 "Maximum length of list to print before abbreviating.\n\
1068 A value of nil means no limit.");
1069 Vprint_length
= Qnil
;
1071 DEFVAR_LISP ("print-level", &Vprint_level
,
1072 "Maximum depth of list nesting to print before abbreviating.\n\
1073 A value of nil means no limit.");
1074 Vprint_level
= Qnil
;
1076 DEFVAR_BOOL ("print-escape-newlines", &print_escape_newlines
,
1077 "Non-nil means print newlines in strings as backslash-n.
1078 Also print formfeeds as backslash-f.");
1079 print_escape_newlines
= 0;
1081 /* prin1_to_string_buffer initialized in init_buffer_once in buffer.c */
1082 staticpro (&Vprin1_to_string_buffer
);
1085 defsubr (&Sprin1_to_string
);
1089 defsubr (&Swrite_char
);
1090 defsubr (&Sexternal_debugging_output
);
1092 Qexternal_debugging_output
= intern ("external-debugging-output");
1093 staticpro (&Qexternal_debugging_output
);
1096 defsubr (&Swith_output_to_temp_buffer
);
1097 #endif /* not standalone */