* vc-hooks.el (vc-path): Remove variable and obsolete declaration.
[emacs.git] / src / character.c
blob5912a70d0ce82f47815d151e6e481d92aa0deaa1
1 /* Basic character support.
2 Copyright (C) 1995, 1997, 1998, 2001 Electrotechnical Laboratory, JAPAN.
3 Licensed to the Free Software Foundation.
4 Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
5 Free Software Foundation, Inc.
6 Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
7 National Institute of Advanced Industrial Science and Technology (AIST)
8 Registration Number H13PRO009
10 This file is part of GNU Emacs.
12 GNU Emacs is free software: you can redistribute it and/or modify
13 it under the terms of the GNU General Public License as published by
14 the Free Software Foundation, either version 3 of the License, or
15 (at your option) any later version.
17 GNU Emacs is distributed in the hope that it will be useful,
18 but WITHOUT ANY WARRANTY; without even the implied warranty of
19 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 GNU General Public License for more details.
22 You should have received a copy of the GNU General Public License
23 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
25 /* At first, see the document in `character.h' to understand the code
26 in this file. */
28 #ifdef emacs
29 #include <config.h>
30 #endif
32 #include <stdio.h>
34 #ifdef emacs
36 #include <sys/types.h>
37 #include <setjmp.h>
38 #include "lisp.h"
39 #include "character.h"
40 #include "buffer.h"
41 #include "charset.h"
42 #include "composite.h"
43 #include "disptab.h"
45 #else /* not emacs */
47 #include "mulelib.h"
49 #endif /* emacs */
51 Lisp_Object Qcharacterp;
53 /* Vector of translation table ever defined.
54 ID of a translation table is used to index this vector. */
55 Lisp_Object Vtranslation_table_vector;
57 /* A char-table for characters which may invoke auto-filling. */
58 Lisp_Object Vauto_fill_chars;
60 Lisp_Object Qauto_fill_chars;
62 /* Char-table of information about which character to unify to which
63 Unicode character. Mainly used by the macro MAYBE_UNIFY_CHAR. */
64 Lisp_Object Vchar_unify_table;
66 /* A char-table. An element is non-nil iff the corresponding
67 character has a printable glyph. */
68 Lisp_Object Vprintable_chars;
70 /* A char-table. An elemnent is a column-width of the corresponding
71 character. */
72 Lisp_Object Vchar_width_table;
74 /* A char-table. An element is a symbol indicating the direction
75 property of corresponding character. */
76 Lisp_Object Vchar_direction_table;
78 /* Variable used locally in the macro FETCH_MULTIBYTE_CHAR. */
79 unsigned char *_fetch_multibyte_char_p;
81 /* Char table of scripts. */
82 Lisp_Object Vchar_script_table;
84 /* Alist of scripts vs representative characters. */
85 Lisp_Object Vscript_representative_chars;
87 static Lisp_Object Qchar_script_table;
89 Lisp_Object Vunicode_category_table;
92 /* If character code C has modifier masks, reflect them to the
93 character code if possible. Return the resulting code. */
95 int
96 char_resolve_modifier_mask (c)
97 int c;
99 /* A non-ASCII character can't reflect modifier bits to the code. */
100 if (! ASCII_CHAR_P ((c & ~CHAR_MODIFIER_MASK)))
101 return c;
103 /* For Meta, Shift, and Control modifiers, we need special care. */
104 if (c & CHAR_SHIFT)
106 /* Shift modifier is valid only with [A-Za-z]. */
107 if ((c & 0377) >= 'A' && (c & 0377) <= 'Z')
108 c &= ~CHAR_SHIFT;
109 else if ((c & 0377) >= 'a' && (c & 0377) <= 'z')
110 c = (c & ~CHAR_SHIFT) - ('a' - 'A');
111 /* Shift modifier for control characters and SPC is ignored. */
112 else if ((c & ~CHAR_MODIFIER_MASK) <= 0x20)
113 c &= ~CHAR_SHIFT;
115 if (c & CHAR_CTL)
117 /* Simulate the code in lread.c. */
118 /* Allow `\C- ' and `\C-?'. */
119 if ((c & 0377) == ' ')
120 c &= ~0177 & ~ CHAR_CTL;
121 else if ((c & 0377) == '?')
122 c = 0177 | (c & ~0177 & ~CHAR_CTL);
123 /* ASCII control chars are made from letters (both cases),
124 as well as the non-letters within 0100...0137. */
125 else if ((c & 0137) >= 0101 && (c & 0137) <= 0132)
126 c &= (037 | (~0177 & ~CHAR_CTL));
127 else if ((c & 0177) >= 0100 && (c & 0177) <= 0137)
128 c &= (037 | (~0177 & ~CHAR_CTL));
130 #if 0 /* This is outside the scope of this function. (bug#4751) */
131 if (c & CHAR_META)
133 /* Move the meta bit to the right place for a string. */
134 c = (c & ~CHAR_META) | 0x80;
136 #endif
138 return c;
142 /* Store multibyte form of character C at P. If C has modifier bits,
143 handle them appropriately. */
146 char_string (c, p)
147 unsigned c;
148 unsigned char *p;
150 int bytes;
152 if (c & CHAR_MODIFIER_MASK)
154 c = (unsigned) char_resolve_modifier_mask ((int) c);
155 /* If C still has any modifier bits, just ignore it. */
156 c &= ~CHAR_MODIFIER_MASK;
159 MAYBE_UNIFY_CHAR (c);
161 if (c <= MAX_3_BYTE_CHAR)
163 bytes = CHAR_STRING (c, p);
165 else if (c <= MAX_4_BYTE_CHAR)
167 p[0] = (0xF0 | (c >> 18));
168 p[1] = (0x80 | ((c >> 12) & 0x3F));
169 p[2] = (0x80 | ((c >> 6) & 0x3F));
170 p[3] = (0x80 | (c & 0x3F));
171 bytes = 4;
173 else if (c <= MAX_5_BYTE_CHAR)
175 p[0] = 0xF8;
176 p[1] = (0x80 | ((c >> 18) & 0x0F));
177 p[2] = (0x80 | ((c >> 12) & 0x3F));
178 p[3] = (0x80 | ((c >> 6) & 0x3F));
179 p[4] = (0x80 | (c & 0x3F));
180 bytes = 5;
182 else if (c <= MAX_CHAR)
184 c = CHAR_TO_BYTE8 (c);
185 bytes = BYTE8_STRING (c, p);
187 else
188 error ("Invalid character: %d", c);
190 return bytes;
194 /* Return a character whose multibyte form is at P. Set LEN is not
195 NULL, it must be a pointer to integer. In that case, set *LEN to
196 the byte length of the multibyte form. If ADVANCED is not NULL, is
197 must be a pointer to unsigned char. In that case, set *ADVANCED to
198 the ending address (i.e. the starting address of the next
199 character) of the multibyte form. */
202 string_char (p, advanced, len)
203 const unsigned char *p;
204 const unsigned char **advanced;
205 int *len;
207 int c;
208 const unsigned char *saved_p = p;
210 if (*p < 0x80 || ! (*p & 0x20) || ! (*p & 0x10))
212 c = STRING_CHAR_ADVANCE (p);
214 else if (! (*p & 0x08))
216 c = ((((p)[0] & 0xF) << 18)
217 | (((p)[1] & 0x3F) << 12)
218 | (((p)[2] & 0x3F) << 6)
219 | ((p)[3] & 0x3F));
220 p += 4;
222 else
224 c = ((((p)[1] & 0x3F) << 18)
225 | (((p)[2] & 0x3F) << 12)
226 | (((p)[3] & 0x3F) << 6)
227 | ((p)[4] & 0x3F));
228 p += 5;
231 MAYBE_UNIFY_CHAR (c);
233 if (len)
234 *len = p - saved_p;
235 if (advanced)
236 *advanced = p;
237 return c;
241 /* Translate character C by translation table TABLE. If C is
242 negative, translate a character specified by CHARSET and CODE. If
243 no translation is found in TABLE, return the untranslated
244 character. If TABLE is a list, elements are char tables. In this
245 case, translace C by all tables. */
248 translate_char (table, c)
249 Lisp_Object table;
250 int c;
252 if (CHAR_TABLE_P (table))
254 Lisp_Object ch;
256 ch = CHAR_TABLE_REF (table, c);
257 if (CHARACTERP (ch))
258 c = XINT (ch);
260 else
262 for (; CONSP (table); table = XCDR (table))
263 c = translate_char (XCAR (table), c);
265 return c;
268 /* Convert ASCII or 8-bit character C to unibyte. If C is none of
269 them, return (C & 0xFF).
271 The argument REV_TBL is now ignored. It will be removed in the
272 future. */
275 multibyte_char_to_unibyte (c, rev_tbl)
276 int c;
277 Lisp_Object rev_tbl;
279 if (c < 0x80)
280 return c;
281 if (CHAR_BYTE8_P (c))
282 return CHAR_TO_BYTE8 (c);
283 return (c & 0xFF);
286 /* Like multibyte_char_to_unibyte, but return -1 if C is not supported
287 by charset_unibyte. */
290 multibyte_char_to_unibyte_safe (c)
291 int c;
293 if (c < 0x80)
294 return c;
295 if (CHAR_BYTE8_P (c))
296 return CHAR_TO_BYTE8 (c);
297 return -1;
300 DEFUN ("characterp", Fcharacterp, Scharacterp, 1, 2, 0,
301 doc: /* Return non-nil if OBJECT is a character. */)
302 (object, ignore)
303 Lisp_Object object, ignore;
305 return (CHARACTERP (object) ? Qt : Qnil);
308 DEFUN ("max-char", Fmax_char, Smax_char, 0, 0, 0,
309 doc: /* Return the character of the maximum code. */)
312 return make_number (MAX_CHAR);
315 DEFUN ("unibyte-char-to-multibyte", Funibyte_char_to_multibyte,
316 Sunibyte_char_to_multibyte, 1, 1, 0,
317 doc: /* Convert the byte CH to multibyte character. */)
318 (ch)
319 Lisp_Object ch;
321 int c;
323 CHECK_CHARACTER (ch);
324 c = XFASTINT (ch);
325 if (c >= 0x100)
326 error ("Not a unibyte character: %d", c);
327 MAKE_CHAR_MULTIBYTE (c);
328 return make_number (c);
331 DEFUN ("multibyte-char-to-unibyte", Fmultibyte_char_to_unibyte,
332 Smultibyte_char_to_unibyte, 1, 1, 0,
333 doc: /* Convert the multibyte character CH to a byte.
334 If the multibyte character does not represent a byte, return -1. */)
335 (ch)
336 Lisp_Object ch;
338 int cm;
340 CHECK_CHARACTER (ch);
341 cm = XFASTINT (ch);
342 if (cm < 256)
343 /* Can't distinguish a byte read from a unibyte buffer from
344 a latin1 char, so let's let it slide. */
345 return ch;
346 else
348 int cu = CHAR_TO_BYTE_SAFE (cm);
349 return make_number (cu);
353 DEFUN ("char-bytes", Fchar_bytes, Schar_bytes, 1, 1, 0,
354 doc: /* Return 1 regardless of the argument CHAR.
355 This is now an obsolete function. We keep it just for backward compatibility.
356 usage: (char-bytes CHAR) */)
357 (ch)
358 Lisp_Object ch;
360 CHECK_CHARACTER (ch);
361 return make_number (1);
364 DEFUN ("char-width", Fchar_width, Schar_width, 1, 1, 0,
365 doc: /* Return width of CHAR when displayed in the current buffer.
366 The width is measured by how many columns it occupies on the screen.
367 Tab is taken to occupy `tab-width' columns.
368 usage: (char-width CHAR) */)
369 (ch)
370 Lisp_Object ch;
372 Lisp_Object disp;
373 int c, width;
374 struct Lisp_Char_Table *dp = buffer_display_table ();
376 CHECK_CHARACTER (ch);
377 c = XINT (ch);
379 /* Get the way the display table would display it. */
380 disp = dp ? DISP_CHAR_VECTOR (dp, c) : Qnil;
382 if (VECTORP (disp))
383 width = ASIZE (disp);
384 else
385 width = CHAR_WIDTH (c);
387 return make_number (width);
390 /* Return width of string STR of length LEN when displayed in the
391 current buffer. The width is measured by how many columns it
392 occupies on the screen. If PRECISION > 0, return the width of
393 longest substring that doesn't exceed PRECISION, and set number of
394 characters and bytes of the substring in *NCHARS and *NBYTES
395 respectively. */
398 c_string_width (const unsigned char *str, int len, int precision, int *nchars, int *nbytes)
400 int i = 0, i_byte = 0;
401 int width = 0;
402 struct Lisp_Char_Table *dp = buffer_display_table ();
404 while (i_byte < len)
406 int bytes, thiswidth;
407 Lisp_Object val;
408 int c = STRING_CHAR_AND_LENGTH (str + i_byte, bytes);
410 if (dp)
412 val = DISP_CHAR_VECTOR (dp, c);
413 if (VECTORP (val))
414 thiswidth = XVECTOR (val)->size;
415 else
416 thiswidth = CHAR_WIDTH (c);
418 else
420 thiswidth = CHAR_WIDTH (c);
423 if (precision > 0
424 && (width + thiswidth > precision))
426 *nchars = i;
427 *nbytes = i_byte;
428 return width;
430 i++;
431 i_byte += bytes;
432 width += thiswidth;
435 if (precision > 0)
437 *nchars = i;
438 *nbytes = i_byte;
441 return width;
444 /* Return width of string STR of length LEN when displayed in the
445 current buffer. The width is measured by how many columns it
446 occupies on the screen. */
449 strwidth (str, len)
450 unsigned char *str;
451 int len;
453 return c_string_width (str, len, -1, NULL, NULL);
456 /* Return width of Lisp string STRING when displayed in the current
457 buffer. The width is measured by how many columns it occupies on
458 the screen while paying attention to compositions. If PRECISION >
459 0, return the width of longest substring that doesn't exceed
460 PRECISION, and set number of characters and bytes of the substring
461 in *NCHARS and *NBYTES respectively. */
464 lisp_string_width (string, precision, nchars, nbytes)
465 Lisp_Object string;
466 int precision, *nchars, *nbytes;
468 int len = SCHARS (string);
469 /* This set multibyte to 0 even if STRING is multibyte when it
470 contains only ascii and eight-bit-graphic, but that's
471 intentional. */
472 int multibyte = len < SBYTES (string);
473 unsigned char *str = SDATA (string);
474 int i = 0, i_byte = 0;
475 int width = 0;
476 struct Lisp_Char_Table *dp = buffer_display_table ();
478 while (i < len)
480 int chars, bytes, thiswidth;
481 Lisp_Object val;
482 int cmp_id;
483 EMACS_INT ignore, end;
485 if (find_composition (i, -1, &ignore, &end, &val, string)
486 && ((cmp_id = get_composition_id (i, i_byte, end - i, val, string))
487 >= 0))
489 thiswidth = composition_table[cmp_id]->width;
490 chars = end - i;
491 bytes = string_char_to_byte (string, end) - i_byte;
493 else
495 int c;
497 if (multibyte)
498 c = STRING_CHAR_AND_LENGTH (str + i_byte, bytes);
499 else
500 c = str[i_byte], bytes = 1;
501 chars = 1;
502 if (dp)
504 val = DISP_CHAR_VECTOR (dp, c);
505 if (VECTORP (val))
506 thiswidth = XVECTOR (val)->size;
507 else
508 thiswidth = CHAR_WIDTH (c);
510 else
512 thiswidth = CHAR_WIDTH (c);
516 if (precision > 0
517 && (width + thiswidth > precision))
519 *nchars = i;
520 *nbytes = i_byte;
521 return width;
523 i += chars;
524 i_byte += bytes;
525 width += thiswidth;
528 if (precision > 0)
530 *nchars = i;
531 *nbytes = i_byte;
534 return width;
537 DEFUN ("string-width", Fstring_width, Sstring_width, 1, 1, 0,
538 doc: /* Return width of STRING when displayed in the current buffer.
539 Width is measured by how many columns it occupies on the screen.
540 When calculating width of a multibyte character in STRING,
541 only the base leading-code is considered; the validity of
542 the following bytes is not checked. Tabs in STRING are always
543 taken to occupy `tab-width' columns.
544 usage: (string-width STRING) */)
545 (str)
546 Lisp_Object str;
548 Lisp_Object val;
550 CHECK_STRING (str);
551 XSETFASTINT (val, lisp_string_width (str, -1, NULL, NULL));
552 return val;
555 DEFUN ("char-direction", Fchar_direction, Schar_direction, 1, 1, 0,
556 doc: /* Return the direction of CHAR.
557 The returned value is 0 for left-to-right and 1 for right-to-left.
558 usage: (char-direction CHAR) */)
559 (ch)
560 Lisp_Object ch;
562 int c;
564 CHECK_CHARACTER (ch);
565 c = XINT (ch);
566 return CHAR_TABLE_REF (Vchar_direction_table, c);
569 /* Return the number of characters in the NBYTES bytes at PTR.
570 This works by looking at the contents and checking for multibyte
571 sequences while assuming that there's no invalid sequence.
572 However, if the current buffer has enable-multibyte-characters =
573 nil, we treat each byte as a character. */
575 EMACS_INT
576 chars_in_text (ptr, nbytes)
577 const unsigned char *ptr;
578 EMACS_INT nbytes;
580 /* current_buffer is null at early stages of Emacs initialization. */
581 if (current_buffer == 0
582 || NILP (current_buffer->enable_multibyte_characters))
583 return nbytes;
585 return multibyte_chars_in_text (ptr, nbytes);
588 /* Return the number of characters in the NBYTES bytes at PTR.
589 This works by looking at the contents and checking for multibyte
590 sequences while assuming that there's no invalid sequence. It
591 ignores enable-multibyte-characters. */
593 EMACS_INT
594 multibyte_chars_in_text (ptr, nbytes)
595 const unsigned char *ptr;
596 EMACS_INT nbytes;
598 const unsigned char *endp = ptr + nbytes;
599 int chars = 0;
601 while (ptr < endp)
603 int len = MULTIBYTE_LENGTH (ptr, endp);
605 if (len == 0)
606 abort ();
607 ptr += len;
608 chars++;
611 return chars;
614 /* Parse unibyte text at STR of LEN bytes as a multibyte text, count
615 characters and bytes in it, and store them in *NCHARS and *NBYTES
616 respectively. On counting bytes, pay attention to that 8-bit
617 characters not constructing a valid multibyte sequence are
618 represented by 2-byte in a multibyte text. */
620 void
621 parse_str_as_multibyte (str, len, nchars, nbytes)
622 const unsigned char *str;
623 int len, *nchars, *nbytes;
625 const unsigned char *endp = str + len;
626 int n, chars = 0, bytes = 0;
628 if (len >= MAX_MULTIBYTE_LENGTH)
630 const unsigned char *adjusted_endp = endp - MAX_MULTIBYTE_LENGTH;
631 while (str < adjusted_endp)
633 if (! CHAR_BYTE8_HEAD_P (*str)
634 && (n = MULTIBYTE_LENGTH_NO_CHECK (str)) > 0)
635 str += n, bytes += n;
636 else
637 str++, bytes += 2;
638 chars++;
641 while (str < endp)
643 if (! CHAR_BYTE8_HEAD_P (*str)
644 && (n = MULTIBYTE_LENGTH (str, endp)) > 0)
645 str += n, bytes += n;
646 else
647 str++, bytes += 2;
648 chars++;
651 *nchars = chars;
652 *nbytes = bytes;
653 return;
656 /* Arrange unibyte text at STR of NBYTES bytes as a multibyte text.
657 It actually converts only such 8-bit characters that don't contruct
658 a multibyte sequence to multibyte forms of Latin-1 characters. If
659 NCHARS is nonzero, set *NCHARS to the number of characters in the
660 text. It is assured that we can use LEN bytes at STR as a work
661 area and that is enough. Return the number of bytes of the
662 resulting text. */
665 str_as_multibyte (str, len, nbytes, nchars)
666 unsigned char *str;
667 int len, nbytes, *nchars;
669 unsigned char *p = str, *endp = str + nbytes;
670 unsigned char *to;
671 int chars = 0;
672 int n;
674 if (nbytes >= MAX_MULTIBYTE_LENGTH)
676 unsigned char *adjusted_endp = endp - MAX_MULTIBYTE_LENGTH;
677 while (p < adjusted_endp
678 && ! CHAR_BYTE8_HEAD_P (*p)
679 && (n = MULTIBYTE_LENGTH_NO_CHECK (p)) > 0)
680 p += n, chars++;
682 while (p < endp
683 && ! CHAR_BYTE8_HEAD_P (*p)
684 && (n = MULTIBYTE_LENGTH (p, endp)) > 0)
685 p += n, chars++;
686 if (nchars)
687 *nchars = chars;
688 if (p == endp)
689 return nbytes;
691 to = p;
692 nbytes = endp - p;
693 endp = str + len;
694 safe_bcopy ((char *) p, (char *) (endp - nbytes), nbytes);
695 p = endp - nbytes;
697 if (nbytes >= MAX_MULTIBYTE_LENGTH)
699 unsigned char *adjusted_endp = endp - MAX_MULTIBYTE_LENGTH;
700 while (p < adjusted_endp)
702 if (! CHAR_BYTE8_HEAD_P (*p)
703 && (n = MULTIBYTE_LENGTH_NO_CHECK (p)) > 0)
705 while (n--)
706 *to++ = *p++;
708 else
710 int c = *p++;
711 c = BYTE8_TO_CHAR (c);
712 to += CHAR_STRING (c, to);
715 chars++;
717 while (p < endp)
719 if (! CHAR_BYTE8_HEAD_P (*p)
720 && (n = MULTIBYTE_LENGTH (p, endp)) > 0)
722 while (n--)
723 *to++ = *p++;
725 else
727 int c = *p++;
728 c = BYTE8_TO_CHAR (c);
729 to += CHAR_STRING (c, to);
731 chars++;
733 if (nchars)
734 *nchars = chars;
735 return (to - str);
738 /* Parse unibyte string at STR of LEN bytes, and return the number of
739 bytes it may ocupy when converted to multibyte string by
740 `str_to_multibyte'. */
743 parse_str_to_multibyte (str, len)
744 unsigned char *str;
745 int len;
747 unsigned char *endp = str + len;
748 int bytes;
750 for (bytes = 0; str < endp; str++)
751 bytes += (*str < 0x80) ? 1 : 2;
752 return bytes;
756 /* Convert unibyte text at STR of NBYTES bytes to a multibyte text
757 that contains the same single-byte characters. It actually
758 converts all 8-bit characters to multibyte forms. It is assured
759 that we can use LEN bytes at STR as a work area and that is
760 enough. */
763 str_to_multibyte (str, len, bytes)
764 unsigned char *str;
765 int len, bytes;
767 unsigned char *p = str, *endp = str + bytes;
768 unsigned char *to;
770 while (p < endp && *p < 0x80) p++;
771 if (p == endp)
772 return bytes;
773 to = p;
774 bytes = endp - p;
775 endp = str + len;
776 safe_bcopy ((char *) p, (char *) (endp - bytes), bytes);
777 p = endp - bytes;
778 while (p < endp)
780 int c = *p++;
782 if (c >= 0x80)
783 c = BYTE8_TO_CHAR (c);
784 to += CHAR_STRING (c, to);
786 return (to - str);
789 /* Arrange multibyte text at STR of LEN bytes as a unibyte text. It
790 actually converts characters in the range 0x80..0xFF to
791 unibyte. */
794 str_as_unibyte (str, bytes)
795 unsigned char *str;
796 int bytes;
798 const unsigned char *p = str, *endp = str + bytes;
799 unsigned char *to;
800 int c, len;
802 while (p < endp)
804 c = *p;
805 len = BYTES_BY_CHAR_HEAD (c);
806 if (CHAR_BYTE8_HEAD_P (c))
807 break;
808 p += len;
810 to = str + (p - str);
811 while (p < endp)
813 c = *p;
814 len = BYTES_BY_CHAR_HEAD (c);
815 if (CHAR_BYTE8_HEAD_P (c))
817 c = STRING_CHAR_ADVANCE (p);
818 *to++ = CHAR_TO_BYTE8 (c);
820 else
822 while (len--) *to++ = *p++;
825 return (to - str);
828 /* Convert eight-bit chars in SRC (in multibyte form) to the
829 corresponding byte and store in DST. CHARS is the number of
830 characters in SRC. The value is the number of bytes stored in DST.
831 Usually, the value is the same as CHARS, but is less than it if SRC
832 contains a non-ASCII, non-eight-bit characater. If ACCEPT_LATIN_1
833 is nonzero, a Latin-1 character is accepted and converted to a byte
834 of that character code.
835 Note: Currently the arg ACCEPT_LATIN_1 is not used. */
837 EMACS_INT
838 str_to_unibyte (src, dst, chars, accept_latin_1)
839 const unsigned char *src;
840 unsigned char *dst;
841 EMACS_INT chars;
842 int accept_latin_1;
844 EMACS_INT i;
846 for (i = 0; i < chars; i++)
848 int c = STRING_CHAR_ADVANCE (src);
850 if (CHAR_BYTE8_P (c))
851 c = CHAR_TO_BYTE8 (c);
852 else if (! ASCII_CHAR_P (c)
853 && (! accept_latin_1 || c >= 0x100))
854 return i;
855 *dst++ = c;
857 return i;
862 string_count_byte8 (string)
863 Lisp_Object string;
865 int multibyte = STRING_MULTIBYTE (string);
866 int nbytes = SBYTES (string);
867 unsigned char *p = SDATA (string);
868 unsigned char *pend = p + nbytes;
869 int count = 0;
870 int c, len;
872 if (multibyte)
873 while (p < pend)
875 c = *p;
876 len = BYTES_BY_CHAR_HEAD (c);
878 if (CHAR_BYTE8_HEAD_P (c))
879 count++;
880 p += len;
882 else
883 while (p < pend)
885 if (*p++ >= 0x80)
886 count++;
888 return count;
892 Lisp_Object
893 string_escape_byte8 (string)
894 Lisp_Object string;
896 int nchars = SCHARS (string);
897 int nbytes = SBYTES (string);
898 int multibyte = STRING_MULTIBYTE (string);
899 int byte8_count;
900 const unsigned char *src, *src_end;
901 unsigned char *dst;
902 Lisp_Object val;
903 int c, len;
905 if (multibyte && nchars == nbytes)
906 return string;
908 byte8_count = string_count_byte8 (string);
910 if (byte8_count == 0)
911 return string;
913 if (multibyte)
914 /* Convert 2-byte sequence of byte8 chars to 4-byte octal. */
915 val = make_uninit_multibyte_string (nchars + byte8_count * 3,
916 nbytes + byte8_count * 2);
917 else
918 /* Convert 1-byte sequence of byte8 chars to 4-byte octal. */
919 val = make_uninit_string (nbytes + byte8_count * 3);
921 src = SDATA (string);
922 src_end = src + nbytes;
923 dst = SDATA (val);
924 if (multibyte)
925 while (src < src_end)
927 c = *src;
928 len = BYTES_BY_CHAR_HEAD (c);
930 if (CHAR_BYTE8_HEAD_P (c))
932 c = STRING_CHAR_ADVANCE (src);
933 c = CHAR_TO_BYTE8 (c);
934 sprintf ((char *) dst, "\\%03o", c);
935 dst += 4;
937 else
938 while (len--) *dst++ = *src++;
940 else
941 while (src < src_end)
943 c = *src++;
944 if (c >= 0x80)
946 sprintf ((char *) dst, "\\%03o", c);
947 dst += 4;
949 else
950 *dst++ = c;
952 return val;
956 DEFUN ("string", Fstring, Sstring, 0, MANY, 0,
957 doc: /*
958 Concatenate all the argument characters and make the result a string.
959 usage: (string &rest CHARACTERS) */)
960 (n, args)
961 int n;
962 Lisp_Object *args;
964 int i;
965 unsigned char *buf = (unsigned char *) alloca (MAX_MULTIBYTE_LENGTH * n);
966 unsigned char *p = buf;
967 int c;
969 for (i = 0; i < n; i++)
971 CHECK_CHARACTER (args[i]);
972 c = XINT (args[i]);
973 p += CHAR_STRING (c, p);
976 return make_string_from_bytes ((char *) buf, n, p - buf);
979 DEFUN ("unibyte-string", Funibyte_string, Sunibyte_string, 0, MANY, 0,
980 doc: /* Concatenate all the argument bytes and make the result a unibyte string.
981 usage: (unibyte-string &rest BYTES) */)
982 (n, args)
983 int n;
984 Lisp_Object *args;
986 int i;
987 unsigned char *buf = (unsigned char *) alloca (n);
988 unsigned char *p = buf;
989 unsigned c;
991 for (i = 0; i < n; i++)
993 CHECK_NATNUM (args[i]);
994 c = XFASTINT (args[i]);
995 if (c >= 256)
996 args_out_of_range_3 (args[i], make_number (0), make_number (255));
997 *p++ = c;
1000 return make_string_from_bytes ((char *) buf, n, p - buf);
1003 DEFUN ("char-resolve-modifiers", Fchar_resolve_modifiers,
1004 Schar_resolve_modifiers, 1, 1, 0,
1005 doc: /* Resolve modifiers in the character CHAR.
1006 The value is a character with modifiers resolved into the character
1007 code. Unresolved modifiers are kept in the value.
1008 usage: (char-resolve-modifiers CHAR) */)
1009 (character)
1010 Lisp_Object character;
1012 int c;
1014 CHECK_NUMBER (character);
1015 c = XINT (character);
1016 return make_number (char_resolve_modifier_mask (c));
1019 DEFUN ("get-byte", Fget_byte, Sget_byte, 0, 2, 0,
1020 doc: /* Return a byte value of a character at point.
1021 Optional 1st arg POSITION, if non-nil, is a position of a character to get
1022 a byte value.
1023 Optional 2nd arg STRING, if non-nil, is a string of which first
1024 character is a target to get a byte value. In this case, POSITION, if
1025 non-nil, is an index of a target character in the string.
1027 If the current buffer (or STRING) is multibyte, and the target
1028 character is not ASCII nor 8-bit character, an error is signalled. */)
1029 (position, string)
1030 Lisp_Object position, string;
1032 int c;
1033 EMACS_INT pos;
1034 unsigned char *p;
1036 if (NILP (string))
1038 if (NILP (position))
1040 p = PT_ADDR;
1042 else
1044 CHECK_NUMBER_COERCE_MARKER (position);
1045 if (XINT (position) < BEGV || XINT (position) >= ZV)
1046 args_out_of_range_3 (position, make_number (BEGV), make_number (ZV));
1047 pos = XFASTINT (position);
1048 p = CHAR_POS_ADDR (pos);
1050 if (NILP (current_buffer->enable_multibyte_characters))
1051 return make_number (*p);
1053 else
1055 CHECK_STRING (string);
1056 if (NILP (position))
1058 p = SDATA (string);
1060 else
1062 CHECK_NATNUM (position);
1063 if (XINT (position) >= SCHARS (string))
1064 args_out_of_range (string, position);
1065 pos = XFASTINT (position);
1066 p = SDATA (string) + string_char_to_byte (string, pos);
1068 if (! STRING_MULTIBYTE (string))
1069 return make_number (*p);
1071 c = STRING_CHAR (p);
1072 if (CHAR_BYTE8_P (c))
1073 c = CHAR_TO_BYTE8 (c);
1074 else if (! ASCII_CHAR_P (c))
1075 error ("Not an ASCII nor an 8-bit character: %d", c);
1076 return make_number (c);
1080 void
1081 init_character_once ()
1085 #ifdef emacs
1087 void
1088 syms_of_character ()
1090 DEFSYM (Qcharacterp, "characterp");
1091 DEFSYM (Qauto_fill_chars, "auto-fill-chars");
1093 staticpro (&Vchar_unify_table);
1094 Vchar_unify_table = Qnil;
1096 defsubr (&Smax_char);
1097 defsubr (&Scharacterp);
1098 defsubr (&Sunibyte_char_to_multibyte);
1099 defsubr (&Smultibyte_char_to_unibyte);
1100 defsubr (&Schar_bytes);
1101 defsubr (&Schar_width);
1102 defsubr (&Sstring_width);
1103 defsubr (&Schar_direction);
1104 defsubr (&Sstring);
1105 defsubr (&Sunibyte_string);
1106 defsubr (&Schar_resolve_modifiers);
1107 defsubr (&Sget_byte);
1109 DEFVAR_LISP ("translation-table-vector", &Vtranslation_table_vector,
1110 doc: /*
1111 Vector recording all translation tables ever defined.
1112 Each element is a pair (SYMBOL . TABLE) relating the table to the
1113 symbol naming it. The ID of a translation table is an index into this vector. */);
1114 Vtranslation_table_vector = Fmake_vector (make_number (16), Qnil);
1116 DEFVAR_LISP ("auto-fill-chars", &Vauto_fill_chars,
1117 doc: /*
1118 A char-table for characters which invoke auto-filling.
1119 Such characters have value t in this table. */);
1120 Vauto_fill_chars = Fmake_char_table (Qauto_fill_chars, Qnil);
1121 CHAR_TABLE_SET (Vauto_fill_chars, ' ', Qt);
1122 CHAR_TABLE_SET (Vauto_fill_chars, '\n', Qt);
1124 DEFVAR_LISP ("char-width-table", &Vchar_width_table,
1125 doc: /*
1126 A char-table for width (columns) of each character. */);
1127 Vchar_width_table = Fmake_char_table (Qnil, make_number (1));
1128 char_table_set_range (Vchar_width_table, 0x80, 0x9F, make_number (4));
1129 char_table_set_range (Vchar_width_table, MAX_5_BYTE_CHAR + 1, MAX_CHAR,
1130 make_number (4));
1132 DEFVAR_LISP ("char-direction-table", &Vchar_direction_table,
1133 doc: /* A char-table for direction of each character. */);
1134 Vchar_direction_table = Fmake_char_table (Qnil, make_number (1));
1136 DEFVAR_LISP ("printable-chars", &Vprintable_chars,
1137 doc: /* A char-table for each printable character. */);
1138 Vprintable_chars = Fmake_char_table (Qnil, Qnil);
1139 Fset_char_table_range (Vprintable_chars,
1140 Fcons (make_number (32), make_number (126)), Qt);
1141 Fset_char_table_range (Vprintable_chars,
1142 Fcons (make_number (160),
1143 make_number (MAX_5_BYTE_CHAR)), Qt);
1145 DEFVAR_LISP ("char-script-table", &Vchar_script_table,
1146 doc: /* Char table of script symbols.
1147 It has one extra slot whose value is a list of script symbols. */);
1149 /* Intern this now in case it isn't already done.
1150 Setting this variable twice is harmless.
1151 But don't staticpro it here--that is done in alloc.c. */
1152 Qchar_table_extra_slots = intern_c_string ("char-table-extra-slots");
1153 DEFSYM (Qchar_script_table, "char-script-table");
1154 Fput (Qchar_script_table, Qchar_table_extra_slots, make_number (1));
1155 Vchar_script_table = Fmake_char_table (Qchar_script_table, Qnil);
1157 DEFVAR_LISP ("script-representative-chars", &Vscript_representative_chars,
1158 doc: /* Alist of scripts vs the representative characters.
1159 Each element is a cons (SCRIPT . CHARS).
1160 SCRIPT is a symbol representing a script or a subgroup of a script.
1161 CHARS is a list or a vector of characters.
1162 If it is a list, all characters in the list are necessary for supporting SCRIPT.
1163 If it is a vector, one of the characters in the vector is necessary.
1164 This variable is used to find a font for a specific script. */);
1165 Vscript_representative_chars = Qnil;
1167 DEFVAR_LISP ("unicode-category-table", &Vunicode_category_table,
1168 doc: /* Char table of Unicode's "General Category".
1169 All Unicode characters have one of the following values (symbol):
1170 Lu, Ll, Lt, Lm, Lo, Mn, Mc, Me, Nd, Nl, No, Pc, Pd, Ps, Pe, Pi, Pf, Po,
1171 Sm, Sc, Sk, So, Zs, Zl, Zp, Cc, Cf, Cs, Co, Cn
1172 See The Unicode Standard for the meaning of those values. */);
1173 /* The correct char-table is setup in characters.el. */
1174 Vunicode_category_table = Qnil;
1177 #endif /* emacs */
1179 /* arch-tag: b6665960-3c3d-4184-85cd-af4318197999
1180 (do not change this comment) */