(timer): Define as a defstruct, so we can name the fields, to make the
[emacs.git] / src / charset.c
blob5fe7e43a7a8f1325451e6555aa7e239b3772b0da
1 /* Basic character set support.
2 Copyright (C) 2001, 2002, 2003, 2004, 2005,
3 2006, 2007, 2008 Free Software Foundation, Inc.
4 Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
5 2005, 2006, 2007, 2008
6 National Institute of Advanced Industrial Science and Technology (AIST)
7 Registration Number H14PRO021
9 Copyright (C) 2003, 2004
10 National Institute of Advanced Industrial Science and Technology (AIST)
11 Registration Number H13PRO009
13 This file is part of GNU Emacs.
15 GNU Emacs is free software; you can redistribute it and/or modify
16 it under the terms of the GNU General Public License as published by
17 the Free Software Foundation; either version 3, or (at your option)
18 any later version.
20 GNU Emacs is distributed in the hope that it will be useful,
21 but WITHOUT ANY WARRANTY; without even the implied warranty of
22 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
23 GNU General Public License for more details.
25 You should have received a copy of the GNU General Public License
26 along with GNU Emacs; see the file COPYING. If not, write to
27 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
28 Boston, MA 02110-1301, USA. */
30 #include <config.h>
32 #include <stdio.h>
33 #include <unistd.h>
34 #include <ctype.h>
35 #include <sys/types.h>
36 #include "lisp.h"
37 #include "character.h"
38 #include "charset.h"
39 #include "coding.h"
40 #include "disptab.h"
41 #include "buffer.h"
43 /*** GENERAL NOTES on CODED CHARACTER SETS (CHARSETS) ***
45 A coded character set ("charset" hereafter) is a meaningful
46 collection (i.e. language, culture, functionality, etc.) of
47 characters. Emacs handles multiple charsets at once. In Emacs Lisp
48 code, a charset is represented by a symbol. In C code, a charset is
49 represented by its ID number or by a pointer to a struct charset.
51 The actual information about each charset is stored in two places.
52 Lispy information is stored in the hash table Vcharset_hash_table as
53 a vector (charset attributes). The other information is stored in
54 charset_table as a struct charset.
58 /* List of all charsets. This variable is used only from Emacs
59 Lisp. */
60 Lisp_Object Vcharset_list;
62 /* Hash table that contains attributes of each charset. Keys are
63 charset symbols, and values are vectors of charset attributes. */
64 Lisp_Object Vcharset_hash_table;
66 /* Table of struct charset. */
67 struct charset *charset_table;
69 static int charset_table_size;
70 static int charset_table_used;
72 Lisp_Object Qcharsetp;
74 /* Special charset symbols. */
75 Lisp_Object Qascii;
76 Lisp_Object Qeight_bit;
77 Lisp_Object Qiso_8859_1;
78 Lisp_Object Qunicode;
80 /* The corresponding charsets. */
81 int charset_ascii;
82 int charset_eight_bit;
83 int charset_iso_8859_1;
84 int charset_unicode;
86 /* The other special charsets. */
87 int charset_jisx0201_roman;
88 int charset_jisx0208_1978;
89 int charset_jisx0208;
91 /* Value of charset attribute `charset-iso-plane'. */
92 Lisp_Object Qgl, Qgr;
94 /* Charset of unibyte characters. */
95 int charset_unibyte;
97 /* List of charsets ordered by the priority. */
98 Lisp_Object Vcharset_ordered_list;
100 /* Incremented everytime we change Vcharset_ordered_list. This is
101 unsigned short so that it fits in Lisp_Int and never matches
102 -1. */
103 unsigned short charset_ordered_list_tick;
105 /* List of iso-2022 charsets. */
106 Lisp_Object Viso_2022_charset_list;
108 /* List of emacs-mule charsets. */
109 Lisp_Object Vemacs_mule_charset_list;
111 struct charset *emacs_mule_charset[256];
113 /* Mapping table from ISO2022's charset (specified by DIMENSION,
114 CHARS, and FINAL-CHAR) to Emacs' charset. */
115 int iso_charset_table[ISO_MAX_DIMENSION][ISO_MAX_CHARS][ISO_MAX_FINAL];
117 Lisp_Object Vcharset_map_path;
119 Lisp_Object Vchar_unified_charset_table;
121 /* Defined in chartab.c */
122 extern void
123 map_char_table_for_charset P_ ((void (*c_function) (Lisp_Object, Lisp_Object),
124 Lisp_Object function, Lisp_Object table,
125 Lisp_Object arg, struct charset *charset,
126 unsigned from, unsigned to));
128 #define CODE_POINT_TO_INDEX(charset, code) \
129 ((charset)->code_linear_p \
130 ? (code) - (charset)->min_code \
131 : (((charset)->code_space_mask[(code) >> 24] & 0x8) \
132 && ((charset)->code_space_mask[((code) >> 16) & 0xFF] & 0x4) \
133 && ((charset)->code_space_mask[((code) >> 8) & 0xFF] & 0x2) \
134 && ((charset)->code_space_mask[(code) & 0xFF] & 0x1)) \
135 ? (((((code) >> 24) - (charset)->code_space[12]) \
136 * (charset)->code_space[11]) \
137 + (((((code) >> 16) & 0xFF) - (charset)->code_space[8]) \
138 * (charset)->code_space[7]) \
139 + (((((code) >> 8) & 0xFF) - (charset)->code_space[4]) \
140 * (charset)->code_space[3]) \
141 + (((code) & 0xFF) - (charset)->code_space[0]) \
142 - ((charset)->char_index_offset)) \
143 : -1)
146 /* Convert the character index IDX to code-point CODE for CHARSET.
147 It is assumed that IDX is in a valid range. */
149 #define INDEX_TO_CODE_POINT(charset, idx) \
150 ((charset)->code_linear_p \
151 ? (idx) + (charset)->min_code \
152 : (idx += (charset)->char_index_offset, \
153 (((charset)->code_space[0] + (idx) % (charset)->code_space[2]) \
154 | (((charset)->code_space[4] \
155 + ((idx) / (charset)->code_space[3] % (charset)->code_space[6])) \
156 << 8) \
157 | (((charset)->code_space[8] \
158 + ((idx) / (charset)->code_space[7] % (charset)->code_space[10])) \
159 << 16) \
160 | (((charset)->code_space[12] + ((idx) / (charset)->code_space[11])) \
161 << 24))))
166 /* Set to 1 to warn that a charset map is loaded and thus a buffer
167 text and a string data may be relocated. */
168 int charset_map_loaded;
170 struct charset_map_entries
172 struct {
173 unsigned from, to;
174 int c;
175 } entry[0x10000];
176 struct charset_map_entries *next;
179 /* Load the mapping information for CHARSET from ENTRIES.
181 If CONTROL_FLAG is 0, setup CHARSET->min_char and CHARSET->max_char.
183 If CONTROL_FLAG is 1, setup CHARSET->min_char, CHARSET->max_char,
184 CHARSET->decoder, and CHARSET->encoder.
186 If CONTROL_FLAG is 2, setup CHARSET->deunifier and
187 Vchar_unify_table. If Vchar_unified_charset_table is non-nil,
188 setup it too. */
190 static void
191 load_charset_map (charset, entries, n_entries, control_flag)
192 struct charset *charset;
193 struct charset_map_entries *entries;
194 int n_entries;
195 int control_flag;
197 Lisp_Object vec, table;
198 unsigned max_code = CHARSET_MAX_CODE (charset);
199 int ascii_compatible_p = charset->ascii_compatible_p;
200 int min_char, max_char, nonascii_min_char;
201 int i;
202 unsigned char *fast_map = charset->fast_map;
204 if (n_entries <= 0)
205 return;
207 if (control_flag > 0)
209 int n = CODE_POINT_TO_INDEX (charset, max_code) + 1;
211 table = Fmake_char_table (Qnil, Qnil);
212 if (control_flag == 1)
213 vec = Fmake_vector (make_number (n), make_number (-1));
214 else if (! CHAR_TABLE_P (Vchar_unify_table))
215 Vchar_unify_table = Fmake_char_table (Qnil, Qnil);
217 charset_map_loaded = 1;
220 min_char = max_char = entries->entry[0].c;
221 nonascii_min_char = MAX_CHAR;
222 for (i = 0; i < n_entries; i++)
224 unsigned from, to;
225 int from_index, to_index;
226 int from_c, to_c;
227 int idx = i % 0x10000;
229 if (i > 0 && idx == 0)
230 entries = entries->next;
231 from = entries->entry[idx].from;
232 to = entries->entry[idx].to;
233 from_c = entries->entry[idx].c;
234 from_index = CODE_POINT_TO_INDEX (charset, from);
235 if (from == to)
237 to_index = from_index;
238 to_c = from_c;
240 else
242 to_index = CODE_POINT_TO_INDEX (charset, to);
243 to_c = from_c + (to_index - from_index);
245 if (from_index < 0 || to_index < 0)
246 continue;
248 if (control_flag < 2)
250 int c;
252 if (to_c > max_char)
253 max_char = to_c;
254 else if (from_c < min_char)
255 min_char = from_c;
256 if (ascii_compatible_p)
258 if (! ASCII_BYTE_P (from_c))
260 if (from_c < nonascii_min_char)
261 nonascii_min_char = from_c;
263 else if (! ASCII_BYTE_P (to_c))
265 nonascii_min_char = 0x80;
269 for (c = from_c; c <= to_c; c++)
270 CHARSET_FAST_MAP_SET (c, fast_map);
272 if (control_flag == 1)
274 unsigned code = from;
276 if (CHARSET_COMPACT_CODES_P (charset))
277 while (1)
279 ASET (vec, from_index, make_number (from_c));
280 if (NILP (CHAR_TABLE_REF (table, from_c)))
281 CHAR_TABLE_SET (table, from_c, make_number (code));
282 if (from_index == to_index)
283 break;
284 from_index++, from_c++;
285 code = INDEX_TO_CODE_POINT (charset, from_index);
287 else
288 for (; from_index <= to_index; from_index++, from_c++)
290 ASET (vec, from_index, make_number (from_c));
291 if (NILP (CHAR_TABLE_REF (table, from_c)))
292 CHAR_TABLE_SET (table, from_c, make_number (from_index));
296 else
298 unsigned code = from;
300 while (1)
302 int c1 = DECODE_CHAR (charset, code);
304 if (c1 >= 0)
306 CHAR_TABLE_SET (table, from_c, make_number (c1));
307 CHAR_TABLE_SET (Vchar_unify_table, c1, make_number (from_c));
308 if (CHAR_TABLE_P (Vchar_unified_charset_table))
309 CHAR_TABLE_SET (Vchar_unified_charset_table, c1,
310 CHARSET_NAME (charset));
312 if (from_index == to_index)
313 break;
314 from_index++, from_c++;
315 code = INDEX_TO_CODE_POINT (charset, from_index);
320 if (control_flag < 2)
322 CHARSET_MIN_CHAR (charset) = (ascii_compatible_p
323 ? nonascii_min_char : min_char);
324 CHARSET_MAX_CHAR (charset) = max_char;
325 if (control_flag == 1)
327 CHARSET_DECODER (charset) = vec;
328 CHARSET_ENCODER (charset) = table;
331 else
332 CHARSET_DEUNIFIER (charset) = table;
336 /* Read a hexadecimal number (preceded by "0x") from the file FP while
337 paying attention to comment charcter '#'. */
339 static INLINE unsigned
340 read_hex (fp, eof)
341 FILE *fp;
342 int *eof;
344 int c;
345 unsigned n;
347 while ((c = getc (fp)) != EOF)
349 if (c == '#')
351 while ((c = getc (fp)) != EOF && c != '\n');
353 else if (c == '0')
355 if ((c = getc (fp)) == EOF || c == 'x')
356 break;
359 if (c == EOF)
361 *eof = 1;
362 return 0;
364 *eof = 0;
365 n = 0;
366 if (c == 'x')
367 while ((c = getc (fp)) != EOF && isxdigit (c))
368 n = ((n << 4)
369 | (c <= '9' ? c - '0' : c <= 'F' ? c - 'A' + 10 : c - 'a' + 10));
370 else
371 while ((c = getc (fp)) != EOF && isdigit (c))
372 n = (n * 10) + c - '0';
373 if (c != EOF)
374 ungetc (c, fp);
375 return n;
379 /* Return a mapping vector for CHARSET loaded from MAPFILE.
380 Each line of MAPFILE has this form
381 0xAAAA 0xCCCC
382 where 0xAAAA is a code-point and 0xCCCC is the corresponding
383 character code, or this form
384 0xAAAA-0xBBBB 0xCCCC
385 where 0xAAAA and 0xBBBB are code-points specifying a range, and
386 0xCCCC is the first character code of the range.
388 The returned vector has this form:
389 [ CODE1 CHAR1 CODE2 CHAR2 .... ]
390 where CODE1 is a code-point or a cons of code-points specifying a
391 range. */
393 extern void add_to_log P_ ((char *, Lisp_Object, Lisp_Object));
395 static void
396 load_charset_map_from_file (charset, mapfile, control_flag)
397 struct charset *charset;
398 Lisp_Object mapfile;
399 int control_flag;
401 unsigned min_code = CHARSET_MIN_CODE (charset);
402 unsigned max_code = CHARSET_MAX_CODE (charset);
403 int fd;
404 FILE *fp;
405 int eof;
406 Lisp_Object suffixes;
407 struct charset_map_entries *head, *entries;
408 int n_entries;
410 suffixes = Fcons (build_string (".map"),
411 Fcons (build_string (".TXT"), Qnil));
413 fd = openp (Vcharset_map_path, mapfile, suffixes, NULL, Qnil);
414 if (fd < 0
415 || ! (fp = fdopen (fd, "r")))
417 add_to_log ("Failure in loading charset map: %S", mapfile, Qnil);
418 return;
421 head = entries = ((struct charset_map_entries *)
422 alloca (sizeof (struct charset_map_entries)));
423 n_entries = 0;
424 eof = 0;
425 while (1)
427 unsigned from, to;
428 int c;
429 int idx;
431 from = read_hex (fp, &eof);
432 if (eof)
433 break;
434 if (getc (fp) == '-')
435 to = read_hex (fp, &eof);
436 else
437 to = from;
438 c = (int) read_hex (fp, &eof);
440 if (from < min_code || to > max_code || from > to || c > MAX_CHAR)
441 continue;
443 if (n_entries > 0 && (n_entries % 0x10000) == 0)
445 entries->next = ((struct charset_map_entries *)
446 alloca (sizeof (struct charset_map_entries)));
447 entries = entries->next;
449 idx = n_entries % 0x10000;
450 entries->entry[idx].from = from;
451 entries->entry[idx].to = to;
452 entries->entry[idx].c = c;
453 n_entries++;
455 fclose (fp);
456 close (fd);
458 load_charset_map (charset, head, n_entries, control_flag);
461 static void
462 load_charset_map_from_vector (charset, vec, control_flag)
463 struct charset *charset;
464 Lisp_Object vec;
465 int control_flag;
467 unsigned min_code = CHARSET_MIN_CODE (charset);
468 unsigned max_code = CHARSET_MAX_CODE (charset);
469 struct charset_map_entries *head, *entries;
470 int n_entries;
471 int len = ASIZE (vec);
472 int i;
474 if (len % 2 == 1)
476 add_to_log ("Failure in loading charset map: %V", vec, Qnil);
477 return;
480 head = entries = ((struct charset_map_entries *)
481 alloca (sizeof (struct charset_map_entries)));
482 n_entries = 0;
483 for (i = 0; i < len; i += 2)
485 Lisp_Object val, val2;
486 unsigned from, to;
487 int c;
488 int idx;
490 val = AREF (vec, i);
491 if (CONSP (val))
493 val2 = XCDR (val);
494 val = XCAR (val);
495 CHECK_NATNUM (val);
496 CHECK_NATNUM (val2);
497 from = XFASTINT (val);
498 to = XFASTINT (val2);
500 else
502 CHECK_NATNUM (val);
503 from = to = XFASTINT (val);
505 val = AREF (vec, i + 1);
506 CHECK_NATNUM (val);
507 c = XFASTINT (val);
509 if (from < min_code || to > max_code || from > to || c > MAX_CHAR)
510 continue;
512 if (n_entries > 0 && (n_entries % 0x10000) == 0)
514 entries->next = ((struct charset_map_entries *)
515 alloca (sizeof (struct charset_map_entries)));
516 entries = entries->next;
518 idx = n_entries % 0x10000;
519 entries->entry[idx].from = from;
520 entries->entry[idx].to = to;
521 entries->entry[idx].c = c;
522 n_entries++;
525 load_charset_map (charset, head, n_entries, control_flag);
528 static void
529 load_charset (charset)
530 struct charset *charset;
532 if (CHARSET_METHOD (charset) == CHARSET_METHOD_MAP_DEFERRED)
534 Lisp_Object map;
536 map = CHARSET_MAP (charset);
537 if (STRINGP (map))
538 load_charset_map_from_file (charset, map, 1);
539 else
540 load_charset_map_from_vector (charset, map, 1);
541 CHARSET_METHOD (charset) = CHARSET_METHOD_MAP;
546 DEFUN ("charsetp", Fcharsetp, Scharsetp, 1, 1, 0,
547 doc: /* Return non-nil if and only if OBJECT is a charset.*/)
548 (object)
549 Lisp_Object object;
551 return (CHARSETP (object) ? Qt : Qnil);
555 void
556 map_charset_chars (c_function, function, arg,
557 charset, from, to)
558 void (*c_function) P_ ((Lisp_Object, Lisp_Object));
559 Lisp_Object function, arg;
560 struct charset *charset;
561 unsigned from, to;
563 Lisp_Object range;
564 int partial;
566 if (CHARSET_METHOD (charset) == CHARSET_METHOD_MAP_DEFERRED)
567 load_charset (charset);
569 partial = (from > CHARSET_MIN_CODE (charset)
570 || to < CHARSET_MAX_CODE (charset));
572 if (CHARSET_UNIFIED_P (charset)
573 && CHAR_TABLE_P (CHARSET_DEUNIFIER (charset)))
575 map_char_table_for_charset (c_function, function,
576 CHARSET_DEUNIFIER (charset), arg,
577 partial ? charset : NULL, from, to);
580 if (CHARSET_METHOD (charset) == CHARSET_METHOD_OFFSET)
582 int from_idx = CODE_POINT_TO_INDEX (charset, from);
583 int to_idx = CODE_POINT_TO_INDEX (charset, to);
584 int from_c = from_idx + CHARSET_CODE_OFFSET (charset);
585 int to_c = to_idx + CHARSET_CODE_OFFSET (charset);
587 range = Fcons (make_number (from_c), make_number (to_c));
588 if (NILP (function))
589 (*c_function) (arg, range);
590 else
591 call2 (function, range, arg);
593 else if (CHARSET_METHOD (charset) == CHARSET_METHOD_MAP)
595 if (! CHAR_TABLE_P (CHARSET_ENCODER (charset)))
596 return;
597 map_char_table_for_charset (c_function, function,
598 CHARSET_ENCODER (charset), arg,
599 partial ? charset : NULL, from, to);
601 else if (CHARSET_METHOD (charset) == CHARSET_METHOD_SUBSET)
603 Lisp_Object subset_info;
604 int offset;
606 subset_info = CHARSET_SUBSET (charset);
607 charset = CHARSET_FROM_ID (XFASTINT (AREF (subset_info, 0)));
608 offset = XINT (AREF (subset_info, 3));
609 from -= offset;
610 if (from < XFASTINT (AREF (subset_info, 1)))
611 from = XFASTINT (AREF (subset_info, 1));
612 to -= offset;
613 if (to > XFASTINT (AREF (subset_info, 2)))
614 to = XFASTINT (AREF (subset_info, 2));
615 map_charset_chars (c_function, function, arg, charset, from, to);
617 else /* i.e. CHARSET_METHOD_SUPERSET */
619 Lisp_Object parents;
621 for (parents = CHARSET_SUPERSET (charset); CONSP (parents);
622 parents = XCDR (parents))
624 int offset;
625 unsigned this_from, this_to;
627 charset = CHARSET_FROM_ID (XFASTINT (XCAR (XCAR (parents))));
628 offset = XINT (XCDR (XCAR (parents)));
629 this_from = from - offset;
630 this_to = to - offset;
631 if (this_from < CHARSET_MIN_CODE (charset))
632 this_from = CHARSET_MIN_CODE (charset);
633 if (this_to > CHARSET_MAX_CODE (charset))
634 this_to = CHARSET_MAX_CODE (charset);
635 map_charset_chars (c_function, function, arg, charset,
636 this_from, this_to);
641 DEFUN ("map-charset-chars", Fmap_charset_chars, Smap_charset_chars, 2, 5, 0,
642 doc: /* Call FUNCTION for all characters in CHARSET.
643 FUNCTION is called with an argument RANGE and the optional 3rd
644 argument ARG.
646 RANGE is a cons (FROM . TO), where FROM and TO indicate a range of
647 characters contained in CHARSET.
649 The optional 4th and 5th arguments FROM-CODE and TO-CODE specify the
650 range of code points of target characters. */)
651 (function, charset, arg, from_code, to_code)
652 Lisp_Object function, charset, arg, from_code, to_code;
654 struct charset *cs;
655 unsigned from, to;
657 CHECK_CHARSET_GET_CHARSET (charset, cs);
658 if (NILP (from_code))
659 from = CHARSET_MIN_CODE (cs);
660 else
662 CHECK_NATNUM (from_code);
663 from = XINT (from_code);
664 if (from < CHARSET_MIN_CODE (cs))
665 from = CHARSET_MIN_CODE (cs);
667 if (NILP (to_code))
668 to = CHARSET_MAX_CODE (cs);
669 else
671 CHECK_NATNUM (to_code);
672 to = XINT (to_code);
673 if (to > CHARSET_MAX_CODE (cs))
674 to = CHARSET_MAX_CODE (cs);
676 map_charset_chars (NULL, function, arg, cs, from, to);
677 return Qnil;
681 /* Define a charset according to the arguments. The Nth argument is
682 the Nth attribute of the charset (the last attribute `charset-id'
683 is not included). See the docstring of `define-charset' for the
684 detail. */
686 DEFUN ("define-charset-internal", Fdefine_charset_internal,
687 Sdefine_charset_internal, charset_arg_max, MANY, 0,
688 doc: /* For internal use only.
689 usage: (define-charset-internal ...) */)
690 (nargs, args)
691 int nargs;
692 Lisp_Object *args;
694 /* Charset attr vector. */
695 Lisp_Object attrs;
696 Lisp_Object val;
697 unsigned hash_code;
698 struct Lisp_Hash_Table *hash_table = XHASH_TABLE (Vcharset_hash_table);
699 int i, j;
700 struct charset charset;
701 int id;
702 int dimension;
703 int new_definition_p;
704 int nchars;
706 if (nargs != charset_arg_max)
707 return Fsignal (Qwrong_number_of_arguments,
708 Fcons (intern ("define-charset-internal"),
709 make_number (nargs)));
711 attrs = Fmake_vector (make_number (charset_attr_max), Qnil);
713 CHECK_SYMBOL (args[charset_arg_name]);
714 ASET (attrs, charset_name, args[charset_arg_name]);
716 val = args[charset_arg_code_space];
717 for (i = 0, dimension = 0, nchars = 1; i < 4; i++)
719 int min_byte, max_byte;
721 min_byte = XINT (Faref (val, make_number (i * 2)));
722 max_byte = XINT (Faref (val, make_number (i * 2 + 1)));
723 if (min_byte < 0 || min_byte > max_byte || max_byte >= 256)
724 error ("Invalid :code-space value");
725 charset.code_space[i * 4] = min_byte;
726 charset.code_space[i * 4 + 1] = max_byte;
727 charset.code_space[i * 4 + 2] = max_byte - min_byte + 1;
728 nchars *= charset.code_space[i * 4 + 2];
729 charset.code_space[i * 4 + 3] = nchars;
730 if (max_byte > 0)
731 dimension = i + 1;
734 val = args[charset_arg_dimension];
735 if (NILP (val))
736 charset.dimension = dimension;
737 else
739 CHECK_NATNUM (val);
740 charset.dimension = XINT (val);
741 if (charset.dimension < 1 || charset.dimension > 4)
742 args_out_of_range_3 (val, make_number (1), make_number (4));
745 charset.code_linear_p
746 = (charset.dimension == 1
747 || (charset.code_space[2] == 256
748 && (charset.dimension == 2
749 || (charset.code_space[6] == 256
750 && (charset.dimension == 3
751 || charset.code_space[10] == 256)))));
753 if (! charset.code_linear_p)
755 charset.code_space_mask = (unsigned char *) xmalloc (256);
756 bzero (charset.code_space_mask, 256);
757 for (i = 0; i < 4; i++)
758 for (j = charset.code_space[i * 4]; j <= charset.code_space[i * 4 + 1];
759 j++)
760 charset.code_space_mask[j] |= (1 << i);
763 charset.iso_chars_96 = charset.code_space[2] == 96;
765 charset.min_code = (charset.code_space[0]
766 | (charset.code_space[4] << 8)
767 | (charset.code_space[8] << 16)
768 | (charset.code_space[12] << 24));
769 charset.max_code = (charset.code_space[1]
770 | (charset.code_space[5] << 8)
771 | (charset.code_space[9] << 16)
772 | (charset.code_space[13] << 24));
773 charset.char_index_offset = 0;
775 val = args[charset_arg_min_code];
776 if (! NILP (val))
778 unsigned code;
780 if (INTEGERP (val))
781 code = XINT (val);
782 else
784 CHECK_CONS (val);
785 CHECK_NUMBER_CAR (val);
786 CHECK_NUMBER_CDR (val);
787 code = (XINT (XCAR (val)) << 16) | (XINT (XCDR (val)));
789 if (code < charset.min_code
790 || code > charset.max_code)
791 args_out_of_range_3 (make_number (charset.min_code),
792 make_number (charset.max_code), val);
793 charset.char_index_offset = CODE_POINT_TO_INDEX (&charset, code);
794 charset.min_code = code;
797 val = args[charset_arg_max_code];
798 if (! NILP (val))
800 unsigned code;
802 if (INTEGERP (val))
803 code = XINT (val);
804 else
806 CHECK_CONS (val);
807 CHECK_NUMBER_CAR (val);
808 CHECK_NUMBER_CDR (val);
809 code = (XINT (XCAR (val)) << 16) | (XINT (XCDR (val)));
811 if (code < charset.min_code
812 || code > charset.max_code)
813 args_out_of_range_3 (make_number (charset.min_code),
814 make_number (charset.max_code), val);
815 charset.max_code = code;
818 charset.compact_codes_p = charset.max_code < 0x1000000;
820 val = args[charset_arg_invalid_code];
821 if (NILP (val))
823 if (charset.min_code > 0)
824 charset.invalid_code = 0;
825 else
827 XSETINT (val, charset.max_code + 1);
828 if (XINT (val) == charset.max_code + 1)
829 charset.invalid_code = charset.max_code + 1;
830 else
831 error ("Attribute :invalid-code must be specified");
834 else
836 CHECK_NATNUM (val);
837 charset.invalid_code = XFASTINT (val);
840 val = args[charset_arg_iso_final];
841 if (NILP (val))
842 charset.iso_final = -1;
843 else
845 CHECK_NUMBER (val);
846 if (XINT (val) < '0' || XINT (val) > 127)
847 error ("Invalid iso-final-char: %d", XINT (val));
848 charset.iso_final = XINT (val);
851 val = args[charset_arg_iso_revision];
852 if (NILP (val))
853 charset.iso_revision = -1;
854 else
856 CHECK_NUMBER (val);
857 if (XINT (val) > 63)
858 args_out_of_range (make_number (63), val);
859 charset.iso_revision = XINT (val);
862 val = args[charset_arg_emacs_mule_id];
863 if (NILP (val))
864 charset.emacs_mule_id = -1;
865 else
867 CHECK_NATNUM (val);
868 if ((XINT (val) > 0 && XINT (val) <= 128) || XINT (val) >= 256)
869 error ("Invalid emacs-mule-id: %d", XINT (val));
870 charset.emacs_mule_id = XINT (val);
873 charset.ascii_compatible_p = ! NILP (args[charset_arg_ascii_compatible_p]);
875 charset.supplementary_p = ! NILP (args[charset_arg_supplementary_p]);
877 charset.unified_p = 0;
879 bzero (charset.fast_map, sizeof (charset.fast_map));
881 if (! NILP (args[charset_arg_code_offset]))
883 val = args[charset_arg_code_offset];
884 CHECK_NUMBER (val);
886 charset.method = CHARSET_METHOD_OFFSET;
887 charset.code_offset = XINT (val);
889 i = CODE_POINT_TO_INDEX (&charset, charset.min_code);
890 charset.min_char = i + charset.code_offset;
891 i = CODE_POINT_TO_INDEX (&charset, charset.max_code);
892 charset.max_char = i + charset.code_offset;
893 if (charset.max_char > MAX_CHAR)
894 error ("Unsupported max char: %d", charset.max_char);
896 i = (charset.min_char >> 7) << 7;
897 for (; i < 0x10000 && i <= charset.max_char; i += 128)
898 CHARSET_FAST_MAP_SET (i, charset.fast_map);
899 i = (i >> 12) << 12;
900 for (; i <= charset.max_char; i += 0x1000)
901 CHARSET_FAST_MAP_SET (i, charset.fast_map);
903 else if (! NILP (args[charset_arg_map]))
905 val = args[charset_arg_map];
906 ASET (attrs, charset_map, val);
907 if (STRINGP (val))
908 load_charset_map_from_file (&charset, val, 0);
909 else
910 load_charset_map_from_vector (&charset, val, 0);
911 charset.method = CHARSET_METHOD_MAP_DEFERRED;
913 else if (! NILP (args[charset_arg_subset]))
915 Lisp_Object parent;
916 Lisp_Object parent_min_code, parent_max_code, parent_code_offset;
917 struct charset *parent_charset;
919 val = args[charset_arg_subset];
920 parent = Fcar (val);
921 CHECK_CHARSET_GET_CHARSET (parent, parent_charset);
922 parent_min_code = Fnth (make_number (1), val);
923 CHECK_NATNUM (parent_min_code);
924 parent_max_code = Fnth (make_number (2), val);
925 CHECK_NATNUM (parent_max_code);
926 parent_code_offset = Fnth (make_number (3), val);
927 CHECK_NUMBER (parent_code_offset);
928 val = Fmake_vector (make_number (4), Qnil);
929 ASET (val, 0, make_number (parent_charset->id));
930 ASET (val, 1, parent_min_code);
931 ASET (val, 2, parent_max_code);
932 ASET (val, 3, parent_code_offset);
933 ASET (attrs, charset_subset, val);
935 charset.method = CHARSET_METHOD_SUBSET;
936 /* Here, we just copy the parent's fast_map. It's not accurate,
937 but at least it works for quickly detecting which character
938 DOESN'T belong to this charset. */
939 for (i = 0; i < 190; i++)
940 charset.fast_map[i] = parent_charset->fast_map[i];
942 /* We also copy these for parents. */
943 charset.min_char = parent_charset->min_char;
944 charset.max_char = parent_charset->max_char;
946 else if (! NILP (args[charset_arg_superset]))
948 val = args[charset_arg_superset];
949 charset.method = CHARSET_METHOD_SUPERSET;
950 val = Fcopy_sequence (val);
951 ASET (attrs, charset_superset, val);
953 charset.min_char = MAX_CHAR;
954 charset.max_char = 0;
955 for (; ! NILP (val); val = Fcdr (val))
957 Lisp_Object elt, car_part, cdr_part;
958 int this_id, offset;
959 struct charset *this_charset;
961 elt = Fcar (val);
962 if (CONSP (elt))
964 car_part = XCAR (elt);
965 cdr_part = XCDR (elt);
966 CHECK_CHARSET_GET_ID (car_part, this_id);
967 CHECK_NUMBER (cdr_part);
968 offset = XINT (cdr_part);
970 else
972 CHECK_CHARSET_GET_ID (elt, this_id);
973 offset = 0;
975 XSETCAR (val, Fcons (make_number (this_id), make_number (offset)));
977 this_charset = CHARSET_FROM_ID (this_id);
978 if (charset.min_char > this_charset->min_char)
979 charset.min_char = this_charset->min_char;
980 if (charset.max_char < this_charset->max_char)
981 charset.max_char = this_charset->max_char;
982 for (i = 0; i < 190; i++)
983 charset.fast_map[i] |= this_charset->fast_map[i];
986 else
987 error ("None of :code-offset, :map, :parents are specified");
989 val = args[charset_arg_unify_map];
990 if (! NILP (val) && !STRINGP (val))
991 CHECK_VECTOR (val);
992 ASET (attrs, charset_unify_map, val);
994 CHECK_LIST (args[charset_arg_plist]);
995 ASET (attrs, charset_plist, args[charset_arg_plist]);
997 charset.hash_index = hash_lookup (hash_table, args[charset_arg_name],
998 &hash_code);
999 if (charset.hash_index >= 0)
1001 new_definition_p = 0;
1002 id = XFASTINT (CHARSET_SYMBOL_ID (args[charset_arg_name]));
1003 HASH_VALUE (hash_table, charset.hash_index) = attrs;
1005 else
1007 charset.hash_index = hash_put (hash_table, args[charset_arg_name], attrs,
1008 hash_code);
1009 if (charset_table_used == charset_table_size)
1011 struct charset *new_table
1012 = (struct charset *) xmalloc (sizeof (struct charset)
1013 * (charset_table_size + 16));
1014 bcopy (charset_table, new_table,
1015 sizeof (struct charset) * charset_table_size);
1016 charset_table_size += 16;
1017 charset_table = new_table;
1019 id = charset_table_used++;
1020 new_definition_p = 1;
1023 ASET (attrs, charset_id, make_number (id));
1024 charset.id = id;
1025 charset_table[id] = charset;
1027 if (charset.iso_final >= 0)
1029 ISO_CHARSET_TABLE (charset.dimension, charset.iso_chars_96,
1030 charset.iso_final) = id;
1031 if (new_definition_p)
1032 Viso_2022_charset_list = nconc2 (Viso_2022_charset_list,
1033 Fcons (make_number (id), Qnil));
1034 if (ISO_CHARSET_TABLE (1, 0, 'J') == id)
1035 charset_jisx0201_roman = id;
1036 else if (ISO_CHARSET_TABLE (2, 0, '@') == id)
1037 charset_jisx0208_1978 = id;
1038 else if (ISO_CHARSET_TABLE (2, 0, 'B') == id)
1039 charset_jisx0208 = id;
1042 if (charset.emacs_mule_id >= 0)
1044 emacs_mule_charset[charset.emacs_mule_id] = CHARSET_FROM_ID (id);
1045 if (charset.emacs_mule_id < 0xA0)
1046 emacs_mule_bytes[charset.emacs_mule_id] = charset.dimension + 1;
1047 else
1048 emacs_mule_bytes[charset.emacs_mule_id] = charset.dimension + 2;
1049 if (new_definition_p)
1050 Vemacs_mule_charset_list = nconc2 (Vemacs_mule_charset_list,
1051 Fcons (make_number (id), Qnil));
1054 if (new_definition_p)
1056 Vcharset_list = Fcons (args[charset_arg_name], Vcharset_list);
1057 if (charset.supplementary_p)
1058 Vcharset_ordered_list = nconc2 (Vcharset_ordered_list,
1059 Fcons (make_number (id), Qnil));
1060 else
1062 Lisp_Object tail;
1064 for (tail = Vcharset_ordered_list; CONSP (tail); tail = XCDR (tail))
1066 struct charset *cs = CHARSET_FROM_ID (XINT (XCAR (tail)));
1068 if (cs->supplementary_p)
1069 break;
1071 if (EQ (tail, Vcharset_ordered_list))
1072 Vcharset_ordered_list = Fcons (make_number (id),
1073 Vcharset_ordered_list);
1074 else if (NILP (tail))
1075 Vcharset_ordered_list = nconc2 (Vcharset_ordered_list,
1076 Fcons (make_number (id), Qnil));
1077 else
1079 val = Fcons (XCAR (tail), XCDR (tail));
1080 XSETCDR (tail, val);
1081 XSETCAR (tail, make_number (id));
1084 charset_ordered_list_tick++;
1087 return Qnil;
1091 /* Same as Fdefine_charset_internal but arguments are more convenient
1092 to call from C (typically in syms_of_charset). This can define a
1093 charset of `offset' method only. Return the ID of the new
1094 charset. */
1096 static int
1097 define_charset_internal (name, dimension, code_space, min_code, max_code,
1098 iso_final, iso_revision, emacs_mule_id,
1099 ascii_compatible, supplementary,
1100 code_offset)
1101 Lisp_Object name;
1102 int dimension;
1103 unsigned char *code_space;
1104 unsigned min_code, max_code;
1105 int iso_final, iso_revision, emacs_mule_id;
1106 int ascii_compatible, supplementary;
1107 int code_offset;
1109 Lisp_Object args[charset_arg_max];
1110 Lisp_Object plist[14];
1111 Lisp_Object val;
1112 int i;
1114 args[charset_arg_name] = name;
1115 args[charset_arg_dimension] = make_number (dimension);
1116 val = Fmake_vector (make_number (8), make_number (0));
1117 for (i = 0; i < 8; i++)
1118 ASET (val, i, make_number (code_space[i]));
1119 args[charset_arg_code_space] = val;
1120 args[charset_arg_min_code] = make_number (min_code);
1121 args[charset_arg_max_code] = make_number (max_code);
1122 args[charset_arg_iso_final]
1123 = (iso_final < 0 ? Qnil : make_number (iso_final));
1124 args[charset_arg_iso_revision] = make_number (iso_revision);
1125 args[charset_arg_emacs_mule_id]
1126 = (emacs_mule_id < 0 ? Qnil : make_number (emacs_mule_id));
1127 args[charset_arg_ascii_compatible_p] = ascii_compatible ? Qt : Qnil;
1128 args[charset_arg_supplementary_p] = supplementary ? Qt : Qnil;
1129 args[charset_arg_invalid_code] = Qnil;
1130 args[charset_arg_code_offset] = make_number (code_offset);
1131 args[charset_arg_map] = Qnil;
1132 args[charset_arg_subset] = Qnil;
1133 args[charset_arg_superset] = Qnil;
1134 args[charset_arg_unify_map] = Qnil;
1136 plist[0] = intern (":name");
1137 plist[1] = args[charset_arg_name];
1138 plist[2] = intern (":dimension");
1139 plist[3] = args[charset_arg_dimension];
1140 plist[4] = intern (":code-space");
1141 plist[5] = args[charset_arg_code_space];
1142 plist[6] = intern (":iso-final-char");
1143 plist[7] = args[charset_arg_iso_final];
1144 plist[8] = intern (":emacs-mule-id");
1145 plist[9] = args[charset_arg_emacs_mule_id];
1146 plist[10] = intern (":ascii-compatible-p");
1147 plist[11] = args[charset_arg_ascii_compatible_p];
1148 plist[12] = intern (":code-offset");
1149 plist[13] = args[charset_arg_code_offset];
1151 args[charset_arg_plist] = Flist (14, plist);
1152 Fdefine_charset_internal (charset_arg_max, args);
1154 return XINT (CHARSET_SYMBOL_ID (name));
1158 DEFUN ("define-charset-alias", Fdefine_charset_alias,
1159 Sdefine_charset_alias, 2, 2, 0,
1160 doc: /* Define ALIAS as an alias for charset CHARSET. */)
1161 (alias, charset)
1162 Lisp_Object alias, charset;
1164 Lisp_Object attr;
1166 CHECK_CHARSET_GET_ATTR (charset, attr);
1167 Fputhash (alias, attr, Vcharset_hash_table);
1168 Vcharset_list = Fcons (alias, Vcharset_list);
1169 return Qnil;
1173 DEFUN ("charset-plist", Fcharset_plist, Scharset_plist, 1, 1, 0,
1174 doc: /* Return the property list of CHARSET. */)
1175 (charset)
1176 Lisp_Object charset;
1178 Lisp_Object attrs;
1180 CHECK_CHARSET_GET_ATTR (charset, attrs);
1181 return CHARSET_ATTR_PLIST (attrs);
1185 DEFUN ("set-charset-plist", Fset_charset_plist, Sset_charset_plist, 2, 2, 0,
1186 doc: /* Set CHARSET's property list to PLIST. */)
1187 (charset, plist)
1188 Lisp_Object charset, plist;
1190 Lisp_Object attrs;
1192 CHECK_CHARSET_GET_ATTR (charset, attrs);
1193 CHARSET_ATTR_PLIST (attrs) = plist;
1194 return plist;
1198 DEFUN ("unify-charset", Funify_charset, Sunify_charset, 1, 3, 0,
1199 doc: /* Unify characters of CHARSET with Unicode.
1200 This means reading the relevant file and installing the table defined
1201 by CHARSET's `:unify-map' property.
1203 Optional second arg UNIFY-MAP is a file name string or a vector. It has
1204 the same meaning as the `:unify-map' attribute in the function
1205 `define-charset' (which see).
1207 Optional third argument DEUNIFY, if non-nil, means to de-unify CHARSET. */)
1208 (charset, unify_map, deunify)
1209 Lisp_Object charset, unify_map, deunify;
1211 int id;
1212 struct charset *cs;
1214 CHECK_CHARSET_GET_ID (charset, id);
1215 cs = CHARSET_FROM_ID (id);
1216 if (CHARSET_METHOD (cs) == CHARSET_METHOD_MAP_DEFERRED)
1217 load_charset (cs);
1218 if (NILP (deunify)
1219 ? CHARSET_UNIFIED_P (cs) && ! NILP (CHARSET_DEUNIFIER (cs))
1220 : ! CHARSET_UNIFIED_P (cs))
1221 return Qnil;
1223 CHARSET_UNIFIED_P (cs) = 0;
1224 if (NILP (deunify))
1226 if (CHARSET_METHOD (cs) != CHARSET_METHOD_OFFSET)
1227 error ("Can't unify charset: %s", SDATA (SYMBOL_NAME (charset)));
1228 if (NILP (unify_map))
1229 unify_map = CHARSET_UNIFY_MAP (cs);
1230 if (STRINGP (unify_map))
1231 load_charset_map_from_file (cs, unify_map, 2);
1232 else if (VECTORP (unify_map))
1233 load_charset_map_from_vector (cs, unify_map, 2);
1234 else if (NILP (unify_map))
1235 error ("No unify-map for charset");
1236 else
1237 error ("Bad unify-map arg");
1238 CHARSET_UNIFIED_P (cs) = 1;
1240 else if (CHAR_TABLE_P (Vchar_unify_table))
1242 int min_code = CHARSET_MIN_CODE (cs);
1243 int max_code = CHARSET_MAX_CODE (cs);
1244 int min_char = DECODE_CHAR (cs, min_code);
1245 int max_char = DECODE_CHAR (cs, max_code);
1247 char_table_set_range (Vchar_unify_table, min_char, max_char, Qnil);
1250 return Qnil;
1253 DEFUN ("get-unused-iso-final-char", Fget_unused_iso_final_char,
1254 Sget_unused_iso_final_char, 2, 2, 0,
1255 doc: /*
1256 Return an unused ISO final char for a charset of DIMENISION and CHARS.
1257 DIMENSION is the number of bytes to represent a character: 1 or 2.
1258 CHARS is the number of characters in a dimension: 94 or 96.
1260 This final char is for private use, thus the range is `0' (48) .. `?' (63).
1261 If there's no unused final char for the specified kind of charset,
1262 return nil. */)
1263 (dimension, chars)
1264 Lisp_Object dimension, chars;
1266 int final_char;
1268 CHECK_NUMBER (dimension);
1269 CHECK_NUMBER (chars);
1270 if (XINT (dimension) != 1 && XINT (dimension) != 2 && XINT (dimension) != 3)
1271 args_out_of_range_3 (dimension, make_number (1), make_number (3));
1272 if (XINT (chars) != 94 && XINT (chars) != 96)
1273 args_out_of_range_3 (chars, make_number (94), make_number (96));
1274 for (final_char = '0'; final_char <= '?'; final_char++)
1275 if (ISO_CHARSET_TABLE (XINT (dimension), XINT (chars), final_char) < 0)
1276 break;
1277 return (final_char <= '?' ? make_number (final_char) : Qnil);
1280 static void
1281 check_iso_charset_parameter (dimension, chars, final_char)
1282 Lisp_Object dimension, chars, final_char;
1284 CHECK_NATNUM (dimension);
1285 CHECK_NATNUM (chars);
1286 CHECK_NATNUM (final_char);
1288 if (XINT (dimension) > 3)
1289 error ("Invalid DIMENSION %d, it should be 1, 2, or 3", XINT (dimension));
1290 if (XINT (chars) != 94 && XINT (chars) != 96)
1291 error ("Invalid CHARS %d, it should be 94 or 96", XINT (chars));
1292 if (XINT (final_char) < '0' || XINT (final_char) > '~')
1293 error ("Invalid FINAL-CHAR %c, it should be `0'..`~'", XINT (chars));
1297 DEFUN ("declare-equiv-charset", Fdeclare_equiv_charset, Sdeclare_equiv_charset,
1298 4, 4, 0,
1299 doc: /* Declare an equivalent charset for ISO-2022 decoding.
1301 On decoding by an ISO-2022 base coding system, when a charset
1302 specified by DIMENSION, CHARS, and FINAL-CHAR is designated, behave as
1303 if CHARSET is designated instead. */)
1304 (dimension, chars, final_char, charset)
1305 Lisp_Object dimension, chars, final_char, charset;
1307 int id;
1308 int chars_flag;
1310 CHECK_CHARSET_GET_ID (charset, id);
1311 check_iso_charset_parameter (dimension, chars, final_char);
1312 chars_flag = XINT (chars) == 96;
1313 ISO_CHARSET_TABLE (XINT (dimension), chars_flag, XINT (final_char)) = id;
1314 return Qnil;
1318 /* Return information about charsets in the text at PTR of NBYTES
1319 bytes, which are NCHARS characters. The value is:
1321 0: Each character is represented by one byte. This is always
1322 true for a unibyte string. For a multibyte string, true if
1323 it contains only ASCII characters.
1325 1: No charsets other than ascii, control-1, and latin-1 are
1326 found.
1328 2: Otherwise.
1332 string_xstring_p (string)
1333 Lisp_Object string;
1335 const unsigned char *p = SDATA (string);
1336 const unsigned char *endp = p + SBYTES (string);
1338 if (SCHARS (string) == SBYTES (string))
1339 return 0;
1341 while (p < endp)
1343 int c = STRING_CHAR_ADVANCE (p);
1345 if (c >= 0x100)
1346 return 2;
1348 return 1;
1352 /* Find charsets in the string at PTR of NCHARS and NBYTES.
1354 CHARSETS is a vector. If Nth element is non-nil, it means the
1355 charset whose id is N is already found.
1357 It may lookup a translation table TABLE if supplied. */
1359 static void
1360 find_charsets_in_text (ptr, nchars, nbytes, charsets, table, multibyte)
1361 const unsigned char *ptr;
1362 EMACS_INT nchars, nbytes;
1363 Lisp_Object charsets, table;
1364 int multibyte;
1366 const unsigned char *pend = ptr + nbytes;
1368 if (nchars == nbytes)
1370 if (multibyte)
1371 ASET (charsets, charset_ascii, Qt);
1372 else
1373 while (ptr < pend)
1375 int c = *ptr++;
1377 if (!NILP (table))
1378 c = translate_char (table, c);
1379 if (ASCII_BYTE_P (c))
1380 ASET (charsets, charset_ascii, Qt);
1381 else
1382 ASET (charsets, charset_eight_bit, Qt);
1385 else
1387 while (ptr < pend)
1389 int c = STRING_CHAR_ADVANCE (ptr);
1390 struct charset *charset;
1392 if (!NILP (table))
1393 c = translate_char (table, c);
1394 charset = CHAR_CHARSET (c);
1395 ASET (charsets, CHARSET_ID (charset), Qt);
1400 DEFUN ("find-charset-region", Ffind_charset_region, Sfind_charset_region,
1401 2, 3, 0,
1402 doc: /* Return a list of charsets in the region between BEG and END.
1403 BEG and END are buffer positions.
1404 Optional arg TABLE if non-nil is a translation table to look up.
1406 If the current buffer is unibyte, the returned list may contain
1407 only `ascii', `eight-bit-control', and `eight-bit-graphic'. */)
1408 (beg, end, table)
1409 Lisp_Object beg, end, table;
1411 Lisp_Object charsets;
1412 EMACS_INT from, from_byte, to, stop, stop_byte;
1413 int i;
1414 Lisp_Object val;
1415 int multibyte = ! NILP (current_buffer->enable_multibyte_characters);
1417 validate_region (&beg, &end);
1418 from = XFASTINT (beg);
1419 stop = to = XFASTINT (end);
1421 if (from < GPT && GPT < to)
1423 stop = GPT;
1424 stop_byte = GPT_BYTE;
1426 else
1427 stop_byte = CHAR_TO_BYTE (stop);
1429 from_byte = CHAR_TO_BYTE (from);
1431 charsets = Fmake_vector (make_number (charset_table_used), Qnil);
1432 while (1)
1434 find_charsets_in_text (BYTE_POS_ADDR (from_byte), stop - from,
1435 stop_byte - from_byte, charsets, table,
1436 multibyte);
1437 if (stop < to)
1439 from = stop, from_byte = stop_byte;
1440 stop = to, stop_byte = CHAR_TO_BYTE (stop);
1442 else
1443 break;
1446 val = Qnil;
1447 for (i = charset_table_used - 1; i >= 0; i--)
1448 if (!NILP (AREF (charsets, i)))
1449 val = Fcons (CHARSET_NAME (charset_table + i), val);
1450 return val;
1453 DEFUN ("find-charset-string", Ffind_charset_string, Sfind_charset_string,
1454 1, 2, 0,
1455 doc: /* Return a list of charsets in STR.
1456 Optional arg TABLE if non-nil is a translation table to look up.
1458 If STR is unibyte, the returned list may contain
1459 only `ascii', `eight-bit-control', and `eight-bit-graphic'. */)
1460 (str, table)
1461 Lisp_Object str, table;
1463 Lisp_Object charsets;
1464 int i;
1465 Lisp_Object val;
1467 CHECK_STRING (str);
1469 charsets = Fmake_vector (make_number (charset_table_used), Qnil);
1470 find_charsets_in_text (SDATA (str), SCHARS (str), SBYTES (str),
1471 charsets, table,
1472 STRING_MULTIBYTE (str));
1473 val = Qnil;
1474 for (i = charset_table_used - 1; i >= 0; i--)
1475 if (!NILP (AREF (charsets, i)))
1476 val = Fcons (CHARSET_NAME (charset_table + i), val);
1477 return val;
1482 /* Return a character correponding to the code-point CODE of
1483 CHARSET. */
1486 decode_char (charset, code)
1487 struct charset *charset;
1488 unsigned code;
1490 int c, char_index;
1491 enum charset_method method = CHARSET_METHOD (charset);
1493 if (code < CHARSET_MIN_CODE (charset) || code > CHARSET_MAX_CODE (charset))
1494 return -1;
1496 if (method == CHARSET_METHOD_MAP_DEFERRED)
1498 load_charset (charset);
1499 method = CHARSET_METHOD (charset);
1502 if (method == CHARSET_METHOD_SUBSET)
1504 Lisp_Object subset_info;
1506 subset_info = CHARSET_SUBSET (charset);
1507 charset = CHARSET_FROM_ID (XFASTINT (AREF (subset_info, 0)));
1508 code -= XINT (AREF (subset_info, 3));
1509 if (code < XFASTINT (AREF (subset_info, 1))
1510 || code > XFASTINT (AREF (subset_info, 2)))
1511 c = -1;
1512 else
1513 c = DECODE_CHAR (charset, code);
1515 else if (method == CHARSET_METHOD_SUPERSET)
1517 Lisp_Object parents;
1519 parents = CHARSET_SUPERSET (charset);
1520 c = -1;
1521 for (; CONSP (parents); parents = XCDR (parents))
1523 int id = XINT (XCAR (XCAR (parents)));
1524 int code_offset = XINT (XCDR (XCAR (parents)));
1525 unsigned this_code = code - code_offset;
1527 charset = CHARSET_FROM_ID (id);
1528 if ((c = DECODE_CHAR (charset, this_code)) >= 0)
1529 break;
1532 else
1534 char_index = CODE_POINT_TO_INDEX (charset, code);
1535 if (char_index < 0)
1536 return -1;
1538 if (method == CHARSET_METHOD_MAP)
1540 Lisp_Object decoder;
1542 decoder = CHARSET_DECODER (charset);
1543 if (! VECTORP (decoder))
1544 return -1;
1545 c = XINT (AREF (decoder, char_index));
1547 else
1549 c = char_index + CHARSET_CODE_OFFSET (charset);
1553 if (CHARSET_UNIFIED_P (charset)
1554 && c >= 0)
1556 MAYBE_UNIFY_CHAR (c);
1559 return c;
1562 /* Variable used temporarily by the macro ENCODE_CHAR. */
1563 Lisp_Object charset_work;
1565 /* Return a code-point of CHAR in CHARSET. If CHAR doesn't belong to
1566 CHARSET, return CHARSET_INVALID_CODE (CHARSET). If STRICT is true,
1567 use CHARSET's strict_max_char instead of max_char. */
1569 unsigned
1570 encode_char (charset, c)
1571 struct charset *charset;
1572 int c;
1574 unsigned code;
1575 enum charset_method method = CHARSET_METHOD (charset);
1577 if (CHARSET_UNIFIED_P (charset))
1579 Lisp_Object deunifier, deunified;
1581 deunifier = CHARSET_DEUNIFIER (charset);
1582 if (! CHAR_TABLE_P (deunifier))
1584 Funify_charset (CHARSET_NAME (charset), Qnil, Qnil);
1585 deunifier = CHARSET_DEUNIFIER (charset);
1587 deunified = CHAR_TABLE_REF (deunifier, c);
1588 if (! NILP (deunified))
1589 c = XINT (deunified);
1592 if (method == CHARSET_METHOD_SUBSET)
1594 Lisp_Object subset_info;
1595 struct charset *this_charset;
1597 subset_info = CHARSET_SUBSET (charset);
1598 this_charset = CHARSET_FROM_ID (XFASTINT (AREF (subset_info, 0)));
1599 code = ENCODE_CHAR (this_charset, c);
1600 if (code == CHARSET_INVALID_CODE (this_charset)
1601 || code < XFASTINT (AREF (subset_info, 1))
1602 || code > XFASTINT (AREF (subset_info, 2)))
1603 return CHARSET_INVALID_CODE (charset);
1604 code += XINT (AREF (subset_info, 3));
1605 return code;
1608 if (method == CHARSET_METHOD_SUPERSET)
1610 Lisp_Object parents;
1612 parents = CHARSET_SUPERSET (charset);
1613 for (; CONSP (parents); parents = XCDR (parents))
1615 int id = XINT (XCAR (XCAR (parents)));
1616 int code_offset = XINT (XCDR (XCAR (parents)));
1617 struct charset *this_charset = CHARSET_FROM_ID (id);
1619 code = ENCODE_CHAR (this_charset, c);
1620 if (code != CHARSET_INVALID_CODE (this_charset))
1621 return code + code_offset;
1623 return CHARSET_INVALID_CODE (charset);
1626 if (! CHARSET_FAST_MAP_REF ((c), charset->fast_map)
1627 || c < CHARSET_MIN_CHAR (charset) || c > CHARSET_MAX_CHAR (charset))
1628 return CHARSET_INVALID_CODE (charset);
1630 if (method == CHARSET_METHOD_MAP_DEFERRED)
1632 load_charset (charset);
1633 method = CHARSET_METHOD (charset);
1636 if (method == CHARSET_METHOD_MAP)
1638 Lisp_Object encoder;
1639 Lisp_Object val;
1641 encoder = CHARSET_ENCODER (charset);
1642 if (! CHAR_TABLE_P (CHARSET_ENCODER (charset)))
1643 return CHARSET_INVALID_CODE (charset);
1644 val = CHAR_TABLE_REF (encoder, c);
1645 if (NILP (val))
1646 return CHARSET_INVALID_CODE (charset);
1647 code = XINT (val);
1648 if (! CHARSET_COMPACT_CODES_P (charset))
1649 code = INDEX_TO_CODE_POINT (charset, code);
1651 else /* method == CHARSET_METHOD_OFFSET */
1653 code = c - CHARSET_CODE_OFFSET (charset);
1654 code = INDEX_TO_CODE_POINT (charset, code);
1657 return code;
1661 DEFUN ("decode-char", Fdecode_char, Sdecode_char, 2, 3, 0,
1662 doc: /* Decode the pair of CHARSET and CODE-POINT into a character.
1663 Return nil if CODE-POINT is not valid in CHARSET.
1665 CODE-POINT may be a cons (HIGHER-16-BIT-VALUE . LOWER-16-BIT-VALUE).
1667 Optional argument RESTRICTION specifies a way to map the pair of CCS
1668 and CODE-POINT to a chracter. Currently not supported and just ignored. */)
1669 (charset, code_point, restriction)
1670 Lisp_Object charset, code_point, restriction;
1672 int c, id;
1673 unsigned code;
1674 struct charset *charsetp;
1676 CHECK_CHARSET_GET_ID (charset, id);
1677 if (CONSP (code_point))
1679 CHECK_NATNUM_CAR (code_point);
1680 CHECK_NATNUM_CDR (code_point);
1681 code = (XINT (XCAR (code_point)) << 16) | (XINT (XCDR (code_point)));
1683 else
1685 CHECK_NATNUM (code_point);
1686 code = XINT (code_point);
1688 charsetp = CHARSET_FROM_ID (id);
1689 c = DECODE_CHAR (charsetp, code);
1690 return (c >= 0 ? make_number (c) : Qnil);
1694 DEFUN ("encode-char", Fencode_char, Sencode_char, 2, 3, 0,
1695 doc: /* Encode the character CH into a code-point of CHARSET.
1696 Return nil if CHARSET doesn't include CH.
1698 Optional argument RESTRICTION specifies a way to map CHAR to a
1699 code-point in CCS. Currently not supported and just ignored. */)
1700 (ch, charset, restriction)
1701 Lisp_Object ch, charset, restriction;
1703 int id;
1704 unsigned code;
1705 struct charset *charsetp;
1707 CHECK_CHARSET_GET_ID (charset, id);
1708 CHECK_NATNUM (ch);
1709 charsetp = CHARSET_FROM_ID (id);
1710 code = ENCODE_CHAR (charsetp, XINT (ch));
1711 if (code == CHARSET_INVALID_CODE (charsetp))
1712 return Qnil;
1713 if (code > 0x7FFFFFF)
1714 return Fcons (make_number (code >> 16), make_number (code & 0xFFFF));
1715 return make_number (code);
1719 DEFUN ("make-char", Fmake_char, Smake_char, 1, 5, 0,
1720 doc:
1721 /* Return a character of CHARSET whose position codes are CODEn.
1723 CODE1 through CODE4 are optional, but if you don't supply sufficient
1724 position codes, it is assumed that the minimum code in each dimension
1725 is specified. */)
1726 (charset, code1, code2, code3, code4)
1727 Lisp_Object charset, code1, code2, code3, code4;
1729 int id, dimension;
1730 struct charset *charsetp;
1731 unsigned code;
1732 int c;
1734 CHECK_CHARSET_GET_ID (charset, id);
1735 charsetp = CHARSET_FROM_ID (id);
1737 dimension = CHARSET_DIMENSION (charsetp);
1738 if (NILP (code1))
1739 code = (CHARSET_ASCII_COMPATIBLE_P (charsetp)
1740 ? 0 : CHARSET_MIN_CODE (charsetp));
1741 else
1743 CHECK_NATNUM (code1);
1744 if (XFASTINT (code1) >= 0x100)
1745 args_out_of_range (make_number (0xFF), code1);
1746 code = XFASTINT (code1);
1748 if (dimension > 1)
1750 code <<= 8;
1751 if (NILP (code2))
1752 code |= charsetp->code_space[(dimension - 2) * 4];
1753 else
1755 CHECK_NATNUM (code2);
1756 if (XFASTINT (code2) >= 0x100)
1757 args_out_of_range (make_number (0xFF), code2);
1758 code |= XFASTINT (code2);
1761 if (dimension > 2)
1763 code <<= 8;
1764 if (NILP (code3))
1765 code |= charsetp->code_space[(dimension - 3) * 4];
1766 else
1768 CHECK_NATNUM (code3);
1769 if (XFASTINT (code3) >= 0x100)
1770 args_out_of_range (make_number (0xFF), code3);
1771 code |= XFASTINT (code3);
1774 if (dimension > 3)
1776 code <<= 8;
1777 if (NILP (code4))
1778 code |= charsetp->code_space[0];
1779 else
1781 CHECK_NATNUM (code4);
1782 if (XFASTINT (code4) >= 0x100)
1783 args_out_of_range (make_number (0xFF), code4);
1784 code |= XFASTINT (code4);
1791 if (CHARSET_ISO_FINAL (charsetp) >= 0)
1792 code &= 0x7F7F7F7F;
1793 c = DECODE_CHAR (charsetp, code);
1794 if (c < 0)
1795 error ("Invalid code(s)");
1796 return make_number (c);
1800 /* Return the first charset in CHARSET_LIST that contains C.
1801 CHARSET_LIST is a list of charset IDs. If it is nil, use
1802 Vcharset_ordered_list. */
1804 struct charset *
1805 char_charset (c, charset_list, code_return)
1806 int c;
1807 Lisp_Object charset_list;
1808 unsigned *code_return;
1810 if (NILP (charset_list))
1811 charset_list = Vcharset_ordered_list;
1813 while (CONSP (charset_list))
1815 struct charset *charset = CHARSET_FROM_ID (XINT (XCAR (charset_list)));
1816 unsigned code = ENCODE_CHAR (charset, c);
1818 if (code != CHARSET_INVALID_CODE (charset))
1820 if (code_return)
1821 *code_return = code;
1822 return charset;
1824 charset_list = XCDR (charset_list);
1826 return NULL;
1830 DEFUN ("split-char", Fsplit_char, Ssplit_char, 1, 1, 0,
1831 doc:
1832 /*Return list of charset and one to four position-codes of CHAR.
1833 The charset is decided by the current priority order of charsets.
1834 A position-code is a byte value of each dimension of the code-point of
1835 CHAR in the charset. */)
1836 (ch)
1837 Lisp_Object ch;
1839 struct charset *charset;
1840 int c, dimension;
1841 unsigned code;
1842 Lisp_Object val;
1844 CHECK_CHARACTER (ch);
1845 c = XFASTINT (ch);
1846 charset = CHAR_CHARSET (c);
1847 if (! charset)
1848 abort ();
1849 code = ENCODE_CHAR (charset, c);
1850 if (code == CHARSET_INVALID_CODE (charset))
1851 abort ();
1852 dimension = CHARSET_DIMENSION (charset);
1853 for (val = Qnil; dimension > 0; dimension--)
1855 val = Fcons (make_number (code & 0xFF), val);
1856 code >>= 8;
1858 return Fcons (CHARSET_NAME (charset), val);
1862 DEFUN ("char-charset", Fchar_charset, Schar_charset, 1, 1, 0,
1863 doc: /* Return the charset of highest priority that contains CH. */)
1864 (ch)
1865 Lisp_Object ch;
1867 struct charset *charset;
1869 CHECK_CHARACTER (ch);
1870 charset = CHAR_CHARSET (XINT (ch));
1871 return (CHARSET_NAME (charset));
1875 DEFUN ("charset-after", Fcharset_after, Scharset_after, 0, 1, 0,
1876 doc: /*
1877 Return charset of a character in the current buffer at position POS.
1878 If POS is nil, it defauls to the current point.
1879 If POS is out of range, the value is nil. */)
1880 (pos)
1881 Lisp_Object pos;
1883 Lisp_Object ch;
1884 struct charset *charset;
1886 ch = Fchar_after (pos);
1887 if (! INTEGERP (ch))
1888 return ch;
1889 charset = CHAR_CHARSET (XINT (ch));
1890 return (CHARSET_NAME (charset));
1894 DEFUN ("iso-charset", Fiso_charset, Siso_charset, 3, 3, 0,
1895 doc: /*
1896 Return charset of ISO's specification DIMENSION, CHARS, and FINAL-CHAR.
1898 ISO 2022's designation sequence (escape sequence) distinguishes charsets
1899 by their DIMENSION, CHARS, and FINAL-CHAR,
1900 where as Emacs distinguishes them by charset symbol.
1901 See the documentation of the function `charset-info' for the meanings of
1902 DIMENSION, CHARS, and FINAL-CHAR. */)
1903 (dimension, chars, final_char)
1904 Lisp_Object dimension, chars, final_char;
1906 int id;
1907 int chars_flag;
1909 check_iso_charset_parameter (dimension, chars, final_char);
1910 chars_flag = XFASTINT (chars) == 96;
1911 id = ISO_CHARSET_TABLE (XFASTINT (dimension), chars_flag,
1912 XFASTINT (final_char));
1913 return (id >= 0 ? CHARSET_NAME (CHARSET_FROM_ID (id)) : Qnil);
1917 DEFUN ("clear-charset-maps", Fclear_charset_maps, Sclear_charset_maps,
1918 0, 0, 0,
1919 doc: /*
1920 Clear encoder and decoder of charsets that are loaded from mapfiles. */)
1923 int i;
1924 struct charset *charset;
1925 Lisp_Object attrs;
1927 for (i = 0; i < charset_table_used; i++)
1929 charset = CHARSET_FROM_ID (i);
1930 attrs = CHARSET_ATTRIBUTES (charset);
1932 if (CHARSET_METHOD (charset) == CHARSET_METHOD_MAP)
1934 CHARSET_ATTR_DECODER (attrs) = Qnil;
1935 CHARSET_ATTR_ENCODER (attrs) = Qnil;
1936 CHARSET_METHOD (charset) = CHARSET_METHOD_MAP_DEFERRED;
1939 if (CHARSET_UNIFIED_P (charset))
1940 CHARSET_ATTR_DEUNIFIER (attrs) = Qnil;
1943 if (CHAR_TABLE_P (Vchar_unified_charset_table))
1945 Foptimize_char_table (Vchar_unified_charset_table);
1946 Vchar_unify_table = Vchar_unified_charset_table;
1947 Vchar_unified_charset_table = Qnil;
1950 return Qnil;
1953 DEFUN ("charset-priority-list", Fcharset_priority_list,
1954 Scharset_priority_list, 0, 1, 0,
1955 doc: /* Return the list of charsets ordered by priority.
1956 HIGHESTP non-nil means just return the highest priority one. */)
1957 (highestp)
1958 Lisp_Object highestp;
1960 Lisp_Object val = Qnil, list = Vcharset_ordered_list;
1962 if (!NILP (highestp))
1963 return CHARSET_NAME (CHARSET_FROM_ID (XINT (Fcar (list))));
1965 while (!NILP (list))
1967 val = Fcons (CHARSET_NAME (CHARSET_FROM_ID (XINT (XCAR (list)))), val);
1968 list = XCDR (list);
1970 return Fnreverse (val);
1973 DEFUN ("set-charset-priority", Fset_charset_priority, Sset_charset_priority,
1974 1, MANY, 0,
1975 doc: /* Assign higher priority to the charsets given as arguments.
1976 usage: (set-charset-priority &rest charsets) */)
1977 (nargs, args)
1978 int nargs;
1979 Lisp_Object *args;
1981 Lisp_Object new_head, old_list, arglist[2];
1982 Lisp_Object list_2022, list_emacs_mule;
1983 int i, id;
1985 old_list = Fcopy_sequence (Vcharset_ordered_list);
1986 new_head = Qnil;
1987 for (i = 0; i < nargs; i++)
1989 CHECK_CHARSET_GET_ID (args[i], id);
1990 if (! NILP (Fmemq (make_number (id), old_list)))
1992 old_list = Fdelq (make_number (id), old_list);
1993 new_head = Fcons (make_number (id), new_head);
1996 arglist[0] = Fnreverse (new_head);
1997 arglist[1] = old_list;
1998 Vcharset_ordered_list = Fnconc (2, arglist);
1999 charset_ordered_list_tick++;
2001 for (old_list = Vcharset_ordered_list, list_2022 = list_emacs_mule = Qnil;
2002 CONSP (old_list); old_list = XCDR (old_list))
2004 if (! NILP (Fmemq (XCAR (old_list), Viso_2022_charset_list)))
2005 list_2022 = Fcons (XCAR (old_list), list_2022);
2006 if (! NILP (Fmemq (XCAR (old_list), Vemacs_mule_charset_list)))
2007 list_emacs_mule = Fcons (XCAR (old_list), list_emacs_mule);
2009 Viso_2022_charset_list = Fnreverse (list_2022);
2010 Vemacs_mule_charset_list = Fnreverse (list_emacs_mule);
2012 return Qnil;
2015 DEFUN ("charset-id-internal", Fcharset_id_internal, Scharset_id_internal,
2016 0, 1, 0,
2017 doc: /* Internal use only.
2018 Return charset identification number of CHARSET. */)
2019 (charset)
2020 Lisp_Object charset;
2022 int id;
2024 CHECK_CHARSET_GET_ID (charset, id);
2025 return make_number (id);
2029 void
2030 init_charset ()
2032 Vcharset_map_path
2033 = Fcons (Fexpand_file_name (build_string ("charsets"), Vdata_directory),
2034 Qnil);
2038 void
2039 init_charset_once ()
2041 int i, j, k;
2043 for (i = 0; i < ISO_MAX_DIMENSION; i++)
2044 for (j = 0; j < ISO_MAX_CHARS; j++)
2045 for (k = 0; k < ISO_MAX_FINAL; k++)
2046 iso_charset_table[i][j][k] = -1;
2048 for (i = 0; i < 256; i++)
2049 emacs_mule_charset[i] = NULL;
2051 charset_jisx0201_roman = -1;
2052 charset_jisx0208_1978 = -1;
2053 charset_jisx0208 = -1;
2055 for (i = 0; i < 128; i++)
2056 unibyte_to_multibyte_table[i] = i;
2057 for (; i < 256; i++)
2058 unibyte_to_multibyte_table[i] = BYTE8_TO_CHAR (i);
2061 #ifdef emacs
2063 void
2064 syms_of_charset ()
2066 DEFSYM (Qcharsetp, "charsetp");
2068 DEFSYM (Qascii, "ascii");
2069 DEFSYM (Qunicode, "unicode");
2070 DEFSYM (Qeight_bit, "eight-bit");
2071 DEFSYM (Qiso_8859_1, "iso-8859-1");
2073 DEFSYM (Qgl, "gl");
2074 DEFSYM (Qgr, "gr");
2076 staticpro (&Vcharset_ordered_list);
2077 Vcharset_ordered_list = Qnil;
2079 staticpro (&Viso_2022_charset_list);
2080 Viso_2022_charset_list = Qnil;
2082 staticpro (&Vemacs_mule_charset_list);
2083 Vemacs_mule_charset_list = Qnil;
2085 /* Don't staticpro them here. It's done in syms_of_fns. */
2086 QCtest = intern (":test");
2087 Qeq = intern ("eq");
2089 staticpro (&Vcharset_hash_table);
2091 Lisp_Object args[2];
2092 args[0] = QCtest;
2093 args[1] = Qeq;
2094 Vcharset_hash_table = Fmake_hash_table (2, args);
2097 charset_table_size = 128;
2098 charset_table = ((struct charset *)
2099 xmalloc (sizeof (struct charset) * charset_table_size));
2100 charset_table_used = 0;
2102 staticpro (&Vchar_unified_charset_table);
2103 Vchar_unified_charset_table = Fmake_char_table (Qnil, make_number (-1));
2105 defsubr (&Scharsetp);
2106 defsubr (&Smap_charset_chars);
2107 defsubr (&Sdefine_charset_internal);
2108 defsubr (&Sdefine_charset_alias);
2109 defsubr (&Scharset_plist);
2110 defsubr (&Sset_charset_plist);
2111 defsubr (&Sunify_charset);
2112 defsubr (&Sget_unused_iso_final_char);
2113 defsubr (&Sdeclare_equiv_charset);
2114 defsubr (&Sfind_charset_region);
2115 defsubr (&Sfind_charset_string);
2116 defsubr (&Sdecode_char);
2117 defsubr (&Sencode_char);
2118 defsubr (&Ssplit_char);
2119 defsubr (&Smake_char);
2120 defsubr (&Schar_charset);
2121 defsubr (&Scharset_after);
2122 defsubr (&Siso_charset);
2123 defsubr (&Sclear_charset_maps);
2124 defsubr (&Scharset_priority_list);
2125 defsubr (&Sset_charset_priority);
2126 defsubr (&Scharset_id_internal);
2128 DEFVAR_LISP ("charset-map-path", &Vcharset_map_path,
2129 doc: /* *Lisp of directories to search for charset map files. */);
2130 Vcharset_map_path = Qnil;
2132 DEFVAR_LISP ("charset-list", &Vcharset_list,
2133 doc: /* List of all charsets ever defined. */);
2134 Vcharset_list = Qnil;
2136 charset_ascii
2137 = define_charset_internal (Qascii, 1, "\x00\x7F\x00\x00\x00\x00",
2138 0, 127, 'B', -1, 0, 1, 0, 0);
2139 charset_iso_8859_1
2140 = define_charset_internal (Qiso_8859_1, 1, "\x00\xFF\x00\x00\x00\x00",
2141 0, 255, -1, -1, -1, 1, 0, 0);
2142 charset_unicode
2143 = define_charset_internal (Qunicode, 3, "\x00\xFF\x00\xFF\x00\x10",
2144 0, MAX_UNICODE_CHAR, -1, 0, -1, 1, 0, 0);
2145 charset_eight_bit
2146 = define_charset_internal (Qeight_bit, 1, "\x80\xFF\x00\x00\x00\x00",
2147 128, 255, -1, 0, -1, 0, 1,
2148 MAX_5_BYTE_CHAR + 1);
2151 #endif /* emacs */
2153 /* arch-tag: 66a89b8d-4c28-47d3-9ca1-56f78440d69f
2154 (do not change this comment) */