reorder ports.h declarations
[bpt/guile.git] / libguile / print.c
CommitLineData
f4bc4e59
LC
1/* Copyright (C) 1995-1999, 2000, 2001, 2002, 2003, 2004, 2006, 2008,
2 * 2009, 2010, 2011 Free Software Foundation, Inc.
3 *
73be1d9e 4 * This library is free software; you can redistribute it and/or
53befeb7
NJ
5 * modify it under the terms of the GNU Lesser General Public License
6 * as published by the Free Software Foundation; either version 3 of
7 * the License, or (at your option) any later version.
0f2d19dd 8 *
53befeb7
NJ
9 * This library is distributed in the hope that it will be useful, but
10 * WITHOUT ANY WARRANTY; without even the implied warranty of
73be1d9e
MV
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
0f2d19dd 13 *
73be1d9e
MV
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the Free Software
53befeb7
NJ
16 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
17 * 02110-1301 USA
73be1d9e 18 */
1bbd0b84 19
1bbd0b84 20
0f2d19dd 21\f
dbb605f5
LC
22#ifdef HAVE_CONFIG_H
23# include <config.h>
24#endif
0f2d19dd 25
e6e2e95a 26#include <errno.h>
f4bc4e59
LC
27#include <iconv.h>
28#include <stdio.h>
29#include <assert.h>
30
eca29b02 31#include <uniconv.h>
904a78f1 32#include <unictype.h>
e6e2e95a 33
a0599745
MD
34#include "libguile/_scm.h"
35#include "libguile/chars.h"
a002f1a2 36#include "libguile/continuations.h"
a0599745 37#include "libguile/smob.h"
bbb2ecd1 38#include "libguile/control.h"
a0599745
MD
39#include "libguile/eval.h"
40#include "libguile/macros.h"
41#include "libguile/procprop.h"
42#include "libguile/read.h"
2fb924f6 43#include "libguile/programs.h"
a0599745
MD
44#include "libguile/alist.h"
45#include "libguile/struct.h"
a0599745
MD
46#include "libguile/ports.h"
47#include "libguile/root.h"
48#include "libguile/strings.h"
49#include "libguile/strports.h"
50#include "libguile/vectors.h"
327967ef 51#include "libguile/numbers.h"
6f3b0cc2 52#include "libguile/vm.h"
a0599745
MD
53
54#include "libguile/validate.h"
55#include "libguile/print.h"
22fc179a
HWN
56
57#include "libguile/private-options.h"
58
0f2d19dd
JB
59\f
60
07f49ac7
LC
61/* Character printers. */
62
f4bc4e59
LC
63static size_t display_string (const void *, int, size_t, SCM,
64 scm_t_string_failed_conversion_handler);
65
07f49ac7
LC
66static int display_character (scm_t_wchar, SCM,
67 scm_t_string_failed_conversion_handler);
f4bc4e59 68
07f49ac7
LC
69static void write_character (scm_t_wchar, SCM, int);
70
f4bc4e59
LC
71static void write_character_escaped (scm_t_wchar, int, SCM);
72
07f49ac7
LC
73\f
74
0f2d19dd
JB
75/* {Names of immediate symbols}
76 *
77 * This table must agree with the declarations in scm.h: {Immediate Symbols}.
78 */
79
e17d318f
DH
80/* This table must agree with the list of flags in tags.h. */
81static const char *iflagnames[] =
82{
83 "#f",
45f4cbdf
MW
84 "#nil", /* Elisp nil value. Should print from elisp as symbol `nil'. */
85 "#<XXX UNUSED LISP FALSE -- DO NOT USE -- SHOULD NEVER BE SEEN XXX>",
86 "()",
e17d318f 87 "#t",
f60c2c4e
MW
88 "#<XXX UNUSED BOOLEAN 0 -- DO NOT USE -- SHOULD NEVER BE SEEN XXX>",
89 "#<XXX UNUSED BOOLEAN 1 -- DO NOT USE -- SHOULD NEVER BE SEEN XXX>",
90 "#<XXX UNUSED BOOLEAN 2 -- DO NOT USE -- SHOULD NEVER BE SEEN XXX>",
45f4cbdf 91 "#<unspecified>",
e17d318f
DH
92 "#<undefined>",
93 "#<eof>",
e17d318f
DH
94
95 /* Unbound slot marker for GOOPS. For internal use in GOOPS only. */
96 "#<unbound>",
e17d318f
DH
97};
98
475fa9a5
MV
99SCM_SYMBOL (sym_reader, "reader");
100
92c2555f 101scm_t_option scm_print_opts[] = {
210c0325 102 { SCM_OPTION_SCM, "highlight-prefix", (scm_t_bits)SCM_BOOL_F_BITS,
81ae25da 103 "The string to print before highlighted values." },
210c0325 104 { SCM_OPTION_SCM, "highlight-suffix", (scm_t_bits)SCM_BOOL_F_BITS,
475fa9a5 105 "The string to print after highlighted values." },
210c0325 106 { SCM_OPTION_SCM, "quote-keywordish-symbols", (scm_t_bits)SCM_BOOL_F_BITS,
475fa9a5
MV
107 "How to print symbols that have a colon as their first or last character. "
108 "The value '#f' does not quote the colons; '#t' quotes them; "
109 "'reader' quotes them when the reader option 'keywords' is not '#f'."
62560650
HWN
110 },
111 { 0 },
e6e4c9af
MD
112};
113
a1ec6916 114SCM_DEFINE (scm_print_options, "print-options-interface", 0, 1, 0,
1bbd0b84 115 (SCM setting),
71331188 116 "Option interface for the print options. Instead of using\n"
1dd05fd8
MG
117 "this procedure directly, use the procedures\n"
118 "@code{print-enable}, @code{print-disable}, @code{print-set!}\n"
119 "and @code{print-options}.")
1bbd0b84 120#define FUNC_NAME s_scm_print_options
e6e4c9af 121{
a51ea417 122 SCM ans = scm_options (setting,
b7ff98dd 123 scm_print_opts,
1bbd0b84 124 FUNC_NAME);
e6e4c9af
MD
125 return ans;
126}
1bbd0b84 127#undef FUNC_NAME
e6e4c9af 128
0f2d19dd
JB
129\f
130/* {Printing of Scheme Objects}
131 */
132
a51ea417 133/* Detection of circular references.
c62fbfe1
MD
134 *
135 * Due to other constraints in the implementation, this code has bad
5d46ebe3
MD
136 * time complexity (O (depth * N)), The printer code can be
137 * rewritten to be O(N).
a51ea417 138 */
dbb5de29
NJ
139#define PUSH_REF(pstate, obj) \
140do \
141{ \
142 PSTATE_STACK_SET (pstate, pstate->top, obj); \
143 pstate->top++; \
144 if (pstate->top == pstate->ceiling) \
145 grow_ref_stack (pstate); \
1bbd0b84 146} while(0)
a51ea417 147
dbb5de29
NJ
148#define ENTER_NESTED_DATA(pstate, obj, label) \
149do \
150{ \
151 register unsigned long i; \
152 for (i = 0; i < pstate->top; ++i) \
153 if (scm_is_eq (PSTATE_STACK_REF (pstate, i), (obj))) \
154 goto label; \
155 if (pstate->fancyp) \
156 { \
157 if (pstate->top - pstate->list_offset >= pstate->level) \
158 { \
159 scm_putc ('#', port); \
160 return; \
161 } \
162 } \
163 PUSH_REF(pstate, obj); \
1bbd0b84 164} while(0)
a51ea417 165
dbb5de29
NJ
166#define EXIT_NESTED_DATA(pstate) \
167do \
168{ \
169 --pstate->top; \
170 PSTATE_STACK_SET (pstate, pstate->top, SCM_UNDEFINED); \
171} \
172while (0)
c62fbfe1 173
d5cf5324
DH
174SCM scm_print_state_vtable = SCM_BOOL_F;
175static SCM print_state_pool = SCM_EOL;
9de87eea 176scm_i_pthread_mutex_t print_state_mutex = SCM_I_PTHREAD_MUTEX_INITIALIZER;
c4f37e80 177
f843a84c 178#ifdef GUILE_DEBUG /* Used for debugging purposes */
1cc91f1b 179
3b3b36dd 180SCM_DEFINE (scm_current_pstate, "current-pstate", 0, 0, 0,
1bbd0b84 181 (),
d5cf5324 182 "Return the current-pstate -- the car of the\n"
5352393c
MG
183 "@code{print_state_pool}. @code{current-pstate} is only\n"
184 "included in @code{--enable-guile-debug} builds.")
1bbd0b84 185#define FUNC_NAME s_scm_current_pstate
c62fbfe1 186{
d2e53ed6 187 if (!scm_is_null (print_state_pool))
d5cf5324 188 return SCM_CAR (print_state_pool);
a0adfbf0 189 else
0a284a4e 190 return SCM_BOOL_F;
c62fbfe1 191}
1bbd0b84
GB
192#undef FUNC_NAME
193
c62fbfe1
MD
194#endif
195
196#define PSTATE_SIZE 50L
197
698c0295 198static SCM
1bbd0b84 199make_print_state (void)
698c0295 200{
d5cf5324
DH
201 SCM print_state
202 = scm_make_struct (scm_print_state_vtable, SCM_INUM0, SCM_EOL);
bf685b6d 203 scm_print_state *pstate = SCM_PRINT_STATE (print_state);
00ffa0e7 204 pstate->ref_vect = scm_c_make_vector (PSTATE_SIZE, SCM_UNDEFINED);
4057a3e0 205 pstate->ceiling = SCM_SIMPLE_VECTOR_LENGTH (pstate->ref_vect);
d232520a 206 pstate->highlight_objects = SCM_EOL;
698c0295
MD
207 return print_state;
208}
1cc91f1b 209
c62fbfe1
MD
210SCM
211scm_make_print_state ()
c62fbfe1 212{
230d095f 213 SCM answer = SCM_BOOL_F;
698c0295
MD
214
215 /* First try to allocate a print state from the pool */
9de87eea 216 scm_i_pthread_mutex_lock (&print_state_mutex);
d2e53ed6 217 if (!scm_is_null (print_state_pool))
698c0295 218 {
d5cf5324
DH
219 answer = SCM_CAR (print_state_pool);
220 print_state_pool = SCM_CDR (print_state_pool);
698c0295 221 }
9de87eea 222 scm_i_pthread_mutex_unlock (&print_state_mutex);
698c0295 223
7888309b 224 return scm_is_false (answer) ? make_print_state () : answer;
c62fbfe1 225}
a51ea417 226
698c0295 227void
6e8d25a6 228scm_free_print_state (SCM print_state)
698c0295
MD
229{
230 SCM handle;
231 scm_print_state *pstate = SCM_PRINT_STATE (print_state);
232 /* Cleanup before returning print state to pool.
233 * It is better to do it here. Doing it in scm_prin1
234 * would cost more since that function is called much more
235 * often.
236 */
237 pstate->fancyp = 0;
bb35f315 238 pstate->revealed = 0;
d232520a 239 pstate->highlight_objects = SCM_EOL;
9de87eea 240 scm_i_pthread_mutex_lock (&print_state_mutex);
16d4699b 241 handle = scm_cons (print_state, print_state_pool);
d5cf5324 242 print_state_pool = handle;
9de87eea 243 scm_i_pthread_mutex_unlock (&print_state_mutex);
dfd03fb9
MD
244}
245
246SCM
247scm_i_port_with_print_state (SCM port, SCM print_state)
248{
249 if (SCM_UNBNDP (print_state))
250 {
251 if (SCM_PORT_WITH_PS_P (port))
252 return port;
253 else
254 print_state = scm_make_print_state ();
255 /* port does not need to be coerced since it doesn't have ps */
256 }
257 else
258 port = SCM_COERCE_OUTPORT (port);
259 SCM_RETURN_NEWSMOB (scm_tc16_port_with_ps,
260 SCM_UNPACK (scm_cons (port, print_state)));
698c0295 261}
1cc91f1b 262
a51ea417 263static void
1bbd0b84 264grow_ref_stack (scm_print_state *pstate)
a51ea417 265{
4057a3e0
MV
266 SCM old_vect = pstate->ref_vect;
267 size_t old_size = SCM_SIMPLE_VECTOR_LENGTH (old_vect);
268 size_t new_size = 2 * pstate->ceiling;
00ffa0e7 269 SCM new_vect = scm_c_make_vector (new_size, SCM_UNDEFINED);
b17004b8
DH
270 unsigned long int i;
271
272 for (i = 0; i != old_size; ++i)
4057a3e0 273 SCM_SIMPLE_VECTOR_SET (new_vect, i, SCM_SIMPLE_VECTOR_REF (old_vect, i));
b17004b8
DH
274
275 pstate->ref_vect = new_vect;
bf685b6d 276 pstate->ceiling = new_size;
a51ea417
MD
277}
278
509759dd
MV
279#define PSTATE_STACK_REF(p,i) SCM_SIMPLE_VECTOR_REF((p)->ref_vect, (i))
280#define PSTATE_STACK_SET(p,i,v) SCM_SIMPLE_VECTOR_SET((p)->ref_vect, (i), (v))
1cc91f1b 281
a51ea417 282static void
34d19ef6 283print_circref (SCM port, scm_print_state *pstate, SCM ref)
a51ea417 284{
c014a02e
ML
285 register long i;
286 long self = pstate->top - 1;
c62fbfe1 287 i = pstate->top - 1;
509759dd 288 if (scm_is_pair (PSTATE_STACK_REF (pstate, i)))
c62fbfe1
MD
289 {
290 while (i > 0)
291 {
509759dd
MV
292 if (!scm_is_pair (PSTATE_STACK_REF (pstate, i-1))
293 || !scm_is_eq (SCM_CDR (PSTATE_STACK_REF (pstate, i-1)),
294 SCM_CDR (PSTATE_STACK_REF (pstate, i))))
c62fbfe1
MD
295 break;
296 --i;
297 }
298 self = i;
299 }
300 for (i = pstate->top - 1; 1; --i)
509759dd 301 if (scm_is_eq (PSTATE_STACK_REF(pstate, i), ref))
c62fbfe1 302 break;
b7f3516f 303 scm_putc ('#', port);
c62fbfe1 304 scm_intprint (i - self, 10, port);
b7f3516f 305 scm_putc ('#', port);
a51ea417
MD
306}
307
6662998f
MV
308/* Print the name of a symbol. */
309
475fa9a5 310static int
15671c6e 311quote_keywordish_symbols (void)
475fa9a5 312{
15671c6e 313 SCM option = SCM_PRINT_KEYWORD_STYLE;
475fa9a5 314
475fa9a5
MV
315 if (scm_is_false (option))
316 return 0;
317 if (scm_is_eq (option, sym_reader))
318 return scm_is_true (SCM_PACK (SCM_KEYWORD_STYLE));
319 return 1;
320}
321
2e9fc9fc
AW
322#define INITIAL_IDENTIFIER_MASK \
323 (UC_CATEGORY_MASK_Lu | UC_CATEGORY_MASK_Ll | UC_CATEGORY_MASK_Lt \
324 | UC_CATEGORY_MASK_Lm | UC_CATEGORY_MASK_Lo | UC_CATEGORY_MASK_Mn \
325 | UC_CATEGORY_MASK_Nl | UC_CATEGORY_MASK_No | UC_CATEGORY_MASK_Pd \
326 | UC_CATEGORY_MASK_Pc | UC_CATEGORY_MASK_Po | UC_CATEGORY_MASK_Sc \
327 | UC_CATEGORY_MASK_Sm | UC_CATEGORY_MASK_Sk | UC_CATEGORY_MASK_So \
328 | UC_CATEGORY_MASK_Co)
329
330#define SUBSEQUENT_IDENTIFIER_MASK \
331 (INITIAL_IDENTIFIER_MASK \
332 | UC_CATEGORY_MASK_Nd | UC_CATEGORY_MASK_Mc | UC_CATEGORY_MASK_Me)
333
15671c6e
AW
334static int
335symbol_has_extended_read_syntax (SCM sym)
6662998f 336{
15671c6e
AW
337 size_t pos, len = scm_i_symbol_length (sym);
338 scm_t_wchar c;
339
340 /* The empty symbol. */
341 if (len == 0)
342 return 1;
343
344 c = scm_i_symbol_ref (sym, 0);
345
346 /* Single dot; conflicts with dotted-pair notation. */
347 if (len == 1 && c == '.')
348 return 1;
349
350 /* Other initial-character constraints. */
2e9fc9fc 351 if (c == '\'' || c == '`' || c == ',' || c == '"' || c == ';' || c == '#')
15671c6e
AW
352 return 1;
353
354 /* Keywords can be identified by trailing colons too. */
355 if (c == ':' || scm_i_symbol_ref (sym, len - 1) == ':')
356 return quote_keywordish_symbols ();
357
358 /* Number-ish symbols. */
359 if (scm_is_true (scm_i_string_to_number (scm_symbol_to_string (sym), 10)))
360 return 1;
361
2e9fc9fc
AW
362 /* Other disallowed first characters. */
363 if (!uc_is_general_category_withtable (c, INITIAL_IDENTIFIER_MASK))
364 return 1;
365
366 /* Otherwise, any character that's in the identifier category mask is
367 fine to pass through as-is, provided it's not one of the ASCII
368 delimiters like `;'. */
369 for (pos = 1; pos < len; pos++)
6662998f 370 {
2e9fc9fc
AW
371 c = scm_i_symbol_ref (sym, pos);
372 if (!uc_is_general_category_withtable (c, SUBSEQUENT_IDENTIFIER_MASK))
373 return 1;
374 else if (c == '"' || c == ';' || c == '#')
375 return 1;
6662998f 376 }
c6b49e89 377
15671c6e
AW
378 return 0;
379}
380
381static void
382print_normal_symbol (SCM sym, SCM port)
383{
384 scm_display (scm_symbol_to_string (sym), port);
385}
386
15671c6e
AW
387static void
388print_extended_symbol (SCM sym, SCM port)
389{
390 size_t pos, len;
391 scm_t_string_failed_conversion_handler strategy;
392
393 len = scm_i_symbol_length (sym);
394 strategy = scm_i_get_conversion_strategy (port);
395
396 scm_lfwrite ("#{", 2, port);
397
398 for (pos = 0; pos < len; pos++)
399 {
400 scm_t_wchar c = scm_i_symbol_ref (sym, pos);
401
2e9fc9fc
AW
402 if (uc_is_general_category_withtable (c,
403 SUBSEQUENT_IDENTIFIER_MASK
404 | UC_CATEGORY_MASK_Zs))
15671c6e 405 {
15671c6e
AW
406 if (!display_character (c, port, strategy))
407 scm_encoding_error ("print_extended_symbol", errno,
408 "cannot convert to output locale",
409 port, SCM_MAKE_CHAR (c));
2e9fc9fc
AW
410 }
411 else
412 {
413 display_string ("\\x", 1, 2, port, iconveh_question_mark);
414 scm_intprint (c, 16, port);
415 display_character (';', port, iconveh_question_mark);
15671c6e
AW
416 }
417 }
418
419 scm_lfwrite ("}#", 2, port);
420}
421
422/* FIXME: allow R6RS hex escapes instead of #{...}#. */
423void
424scm_i_print_symbol_name (SCM sym, SCM port)
425{
426 if (symbol_has_extended_read_syntax (sym))
427 print_extended_symbol (sym, port);
428 else
429 print_normal_symbol (sym, port);
6662998f
MV
430}
431
e23106d5
MG
432void
433scm_print_symbol_name (const char *str, size_t len, SCM port)
434{
25d50a05 435 SCM symbol = scm_from_utf8_symboln (str, len);
ab33782c 436 scm_i_print_symbol_name (symbol, port);
e23106d5
MG
437}
438
c62fbfe1 439/* Print generally. Handles both write and display according to PSTATE.
0f2d19dd 440 */
8b840115
MD
441SCM_GPROC(s_write, "write", 1, 1, 0, scm_write, g_write);
442SCM_GPROC(s_display, "display", 1, 1, 0, scm_display, g_display);
1cc91f1b 443
d232520a
MV
444static void iprin1 (SCM exp, SCM port, scm_print_state *pstate);
445
dea901d6
MG
446
447/* Print a character as an octal or hex escape. */
448#define PRINT_CHAR_ESCAPE(i, port) \
449 do \
450 { \
451 if (!SCM_R6RS_ESCAPES_P) \
452 scm_intprint (i, 8, port); \
453 else \
454 { \
455 scm_puts ("x", port); \
456 scm_intprint (i, 16, port); \
457 } \
458 } \
459 while (0)
460
461
0f2d19dd 462void
1bbd0b84 463scm_iprin1 (SCM exp, SCM port, scm_print_state *pstate)
d232520a
MV
464{
465 if (pstate->fancyp
466 && scm_is_true (scm_memq (exp, pstate->highlight_objects)))
467 {
81ae25da 468 scm_display (SCM_PRINT_HIGHLIGHT_PREFIX, port);
d232520a 469 iprin1 (exp, port, pstate);
81ae25da 470 scm_display (SCM_PRINT_HIGHLIGHT_SUFFIX, port);
d232520a
MV
471 }
472 else
473 iprin1 (exp, port, pstate);
474}
475
476static void
477iprin1 (SCM exp, SCM port, scm_print_state *pstate)
0f2d19dd 478{
54778cd3 479 switch (SCM_ITAG3 (exp))
0f2d19dd 480 {
e34f941a
DH
481 case scm_tc3_tc7_1:
482 case scm_tc3_tc7_2:
483 /* These tc3 tags should never occur in an immediate value. They are
484 * only used in cell types of non-immediates, i. e. the value returned
485 * by SCM_CELL_TYPE (exp) can use these tags.
486 */
487 scm_ipruk ("immediate", exp, port);
488 break;
489 case scm_tc3_int_1:
490 case scm_tc3_int_2:
e11e83f3 491 scm_intprint (SCM_I_INUM (exp), 10, port);
0f2d19dd 492 break;
e34f941a 493 case scm_tc3_imm24:
7866a09b 494 if (SCM_CHARP (exp))
0f2d19dd 495 {
b7f3516f 496 if (SCM_WRITINGP (pstate))
07f49ac7
LC
497 write_character (SCM_CHAR (exp), port, 0);
498 else
b7f3516f 499 {
07f49ac7
LC
500 if (!display_character (SCM_CHAR (exp), port,
501 scm_i_get_conversion_strategy (port)))
502 scm_encoding_error (__func__, errno,
503 "cannot convert to output locale",
6851d3be 504 port, exp);
b7f3516f 505 }
0f2d19dd 506 }
a51ea417 507 else if (SCM_IFLAGP (exp)
e17d318f
DH
508 && ((size_t) SCM_IFLAGNUM (exp) < (sizeof iflagnames / sizeof (char *))))
509 {
510 scm_puts (iflagnames [SCM_IFLAGNUM (exp)], port);
511 }
0f2d19dd 512 else
e34f941a
DH
513 {
514 /* unknown immediate value */
515 scm_ipruk ("immediate", exp, port);
516 }
0f2d19dd 517 break;
e34f941a 518 case scm_tc3_cons:
0f2d19dd
JB
519 switch (SCM_TYP7 (exp))
520 {
904a077d
MV
521 case scm_tcs_struct:
522 {
523 ENTER_NESTED_DATA (pstate, exp, circref);
524 if (SCM_OBJ_CLASS_FLAGS (exp) & SCM_CLASSF_GOOPS)
525 {
526 SCM pwps, print = pstate->writingp ? g_write : g_display;
b2b33168 527 if (SCM_UNPACK (print) == 0)
904a077d 528 goto print_struct;
dfd03fb9 529 pwps = scm_i_port_with_print_state (port, pstate->handle);
7663c008 530 pstate->revealed = 1;
fa075d40 531 scm_call_2 (print, exp, pwps);
904a077d
MV
532 }
533 else
534 {
535 print_struct:
536 scm_print_struct (exp, port, pstate);
537 }
538 EXIT_NESTED_DATA (pstate);
539 }
540 break;
0f2d19dd
JB
541 case scm_tcs_cons_imcar:
542 case scm_tcs_cons_nimcar:
c62fbfe1
MD
543 ENTER_NESTED_DATA (pstate, exp, circref);
544 scm_iprlist ("(", exp, ')', port, pstate);
545 EXIT_NESTED_DATA (pstate);
a51ea417
MD
546 break;
547 circref:
c62fbfe1 548 print_circref (port, pstate, exp);
0f2d19dd 549 break;
534c55a9
DH
550 case scm_tc7_number:
551 switch SCM_TYP16 (exp) {
552 case scm_tc16_big:
553 scm_bigprint (exp, port, pstate);
554 break;
555 case scm_tc16_real:
556 scm_print_real (exp, port, pstate);
557 break;
558 case scm_tc16_complex:
559 scm_print_complex (exp, port, pstate);
560 break;
f92e85f7
MV
561 case scm_tc16_fraction:
562 scm_i_print_fraction (exp, port, pstate);
563 break;
534c55a9
DH
564 }
565 break;
9c44cd45
MG
566 case scm_tc7_string:
567 if (SCM_WRITINGP (pstate))
568 {
07f49ac7 569 size_t len, i;
9c44cd45 570
f4bc4e59 571 display_character ('"', port, iconveh_question_mark);
9c44cd45
MG
572 len = scm_i_string_length (exp);
573 for (i = 0; i < len; ++i)
07f49ac7
LC
574 write_character (scm_i_string_ref (exp, i), port, 1);
575
f4bc4e59 576 display_character ('"', port, iconveh_question_mark);
9c44cd45
MG
577 scm_remember_upto_here_1 (exp);
578 }
579 else
f4bc4e59
LC
580 {
581 size_t len, printed;
582
583 len = scm_i_string_length (exp);
584 printed = display_string (scm_i_string_data (exp),
585 scm_i_is_narrow_string (exp),
586 len, port,
587 scm_i_get_conversion_strategy (port));
588 if (SCM_UNLIKELY (printed < len))
f4bc4e59
LC
589 scm_encoding_error (__func__, errno,
590 "cannot convert to output locale",
6851d3be 591 port, scm_c_string_ref (exp, printed));
f4bc4e59
LC
592 }
593
9c44cd45
MG
594 scm_remember_upto_here_1 (exp);
595 break;
28b06554 596 case scm_tc7_symbol:
cc95e00a 597 if (scm_i_symbol_is_interned (exp))
9ff28a13 598 {
e23106d5 599 scm_i_print_symbol_name (exp, port);
9ff28a13
MV
600 scm_remember_upto_here_1 (exp);
601 }
602 else
603 {
604 scm_puts ("#<uninterned-symbol ", port);
e23106d5 605 scm_i_print_symbol_name (exp, port);
9ff28a13 606 scm_putc (' ', port);
0345e278 607 scm_uintprint (SCM_UNPACK (exp), 16, port);
9ff28a13
MV
608 scm_putc ('>', port);
609 }
6662998f 610 break;
e5aca4b5
MV
611 case scm_tc7_variable:
612 scm_i_variable_print (exp, port, pstate);
613 break;
2fb924f6
AW
614 case scm_tc7_program:
615 scm_i_program_print (exp, port, pstate);
616 break;
5b46a8c2
LC
617 case scm_tc7_pointer:
618 scm_i_pointer_print (exp, port, pstate);
e2c2a699 619 break;
c99de5aa
AW
620 case scm_tc7_hashtable:
621 scm_i_hashtable_print (exp, port, pstate);
622 break;
26b26354
AW
623 case scm_tc7_weak_set:
624 scm_i_weak_set_print (exp, port, pstate);
625 break;
7005c60f
AW
626 case scm_tc7_weak_table:
627 scm_i_weak_table_print (exp, port, pstate);
628 break;
9ea31741
AW
629 case scm_tc7_fluid:
630 scm_i_fluid_print (exp, port, pstate);
631 break;
45cf2428
AW
632 case scm_tc7_dynamic_state:
633 scm_i_dynamic_state_print (exp, port, pstate);
634 break;
6f3b0cc2
AW
635 case scm_tc7_frame:
636 scm_i_frame_print (exp, port, pstate);
637 break;
638 case scm_tc7_objcode:
639 scm_i_objcode_print (exp, port, pstate);
640 break;
641 case scm_tc7_vm:
642 scm_i_vm_print (exp, port, pstate);
643 break;
644 case scm_tc7_vm_cont:
645 scm_i_vm_cont_print (exp, port, pstate);
646 break;
bbb2ecd1
AW
647 case scm_tc7_prompt:
648 scm_i_prompt_print (exp, port, pstate);
649 break;
650 case scm_tc7_with_fluids:
651 scm_i_with_fluids_print (exp, port, pstate);
652 break;
0f2d19dd 653 case scm_tc7_wvect:
c62fbfe1 654 ENTER_NESTED_DATA (pstate, exp, circref);
a141db86 655 scm_puts ("#w(", port);
0f2d19dd
JB
656 goto common_vector_printer;
657
807e5a66
LC
658 case scm_tc7_bytevector:
659 scm_i_print_bytevector (exp, port, pstate);
660 break;
0f2d19dd 661 case scm_tc7_vector:
c62fbfe1 662 ENTER_NESTED_DATA (pstate, exp, circref);
b7f3516f 663 scm_puts ("#(", port);
0f2d19dd 664 common_vector_printer:
9fbaf27c 665 {
c014a02e 666 register long i;
4057a3e0 667 long last = SCM_SIMPLE_VECTOR_LENGTH (exp) - 1;
9fbaf27c 668 int cutp = 0;
4057a3e0
MV
669 if (pstate->fancyp
670 && SCM_SIMPLE_VECTOR_LENGTH (exp) > pstate->length)
9fbaf27c
MD
671 {
672 last = pstate->length - 1;
673 cutp = 1;
674 }
a141db86
AW
675 for (i = 0; i < last; ++i)
676 {
677 scm_iprin1 (scm_c_vector_ref (exp, i), port, pstate);
678 scm_putc (' ', port);
679 }
9fbaf27c
MD
680 if (i == last)
681 {
682 /* CHECK_INTS; */
c367c4b4 683 scm_iprin1 (scm_c_vector_ref (exp, i), port, pstate);
9fbaf27c
MD
684 }
685 if (cutp)
b7f3516f
TT
686 scm_puts (" ...", port);
687 scm_putc (')', port);
9fbaf27c 688 }
c62fbfe1 689 EXIT_NESTED_DATA (pstate);
0f2d19dd 690 break;
0f2d19dd 691 case scm_tc7_port:
5ca6dc39
JB
692 {
693 register long i = SCM_PTOBNUM (exp);
694 if (i < scm_numptob
695 && scm_ptobs[i].print
696 && (scm_ptobs[i].print) (exp, port, pstate))
a51ea417 697 break;
5ca6dc39
JB
698 goto punk;
699 }
700 case scm_tc7_smob:
7a7f7c53
DH
701 ENTER_NESTED_DATA (pstate, exp, circref);
702 SCM_SMOB_DESCRIPTOR (exp).print (exp, port, pstate);
703 EXIT_NESTED_DATA (pstate);
704 break;
0f2d19dd 705 default:
314b8716 706 /* case scm_tcs_closures: */
a51ea417
MD
707 punk:
708 scm_ipruk ("type", exp, port);
0f2d19dd
JB
709 }
710 }
711}
712
c62fbfe1
MD
713/* Print states are necessary for circular reference safe printing.
714 * They are also expensive to allocate. Therefore print states are
715 * kept in a pool so that they can be reused.
716 */
1cc91f1b 717
bb35f315
MV
718/* The PORT argument can also be a print-state/port pair, which will
719 * then be used instead of allocating a new print state. This is
720 * useful for continuing a chain of print calls from Scheme. */
721
a51ea417 722void
1bbd0b84 723scm_prin1 (SCM exp, SCM port, int writingp)
a51ea417 724{
c4f37e80
MV
725 SCM handle = SCM_BOOL_F; /* Will GC protect the handle whilst unlinked */
726 SCM pstate_scm;
c62fbfe1 727 scm_print_state *pstate;
15635be5 728 int old_writingp;
c62fbfe1 729
bb35f315
MV
730 /* If PORT is a print-state/port pair, use that. Else create a new
731 print-state. */
c4f37e80 732
0c95b57d 733 if (SCM_PORT_WITH_PS_P (port))
bb35f315 734 {
52235e71
MD
735 pstate_scm = SCM_PORT_WITH_PS_PS (port);
736 port = SCM_PORT_WITH_PS_PORT (port);
bb35f315
MV
737 }
738 else
c62fbfe1 739 {
c4f37e80 740 /* First try to allocate a print state from the pool */
9de87eea 741 scm_i_pthread_mutex_lock (&print_state_mutex);
d2e53ed6 742 if (!scm_is_null (print_state_pool))
c4f37e80 743 {
d5cf5324
DH
744 handle = print_state_pool;
745 print_state_pool = SCM_CDR (print_state_pool);
c4f37e80 746 }
9de87eea 747 scm_i_pthread_mutex_unlock (&print_state_mutex);
7888309b 748 if (scm_is_false (handle))
d5cf5324 749 handle = scm_list_1 (make_print_state ());
c4f37e80 750 pstate_scm = SCM_CAR (handle);
c62fbfe1 751 }
c62fbfe1 752
c4f37e80 753 pstate = SCM_PRINT_STATE (pstate_scm);
15635be5 754 old_writingp = pstate->writingp;
c62fbfe1
MD
755 pstate->writingp = writingp;
756 scm_iprin1 (exp, port, pstate);
15635be5 757 pstate->writingp = old_writingp;
c62fbfe1 758
bb35f315
MV
759 /* Return print state to pool if it has been created above and
760 hasn't escaped to Scheme. */
761
7888309b 762 if (scm_is_true (handle) && !pstate->revealed)
c4f37e80 763 {
9de87eea 764 scm_i_pthread_mutex_lock (&print_state_mutex);
d5cf5324
DH
765 SCM_SETCDR (handle, print_state_pool);
766 print_state_pool = handle;
9de87eea 767 scm_i_pthread_mutex_unlock (&print_state_mutex);
c4f37e80 768 }
a51ea417
MD
769}
770
f4bc4e59
LC
771/* Convert codepoint CH to UTF-8 and store the result in UTF8. Return
772 the number of bytes of the UTF-8-encoded string. */
773static size_t
774codepoint_to_utf8 (scm_t_wchar ch, scm_t_uint8 utf8[4])
9c44cd45 775{
f4bc4e59
LC
776 size_t len;
777 scm_t_uint32 codepoint;
778
779 codepoint = (scm_t_uint32) ch;
07f49ac7 780
f4bc4e59 781 if (codepoint <= 0x7f)
07f49ac7 782 {
f4bc4e59
LC
783 len = 1;
784 utf8[0] = (scm_t_uint8) codepoint;
785 }
786 else if (codepoint <= 0x7ffUL)
787 {
788 len = 2;
789 utf8[0] = 0xc0 | (codepoint >> 6);
790 utf8[1] = 0x80 | (codepoint & 0x3f);
791 }
792 else if (codepoint <= 0xffffUL)
793 {
794 len = 3;
795 utf8[0] = 0xe0 | (codepoint >> 12);
796 utf8[1] = 0x80 | ((codepoint >> 6) & 0x3f);
797 utf8[2] = 0x80 | (codepoint & 0x3f);
07f49ac7
LC
798 }
799 else
800 {
f4bc4e59
LC
801 len = 4;
802 utf8[0] = 0xf0 | (codepoint >> 18);
803 utf8[1] = 0x80 | ((codepoint >> 12) & 0x3f);
804 utf8[2] = 0x80 | ((codepoint >> 6) & 0x3f);
805 utf8[3] = 0x80 | (codepoint & 0x3f);
806 }
807
808 return len;
809}
810
f4bc4e59
LC
811#define STR_REF(s, x) \
812 (narrow_p \
813 ? (scm_t_wchar) ((unsigned char *) (s))[x] \
814 : ((scm_t_wchar *) (s))[x])
815
7b292a9d
LC
816/* Write STR to PORT as UTF-8. STR is a LEN-codepoint string; it is
817 narrow if NARROW_P is true, wide otherwise. Return LEN. */
818static size_t
819display_string_as_utf8 (const void *str, int narrow_p, size_t len,
820 SCM port)
821{
822 size_t printed = 0;
823
824 while (len > printed)
825 {
826 size_t utf8_len, i;
827 char *input, utf8_buf[256];
828
829 /* Convert STR to UTF-8. */
830 for (i = printed, utf8_len = 0, input = utf8_buf;
831 i < len && utf8_len + 4 < sizeof (utf8_buf);
832 i++)
833 {
834 utf8_len += codepoint_to_utf8 (STR_REF (str, i),
835 (scm_t_uint8 *) input);
836 input = utf8_buf + utf8_len;
837 }
838
839 /* INPUT was successfully converted, entirely; print the
840 result. */
841 scm_lfwrite (utf8_buf, utf8_len, port);
842 printed += i - printed;
843 }
844
845 assert (printed == len);
846
847 return len;
848}
849
850/* Convert STR through PORT's output conversion descriptor and write the
851 output to PORT. Return the number of codepoints written. */
852static size_t
853display_string_using_iconv (const void *str, int narrow_p, size_t len,
854 SCM port,
855 scm_t_string_failed_conversion_handler strategy)
856{
f4bc4e59
LC
857 size_t printed;
858 scm_t_port *pt;
859
860 pt = SCM_PTAB_ENTRY (port);
861
f4bc4e59
LC
862 printed = 0;
863
864 while (len > printed)
865 {
866 size_t done, utf8_len, input_left, output_left, i;
867 size_t codepoints_read, output_len;
868 char *input, *output;
869 char utf8_buf[256], encoded_output[256];
870 size_t offsets[256];
871
872 /* Convert STR to UTF-8. */
873 for (i = printed, utf8_len = 0, input = utf8_buf;
874 i < len && utf8_len + 4 < sizeof (utf8_buf);
875 i++)
07f49ac7 876 {
f4bc4e59
LC
877 offsets[utf8_len] = i;
878 utf8_len += codepoint_to_utf8 (STR_REF (str, i),
879 (scm_t_uint8 *) input);
880 input = utf8_buf + utf8_len;
881 }
882
883 input = utf8_buf;
884 input_left = utf8_len;
885
886 output = encoded_output;
887 output_left = sizeof (encoded_output);
888
889 done = iconv (pt->output_cd, &input, &input_left,
890 &output, &output_left);
07f49ac7 891
f4bc4e59
LC
892 output_len = sizeof (encoded_output) - output_left;
893
894 if (SCM_UNLIKELY (done == (size_t) -1))
895 {
b2548e23
AW
896 int errno_save = errno;
897
f4bc4e59
LC
898 /* Reset the `iconv' state. */
899 iconv (pt->output_cd, NULL, NULL, NULL, NULL);
900
7174bc08
LC
901 /* Print the OUTPUT_LEN bytes successfully converted. */
902 scm_lfwrite (encoded_output, output_len, port);
903
904 /* See how many input codepoints these OUTPUT_LEN bytes
905 corresponds to. */
906 codepoints_read = offsets[input - utf8_buf] - printed;
907 printed += codepoints_read;
908
b2548e23 909 if (errno_save == EILSEQ &&
f4bc4e59 910 strategy != SCM_FAILED_CONVERSION_ERROR)
07f49ac7 911 {
f4bc4e59
LC
912 /* Conversion failed somewhere in INPUT and we want to
913 escape or substitute the offending input character. */
914
f4bc4e59 915 if (strategy == SCM_FAILED_CONVERSION_ESCAPE_SEQUENCE)
f1ee6d54 916 {
f4bc4e59
LC
917 scm_t_wchar ch;
918
919 /* Find CH, the offending codepoint, and escape it. */
920 ch = STR_REF (str, offsets[input - utf8_buf]);
921 write_character_escaped (ch, 1, port);
f1ee6d54 922 }
07f49ac7 923 else
f4bc4e59
LC
924 /* STRATEGY is `SCM_FAILED_CONVERSION_QUESTION_MARK'. */
925 display_string ("?", 1, 1, port, strategy);
9c44cd45 926
f4bc4e59
LC
927 printed++;
928 }
929 else
930 /* Something bad happened that we can't handle: bail out. */
931 break;
07f49ac7
LC
932 }
933 else
f4bc4e59
LC
934 {
935 /* INPUT was successfully converted, entirely; print the
936 result. */
937 scm_lfwrite (encoded_output, output_len, port);
938 codepoints_read = i - printed;
939 printed += codepoints_read;
940 }
07f49ac7
LC
941 }
942
943 return printed;
7b292a9d
LC
944}
945
f4bc4e59 946#undef STR_REF
7b292a9d
LC
947
948/* Display the LEN codepoints in STR to PORT according to STRATEGY;
949 return the number of codepoints successfully displayed. If NARROW_P,
950 then STR is interpreted as a sequence of `char', denoting a Latin-1
951 string; otherwise it's interpreted as a sequence of
952 `scm_t_wchar'. */
953static size_t
954display_string (const void *str, int narrow_p,
955 size_t len, SCM port,
956 scm_t_string_failed_conversion_handler strategy)
957
958{
959 scm_t_port *pt;
960
961 pt = SCM_PTAB_ENTRY (port);
962
963 if (pt->output_cd == (iconv_t) -1)
964 /* Initialize the conversion descriptors, if needed. */
965 scm_i_set_port_encoding_x (port, pt->encoding);
966
967 /* FIXME: In 2.1, add a flag to determine whether a port is UTF-8. */
968 if (pt->output_cd == (iconv_t) -1)
969 return display_string_as_utf8 (str, narrow_p, len, port);
970 else
971 return display_string_using_iconv (str, narrow_p, len,
972 port, strategy);
f4bc4e59
LC
973}
974
975/* Attempt to display CH to PORT according to STRATEGY. Return non-zero
976 if CH was successfully displayed, zero otherwise (e.g., if it was not
977 representable in PORT's encoding.) */
978static int
979display_character (scm_t_wchar ch, SCM port,
980 scm_t_string_failed_conversion_handler strategy)
981{
982 return display_string (&ch, 0, 1, port, strategy) == 1;
07f49ac7
LC
983}
984
33d92fe6
LC
985/* Attempt to pretty-print CH, a combining character, to PORT. Return
986 zero upon failure, non-zero otherwise. The idea is to print CH above
987 a dotted circle to make it more visible. */
988static int
989write_combining_character (scm_t_wchar ch, SCM port)
990{
f4bc4e59
LC
991 scm_t_wchar str[2];
992
993 str[0] = SCM_CODEPOINT_DOTTED_CIRCLE;
994 str[1] = ch;
995
996 return display_string (str, 0, 2, port, iconveh_error) == 2;
997}
33d92fe6 998
f4bc4e59
LC
999/* Write CH to PORT in its escaped form, using the string escape syntax
1000 if STRING_ESCAPES_P is non-zero. */
1001static void
1002write_character_escaped (scm_t_wchar ch, int string_escapes_p, SCM port)
1003{
1004 if (string_escapes_p)
33d92fe6 1005 {
f4bc4e59
LC
1006 /* Represent CH using the in-string escape syntax. */
1007
1008 static const char hex[] = "0123456789abcdef";
1009 static const char escapes[7] = "abtnvfr";
1010 char buf[9];
1011
1012 if (ch >= 0x07 && ch <= 0x0D && ch != 0x0A)
33d92fe6 1013 {
f4bc4e59
LC
1014 /* Use special escapes for some C0 controls. */
1015 buf[0] = '\\';
1016 buf[1] = escapes[ch - 0x07];
1017 scm_lfwrite (buf, 2, port);
1018 }
1019 else if (!SCM_R6RS_ESCAPES_P)
1020 {
1021 if (ch <= 0xFF)
1022 {
1023 buf[0] = '\\';
1024 buf[1] = 'x';
1025 buf[2] = hex[ch / 16];
1026 buf[3] = hex[ch % 16];
1027 scm_lfwrite (buf, 4, port);
1028 }
1029 else if (ch <= 0xFFFF)
1030 {
1031 buf[0] = '\\';
1032 buf[1] = 'u';
1033 buf[2] = hex[(ch & 0xF000) >> 12];
1034 buf[3] = hex[(ch & 0xF00) >> 8];
1035 buf[4] = hex[(ch & 0xF0) >> 4];
1036 buf[5] = hex[(ch & 0xF)];
1037 scm_lfwrite (buf, 6, port);
1038 }
1039 else if (ch > 0xFFFF)
1040 {
1041 buf[0] = '\\';
1042 buf[1] = 'U';
1043 buf[2] = hex[(ch & 0xF00000) >> 20];
1044 buf[3] = hex[(ch & 0xF0000) >> 16];
1045 buf[4] = hex[(ch & 0xF000) >> 12];
1046 buf[5] = hex[(ch & 0xF00) >> 8];
1047 buf[6] = hex[(ch & 0xF0) >> 4];
1048 buf[7] = hex[(ch & 0xF)];
1049 scm_lfwrite (buf, 8, port);
1050 }
33d92fe6
LC
1051 }
1052 else
f4bc4e59
LC
1053 {
1054 /* Print an R6RS variable-length hex escape: "\xNNNN;". */
1055 scm_t_wchar ch2 = ch;
1056
1057 int i = 8;
1058 buf[i] = ';';
1059 i --;
1060 if (ch == 0)
1061 buf[i--] = '0';
1062 else
1063 while (ch2 > 0)
1064 {
1065 buf[i] = hex[ch2 & 0xF];
1066 ch2 >>= 4;
1067 i --;
1068 }
1069 buf[i] = 'x';
1070 i --;
1071 buf[i] = '\\';
1072 scm_lfwrite (buf + i, 9 - i, port);
1073 }
33d92fe6
LC
1074 }
1075 else
f4bc4e59
LC
1076 {
1077 /* Represent CH using the character escape syntax. */
1078 const char *name;
33d92fe6 1079
f4bc4e59
LC
1080 name = scm_i_charname (SCM_MAKE_CHAR (ch));
1081 if (name != NULL)
1082 scm_puts (name, port);
1083 else
1084 PRINT_CHAR_ESCAPE (ch, port);
1085 }
33d92fe6
LC
1086}
1087
07f49ac7
LC
1088/* Write CH to PORT, escaping it if it's non-graphic or not
1089 representable in PORT's encoding. If STRING_ESCAPES_P is true and CH
1090 needs to be escaped, it is escaped using the in-string escape syntax;
1091 otherwise the character escape syntax is used. */
1092static void
1093write_character (scm_t_wchar ch, SCM port, int string_escapes_p)
1094{
1095 int printed = 0;
f4bc4e59
LC
1096 scm_t_string_failed_conversion_handler strategy;
1097
1098 strategy = scm_i_get_conversion_strategy (port);
07f49ac7
LC
1099
1100 if (string_escapes_p)
1101 {
1102 /* Check if CH deserves special treatment. */
1103 if (ch == '"' || ch == '\\')
1104 {
f4bc4e59
LC
1105 display_character ('\\', port, iconveh_question_mark);
1106 display_character (ch, port, strategy);
07f49ac7
LC
1107 printed = 1;
1108 }
1109 else if (ch == ' ' || ch == '\n')
1110 {
f4bc4e59 1111 display_character (ch, port, strategy);
07f49ac7
LC
1112 printed = 1;
1113 }
1114 }
1115 else
33d92fe6 1116 {
f4bc4e59 1117 display_string ("#\\", 1, 2, port, iconveh_question_mark);
33d92fe6
LC
1118
1119 if (uc_combining_class (ch) != UC_CCC_NR)
1120 /* Character is a combining character, so attempt to
1121 pretty-print it. */
1122 printed = write_combining_character (ch, port);
1123 }
07f49ac7
LC
1124
1125 if (!printed
1126 && uc_is_general_category_withtable (ch,
1127 UC_CATEGORY_MASK_L |
1128 UC_CATEGORY_MASK_M |
1129 UC_CATEGORY_MASK_N |
1130 UC_CATEGORY_MASK_P |
1131 UC_CATEGORY_MASK_S))
1132 /* CH is graphic; attempt to display it. */
1133 printed = display_character (ch, port, iconveh_error);
1134
1135 if (!printed)
f4bc4e59
LC
1136 /* CH isn't graphic or cannot be represented in PORT's encoding. */
1137 write_character_escaped (ch, string_escapes_p, port);
9c44cd45 1138}
0f2d19dd
JB
1139
1140/* Print an integer.
1141 */
1cc91f1b 1142
0f2d19dd 1143void
a406c9e9 1144scm_intprint (scm_t_intmax n, int radix, SCM port)
0f2d19dd
JB
1145{
1146 char num_buf[SCM_INTBUFLEN];
b7f3516f 1147 scm_lfwrite (num_buf, scm_iint2str (n, radix, num_buf), port);
0f2d19dd
JB
1148}
1149
a406c9e9
MV
1150void
1151scm_uintprint (scm_t_uintmax n, int radix, SCM port)
1152{
1153 char num_buf[SCM_INTBUFLEN];
1154 scm_lfwrite (num_buf, scm_iuint2str (n, radix, num_buf), port);
1155}
1156
0f2d19dd
JB
1157/* Print an object of unrecognized type.
1158 */
1cc91f1b 1159
0f2d19dd 1160void
1bbd0b84 1161scm_ipruk (char *hdr, SCM ptr, SCM port)
0f2d19dd 1162{
b7f3516f
TT
1163 scm_puts ("#<unknown-", port);
1164 scm_puts (hdr, port);
26224b3f 1165 if (1) /* (scm_in_heap_p (ptr)) */ /* FIXME */
0f2d19dd 1166 {
b7f3516f 1167 scm_puts (" (0x", port);
0345e278 1168 scm_uintprint (SCM_CELL_WORD_0 (ptr), 16, port);
b7f3516f 1169 scm_puts (" . 0x", port);
0345e278 1170 scm_uintprint (SCM_CELL_WORD_1 (ptr), 16, port);
b7f3516f 1171 scm_puts (") @", port);
0f2d19dd 1172 }
b7f3516f 1173 scm_puts (" 0x", port);
0345e278 1174 scm_uintprint (SCM_UNPACK (ptr), 16, port);
b7f3516f 1175 scm_putc ('>', port);
0f2d19dd
JB
1176}
1177
1cc91f1b 1178
904a077d 1179/* Print a list.
22a52da1 1180 */
0f2d19dd 1181void
34d19ef6 1182scm_iprlist (char *hdr, SCM exp, int tlr, SCM port, scm_print_state *pstate)
0f2d19dd 1183{
c62fbfe1 1184 register SCM hare, tortoise;
c014a02e 1185 long floor = pstate->top - 2;
b7f3516f 1186 scm_puts (hdr, port);
0f2d19dd 1187 /* CHECK_INTS; */
c62fbfe1
MD
1188 if (pstate->fancyp)
1189 goto fancy_printing;
1190
1191 /* Run a hare and tortoise so that total time complexity will be
1192 O(depth * N) instead of O(N^2). */
1193 hare = SCM_CDR (exp);
1194 tortoise = exp;
d2e53ed6 1195 while (scm_is_pair (hare))
c62fbfe1 1196 {
bc36d050 1197 if (scm_is_eq (hare, tortoise))
c62fbfe1
MD
1198 goto fancy_printing;
1199 hare = SCM_CDR (hare);
d2e53ed6 1200 if (!scm_is_pair (hare))
c62fbfe1
MD
1201 break;
1202 hare = SCM_CDR (hare);
1203 tortoise = SCM_CDR (tortoise);
1204 }
1205
1206 /* No cdr cycles intrinsic to this list */
1207 scm_iprin1 (SCM_CAR (exp), port, pstate);
d2e53ed6 1208 for (exp = SCM_CDR (exp); scm_is_pair (exp); exp = SCM_CDR (exp))
0f2d19dd 1209 {
c014a02e 1210 register long i;
5ca6dc39 1211
c62fbfe1 1212 for (i = floor; i >= 0; --i)
509759dd 1213 if (scm_is_eq (PSTATE_STACK_REF(pstate, i), exp))
c62fbfe1
MD
1214 goto circref;
1215 PUSH_REF (pstate, exp);
b7f3516f 1216 scm_putc (' ', port);
0f2d19dd 1217 /* CHECK_INTS; */
c62fbfe1 1218 scm_iprin1 (SCM_CAR (exp), port, pstate);
0f2d19dd 1219 }
c96d76b8 1220 if (!SCM_NULL_OR_NIL_P (exp))
0f2d19dd 1221 {
b7f3516f 1222 scm_puts (" . ", port);
c62fbfe1 1223 scm_iprin1 (exp, port, pstate);
0f2d19dd 1224 }
c62fbfe1 1225
a51ea417 1226end:
b7f3516f 1227 scm_putc (tlr, port);
c62fbfe1 1228 pstate->top = floor + 2;
a51ea417 1229 return;
c62fbfe1
MD
1230
1231fancy_printing:
1232 {
c014a02e 1233 long n = pstate->length;
c62fbfe1
MD
1234
1235 scm_iprin1 (SCM_CAR (exp), port, pstate);
1236 exp = SCM_CDR (exp); --n;
d2e53ed6 1237 for (; scm_is_pair (exp); exp = SCM_CDR (exp))
c62fbfe1 1238 {
c014a02e 1239 register unsigned long i;
5ca6dc39 1240
c62fbfe1 1241 for (i = 0; i < pstate->top; ++i)
509759dd 1242 if (scm_is_eq (PSTATE_STACK_REF(pstate, i), exp))
c62fbfe1
MD
1243 goto fancy_circref;
1244 if (pstate->fancyp)
1245 {
1246 if (n == 0)
1247 {
b7f3516f 1248 scm_puts (" ...", port);
c62fbfe1
MD
1249 goto skip_tail;
1250 }
1251 else
1252 --n;
1253 }
1254 PUSH_REF(pstate, exp);
1255 ++pstate->list_offset;
b7f3516f 1256 scm_putc (' ', port);
c62fbfe1
MD
1257 /* CHECK_INTS; */
1258 scm_iprin1 (SCM_CAR (exp), port, pstate);
1259 }
1260 }
c96d76b8 1261 if (!SCM_NULL_OR_NIL_P (exp))
c62fbfe1 1262 {
b7f3516f 1263 scm_puts (" . ", port);
c62fbfe1
MD
1264 scm_iprin1 (exp, port, pstate);
1265 }
1266skip_tail:
1267 pstate->list_offset -= pstate->top - floor - 2;
a51ea417 1268 goto end;
a51ea417 1269
c62fbfe1
MD
1270fancy_circref:
1271 pstate->list_offset -= pstate->top - floor - 2;
1272
1273circref:
b7f3516f 1274 scm_puts (" . ", port);
c62fbfe1
MD
1275 print_circref (port, pstate, exp);
1276 goto end;
0f2d19dd
JB
1277}
1278
1279\f
1280
bb35f315
MV
1281int
1282scm_valid_oport_value_p (SCM val)
1283{
368cf54d
GB
1284 return (SCM_OPOUTPORTP (val)
1285 || (SCM_PORT_WITH_PS_P (val)
1286 && SCM_OPOUTPORTP (SCM_PORT_WITH_PS_PORT (val))));
bb35f315
MV
1287}
1288
8b840115 1289/* SCM_GPROC(s_write, "write", 1, 1, 0, scm_write, g_write); */
1cc91f1b 1290
0f2d19dd 1291SCM
1bbd0b84 1292scm_write (SCM obj, SCM port)
0f2d19dd
JB
1293{
1294 if (SCM_UNBNDP (port))
9de87eea 1295 port = scm_current_output_port ();
3eb7e6ee
JB
1296
1297 SCM_ASSERT (scm_valid_oport_value_p (port), port, SCM_ARG2, s_write);
bb35f315 1298
a51ea417 1299 scm_prin1 (obj, port, 1);
0f2d19dd
JB
1300 return SCM_UNSPECIFIED;
1301}
1302
1303
8b840115 1304/* SCM_GPROC(s_display, "display", 1, 1, 0, scm_display, g_display); */
1cc91f1b 1305
0f2d19dd 1306SCM
1bbd0b84 1307scm_display (SCM obj, SCM port)
0f2d19dd
JB
1308{
1309 if (SCM_UNBNDP (port))
9de87eea 1310 port = scm_current_output_port ();
3eb7e6ee
JB
1311
1312 SCM_ASSERT (scm_valid_oport_value_p (port), port, SCM_ARG2, s_display);
bb35f315 1313
a51ea417 1314 scm_prin1 (obj, port, 0);
0f2d19dd
JB
1315 return SCM_UNSPECIFIED;
1316}
1317
70d63753
GB
1318
1319SCM_DEFINE (scm_simple_format, "simple-format", 2, 0, 1,
1320 (SCM destination, SCM message, SCM args),
eca65e90
MG
1321 "Write @var{message} to @var{destination}, defaulting to\n"
1322 "the current output port.\n"
1323 "@var{message} can contain @code{~A} (was @code{%s}) and\n"
1324 "@code{~S} (was @code{%S}) escapes. When printed,\n"
1325 "the escapes are replaced with corresponding members of\n"
1326 "@var{ARGS}:\n"
1327 "@code{~A} formats using @code{display} and @code{~S} formats\n"
1328 "using @code{write}.\n"
1329 "If @var{destination} is @code{#t}, then use the current output\n"
1330 "port, if @var{destination} is @code{#f}, then return a string\n"
1331 "containing the formatted text. Does not add a trailing newline.")
70d63753
GB
1332#define FUNC_NAME s_scm_simple_format
1333{
dfd03fb9 1334 SCM port, answer = SCM_UNSPECIFIED;
70d63753
GB
1335 int fReturnString = 0;
1336 int writingp;
889975e5 1337 size_t start, p, end;
70d63753 1338
bc36d050 1339 if (scm_is_eq (destination, SCM_BOOL_T))
daba1a71 1340 {
9de87eea 1341 destination = port = scm_current_output_port ();
daba1a71 1342 }
7888309b 1343 else if (scm_is_false (destination))
daba1a71
MD
1344 {
1345 fReturnString = 1;
0b2c2ba3 1346 port = scm_mkstrport (SCM_INUM0, SCM_BOOL_F,
dfd03fb9
MD
1347 SCM_OPN | SCM_WRTNG,
1348 FUNC_NAME);
1349 destination = port;
daba1a71
MD
1350 }
1351 else
1352 {
1353 SCM_VALIDATE_OPORT_VALUE (1, destination);
dfd03fb9 1354 port = SCM_COERCE_OUTPORT (destination);
daba1a71
MD
1355 }
1356 SCM_VALIDATE_STRING (2, message);
af45e3b0 1357 SCM_VALIDATE_REST_ARGUMENT (args);
70d63753 1358
889975e5
MG
1359 p = 0;
1360 start = 0;
1361 end = scm_i_string_length (message);
b24b5e13 1362 for (p = start; p != end; ++p)
889975e5 1363 if (scm_i_string_ref (message, p) == '~')
70d63753 1364 {
b24b5e13 1365 if (++p == end)
6662998f
MV
1366 break;
1367
889975e5 1368 switch (scm_i_string_ref (message, p))
6662998f
MV
1369 {
1370 case 'A': case 'a':
1371 writingp = 0;
1372 break;
1373 case 'S': case 's':
1374 writingp = 1;
1375 break;
1376 case '~':
889975e5 1377 scm_lfwrite_substr (message, start, p, port);
6662998f
MV
1378 start = p + 1;
1379 continue;
1380 case '%':
889975e5 1381 scm_lfwrite_substr (message, start, p - 1, port);
dfd03fb9 1382 scm_newline (port);
6662998f
MV
1383 start = p + 1;
1384 continue;
1385 default:
1afff620 1386 SCM_MISC_ERROR ("FORMAT: Unsupported format option ~~~A - use (ice-9 format) instead",
889975e5 1387 scm_list_1 (SCM_MAKE_CHAR (scm_i_string_ref (message, p))));
6662998f
MV
1388
1389 }
70d63753 1390
6662998f 1391
d2e53ed6 1392 if (!scm_is_pair (args))
1afff620 1393 SCM_MISC_ERROR ("FORMAT: Missing argument for ~~~A",
889975e5 1394 scm_list_1 (SCM_MAKE_CHAR (scm_i_string_ref (message, p))));
6662998f 1395
889975e5 1396 scm_lfwrite_substr (message, start, p - 1, port);
dfd03fb9 1397 /* we pass destination here */
70d63753
GB
1398 scm_prin1 (SCM_CAR (args), destination, writingp);
1399 args = SCM_CDR (args);
1400 start = p + 1;
1401 }
6662998f 1402
889975e5 1403 scm_lfwrite_substr (message, start, p, port);
bc36d050 1404 if (!scm_is_eq (args, SCM_EOL))
1afff620
KN
1405 SCM_MISC_ERROR ("FORMAT: ~A superfluous arguments",
1406 scm_list_1 (scm_length (args)));
70d63753
GB
1407
1408 if (fReturnString)
1409 answer = scm_strport_to_string (destination);
1410
daba1a71 1411 return scm_return_first (answer, message);
70d63753
GB
1412}
1413#undef FUNC_NAME
1414
1415
3b3b36dd 1416SCM_DEFINE (scm_newline, "newline", 0, 1, 0,
b450f070 1417 (SCM port),
8f85c0c6
NJ
1418 "Send a newline to @var{port}.\n"
1419 "If @var{port} is omitted, send to the current output port.")
1bbd0b84 1420#define FUNC_NAME s_scm_newline
0f2d19dd
JB
1421{
1422 if (SCM_UNBNDP (port))
9de87eea 1423 port = scm_current_output_port ();
3eb7e6ee 1424
34d19ef6 1425 SCM_VALIDATE_OPORT_VALUE (1, port);
bb35f315 1426
0ef4ae82 1427 scm_putc ('\n', SCM_COERCE_OUTPORT (port));
0f2d19dd
JB
1428 return SCM_UNSPECIFIED;
1429}
1bbd0b84 1430#undef FUNC_NAME
0f2d19dd 1431
3b3b36dd 1432SCM_DEFINE (scm_write_char, "write-char", 1, 1, 0,
b450f070 1433 (SCM chr, SCM port),
eca65e90 1434 "Send character @var{chr} to @var{port}.")
1bbd0b84 1435#define FUNC_NAME s_scm_write_char
0f2d19dd
JB
1436{
1437 if (SCM_UNBNDP (port))
9de87eea 1438 port = scm_current_output_port ();
3eb7e6ee 1439
34d19ef6
HWN
1440 SCM_VALIDATE_CHAR (1, chr);
1441 SCM_VALIDATE_OPORT_VALUE (2, port);
07f49ac7
LC
1442
1443 port = SCM_COERCE_OUTPORT (port);
1444 if (!display_character (SCM_CHAR (chr), port,
1445 scm_i_get_conversion_strategy (port)))
1446 scm_encoding_error (__func__, errno,
1447 "cannot convert to output locale",
6851d3be 1448 port, chr);
07f49ac7 1449
0f2d19dd
JB
1450 return SCM_UNSPECIFIED;
1451}
1bbd0b84 1452#undef FUNC_NAME
0f2d19dd 1453
0f2d19dd
JB
1454\f
1455
bb35f315 1456/* Call back to Scheme code to do the printing of special objects
c19bc088
MD
1457 * (like structs). SCM_PRINTER_APPLY applies PROC to EXP and a smob
1458 * containing PORT and PSTATE. This object can be used as the port for
1459 * display/write etc to continue the current print chain. The REVEALED
1460 * field of PSTATE is set to true to indicate that the print state has
1461 * escaped to Scheme and thus has to be freed by the GC.
1462 */
1463
92c2555f 1464scm_t_bits scm_tc16_port_with_ps;
c19bc088
MD
1465
1466/* Print exactly as the port itself would */
1467
1468static int
e841c3e0 1469port_with_ps_print (SCM obj, SCM port, scm_print_state *pstate)
c19bc088
MD
1470{
1471 obj = SCM_PORT_WITH_PS_PORT (obj);
1472 return scm_ptobs[SCM_PTOBNUM (obj)].print (obj, port, pstate);
1473}
c4f37e80
MV
1474
1475SCM
1bbd0b84 1476scm_printer_apply (SCM proc, SCM exp, SCM port, scm_print_state *pstate)
c4f37e80 1477{
bb35f315 1478 pstate->revealed = 1;
dfd03fb9
MD
1479 return scm_call_2 (proc, exp,
1480 scm_i_port_with_print_state (port, pstate->handle));
c19bc088
MD
1481}
1482
dfd03fb9 1483SCM_DEFINE (scm_port_with_print_state, "port-with-print-state", 1, 1, 0,
1bbd0b84 1484 (SCM port, SCM pstate),
71331188 1485 "Create a new port which behaves like @var{port}, but with an\n"
dfd03fb9
MD
1486 "included print state @var{pstate}. @var{pstate} is optional.\n"
1487 "If @var{pstate} isn't supplied and @var{port} already has\n"
1488 "a print state, the old print state is reused.")
1bbd0b84 1489#define FUNC_NAME s_scm_port_with_print_state
c19bc088 1490{
34d19ef6 1491 SCM_VALIDATE_OPORT_VALUE (1, port);
dfd03fb9
MD
1492 if (!SCM_UNBNDP (pstate))
1493 SCM_VALIDATE_PRINTSTATE (2, pstate);
1494 return scm_i_port_with_print_state (port, pstate);
c19bc088 1495}
1bbd0b84 1496#undef FUNC_NAME
c19bc088 1497
a1ec6916 1498SCM_DEFINE (scm_get_print_state, "get-print-state", 1, 0, 0,
1bbd0b84 1499 (SCM port),
71331188
MG
1500 "Return the print state of the port @var{port}. If @var{port}\n"
1501 "has no associated print state, @code{#f} is returned.")
1bbd0b84 1502#define FUNC_NAME s_scm_get_print_state
c19bc088 1503{
368cf54d
GB
1504 if (SCM_PORT_WITH_PS_P (port))
1505 return SCM_PORT_WITH_PS_PS (port);
f5f2dcff 1506 if (SCM_OUTPUT_PORT_P (port))
368cf54d 1507 return SCM_BOOL_F;
276dd677 1508 SCM_WRONG_TYPE_ARG (1, port);
c4f37e80 1509}
1bbd0b84 1510#undef FUNC_NAME
bb35f315 1511
c4f37e80 1512\f
1cc91f1b 1513
0f2d19dd
JB
1514void
1515scm_init_print ()
0f2d19dd 1516{
c19bc088 1517 SCM vtable, layout, type;
d5cf5324 1518
62560650 1519 scm_init_opts (scm_print_options, scm_print_opts);
d5cf5324 1520
4a655e50 1521 scm_print_options (scm_list_4 (scm_from_latin1_symbol ("highlight-prefix"),
81ae25da 1522 scm_from_locale_string ("{"),
4a655e50 1523 scm_from_latin1_symbol ("highlight-suffix"),
81ae25da
MV
1524 scm_from_locale_string ("}")));
1525
d5cf5324
DH
1526 scm_gc_register_root (&print_state_pool);
1527 scm_gc_register_root (&scm_print_state_vtable);
3ce4544c 1528 vtable = scm_make_vtable_vtable (scm_nullstr, SCM_INUM0, SCM_EOL);
cc95e00a
MV
1529 layout =
1530 scm_make_struct_layout (scm_from_locale_string (SCM_PRINT_STATE_LAYOUT));
1afff620 1531 type = scm_make_struct (vtable, SCM_INUM0, scm_list_1 (layout));
4a655e50 1532 scm_set_struct_vtable_name_x (type, scm_from_latin1_symbol ("print-state"));
bb35f315 1533 scm_print_state_vtable = type;
c4f37e80 1534
c19bc088
MD
1535 /* Don't want to bind a wrapper class in GOOPS, so pass 0 as arg1. */
1536 scm_tc16_port_with_ps = scm_make_smob_type (0, 0);
e841c3e0 1537 scm_set_smob_print (scm_tc16_port_with_ps, port_with_ps_print);
81ae25da 1538
a0599745 1539#include "libguile/print.x"
475fa9a5
MV
1540
1541 scm_print_opts[SCM_PRINT_KEYWORD_STYLE_I].val = SCM_UNPACK (sym_reader);
0f2d19dd 1542}
89e00824
ML
1543
1544/*
1545 Local Variables:
1546 c-file-style: "gnu"
1547 End:
1548*/