* character.h (CHAR_TO_BYTE_SAFE): New macro.
[emacs.git] / src / character.c
blob5e2a35905639b9fad31672456bbf09e2958c03f6
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
5 Free Software Foundation, Inc.
6 Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008
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 "lisp.h"
38 #include "character.h"
39 #include "buffer.h"
40 #include "charset.h"
41 #include "composite.h"
42 #include "disptab.h"
44 #else /* not emacs */
46 #include "mulelib.h"
48 #endif /* emacs */
50 Lisp_Object Qcharacterp;
52 /* Vector of translation table ever defined.
53 ID of a translation table is used to index this vector. */
54 Lisp_Object Vtranslation_table_vector;
56 /* A char-table for characters which may invoke auto-filling. */
57 Lisp_Object Vauto_fill_chars;
59 Lisp_Object Qauto_fill_chars;
61 /* Char-table of information about which character to unify to which
62 Unicode character. */
63 Lisp_Object Vchar_unify_table;
65 /* A char-table. An element is non-nil iff the corresponding
66 character has a printable glyph. */
67 Lisp_Object Vprintable_chars;
69 /* A char-table. An elemnent is a column-width of the corresponding
70 character. */
71 Lisp_Object Vchar_width_table;
73 /* A char-table. An element is a symbol indicating the direction
74 property of corresponding character. */
75 Lisp_Object Vchar_direction_table;
77 /* Variable used locally in the macro FETCH_MULTIBYTE_CHAR. */
78 unsigned char *_fetch_multibyte_char_p;
80 /* Char table of scripts. */
81 Lisp_Object Vchar_script_table;
83 /* Alist of scripts vs representative characters. */
84 Lisp_Object Vscript_representative_chars;
86 static Lisp_Object Qchar_script_table;
88 /* Mapping table from unibyte chars to multibyte chars. */
89 int unibyte_to_multibyte_table[256];
91 /* Nth element is 1 iff unibyte char N can be mapped to a multibyte
92 char. */
93 char unibyte_has_multibyte_table[256];
97 /* If character code C has modifier masks, reflect them to the
98 character code if possible. Return the resulting code. */
101 char_resolve_modifier_mask (c)
102 int c;
104 /* A non-ASCII character can't reflect modifier bits to the code. */
105 if (! ASCII_CHAR_P ((c & ~CHAR_MODIFIER_MASK)))
106 return c;
108 /* For Meta, Shift, and Control modifiers, we need special care. */
109 if (c & CHAR_SHIFT)
111 /* Shift modifier is valid only with [A-Za-z]. */
112 if ((c & 0377) >= 'A' && (c & 0377) <= 'Z')
113 c &= ~CHAR_SHIFT;
114 else if ((c & 0377) >= 'a' && (c & 0377) <= 'z')
115 c = (c & ~CHAR_SHIFT) - ('a' - 'A');
116 /* Shift modifier for control characters and SPC is ignored. */
117 else if ((c & ~CHAR_MODIFIER_MASK) <= 0x20)
118 c &= ~CHAR_SHIFT;
120 if (c & CHAR_CTL)
122 /* Simulate the code in lread.c. */
123 /* Allow `\C- ' and `\C-?'. */
124 if ((c & 0377) == ' ')
125 c &= ~0177 & ~ CHAR_CTL;
126 else if ((c & 0377) == '?')
127 c = 0177 | (c & ~0177 & ~CHAR_CTL);
128 /* ASCII control chars are made from letters (both cases),
129 as well as the non-letters within 0100...0137. */
130 else if ((c & 0137) >= 0101 && (c & 0137) <= 0132)
131 c &= (037 | (~0177 & ~CHAR_CTL));
132 else if ((c & 0177) >= 0100 && (c & 0177) <= 0137)
133 c &= (037 | (~0177 & ~CHAR_CTL));
135 if (c & CHAR_META)
137 /* Move the meta bit to the right place for a string. */
138 c = (c & ~CHAR_META) | 0x80;
141 return c;
145 /* Store multibyte form of character C at P. If C has modifier bits,
146 handle them appropriately. */
149 char_string (c, p)
150 unsigned c;
151 unsigned char *p;
153 int bytes;
155 if (c & CHAR_MODIFIER_MASK)
157 c = (unsigned) char_resolve_modifier_mask ((int) c);
158 /* If C still has any modifier bits, just ignore it. */
159 c &= ~CHAR_MODIFIER_MASK;
162 MAYBE_UNIFY_CHAR (c);
164 if (c <= MAX_3_BYTE_CHAR)
166 bytes = CHAR_STRING (c, p);
168 else if (c <= MAX_4_BYTE_CHAR)
170 p[0] = (0xF0 | (c >> 18));
171 p[1] = (0x80 | ((c >> 12) & 0x3F));
172 p[2] = (0x80 | ((c >> 6) & 0x3F));
173 p[3] = (0x80 | (c & 0x3F));
174 bytes = 4;
176 else if (c <= MAX_5_BYTE_CHAR)
178 p[0] = 0xF8;
179 p[1] = (0x80 | ((c >> 18) & 0x0F));
180 p[2] = (0x80 | ((c >> 12) & 0x3F));
181 p[3] = (0x80 | ((c >> 6) & 0x3F));
182 p[4] = (0x80 | (c & 0x3F));
183 bytes = 5;
185 else if (c <= MAX_CHAR)
187 c = CHAR_TO_BYTE8 (c);
188 bytes = BYTE8_STRING (c, p);
190 else
191 error ("Invalid character: %d", c);
193 return bytes;
197 /* Return a character whose multibyte form is at P. Set LEN is not
198 NULL, it must be a pointer to integer. In that case, set *LEN to
199 the byte length of the multibyte form. If ADVANCED is not NULL, is
200 must be a pointer to unsigned char. In that case, set *ADVANCED to
201 the ending address (i.e. the starting address of the next
202 character) of the multibyte form. */
205 string_char (p, advanced, len)
206 const unsigned char *p;
207 const unsigned char **advanced;
208 int *len;
210 int c;
211 const unsigned char *saved_p = p;
213 if (*p < 0x80 || ! (*p & 0x20) || ! (*p & 0x10))
215 c = STRING_CHAR_ADVANCE (p);
217 else if (! (*p & 0x08))
219 c = ((((p)[0] & 0xF) << 18)
220 | (((p)[1] & 0x3F) << 12)
221 | (((p)[2] & 0x3F) << 6)
222 | ((p)[3] & 0x3F));
223 p += 4;
225 else
227 c = ((((p)[1] & 0x3F) << 18)
228 | (((p)[2] & 0x3F) << 12)
229 | (((p)[3] & 0x3F) << 6)
230 | ((p)[4] & 0x3F));
231 p += 5;
234 MAYBE_UNIFY_CHAR (c);
236 if (len)
237 *len = p - saved_p;
238 if (advanced)
239 *advanced = p;
240 return c;
244 /* Translate character C by translation table TABLE. If C is
245 negative, translate a character specified by CHARSET and CODE. If
246 no translation is found in TABLE, return the untranslated
247 character. If TABLE is a list, elements are char tables. In this
248 case, translace C by all tables. */
251 translate_char (table, c)
252 Lisp_Object table;
253 int c;
255 if (CHAR_TABLE_P (table))
257 Lisp_Object ch;
259 ch = CHAR_TABLE_REF (table, c);
260 if (CHARACTERP (ch))
261 c = XINT (ch);
263 else
265 for (; CONSP (table); table = XCDR (table))
266 c = translate_char (XCAR (table), c);
268 return c;
271 /* Convert the multibyte character C to unibyte 8-bit character based
272 on the current value of charset_unibyte. If dimension of
273 charset_unibyte is more than one, return (C & 0xFF).
275 The argument REV_TBL is now ignored. It will be removed in the
276 future. */
279 multibyte_char_to_unibyte (c, rev_tbl)
280 int c;
281 Lisp_Object rev_tbl;
283 struct charset *charset;
284 unsigned c1;
286 if (CHAR_BYTE8_P (c))
287 return CHAR_TO_BYTE8 (c);
288 charset = CHARSET_FROM_ID (charset_unibyte);
289 c1 = ENCODE_CHAR (charset, c);
290 return ((c1 != CHARSET_INVALID_CODE (charset)) ? c1 : c & 0xFF);
293 /* Like multibyte_char_to_unibyte, but return -1 if C is not supported
294 by charset_unibyte. */
297 multibyte_char_to_unibyte_safe (c)
298 int c;
300 struct charset *charset;
301 unsigned c1;
303 if (CHAR_BYTE8_P (c))
304 return CHAR_TO_BYTE8 (c);
305 charset = CHARSET_FROM_ID (charset_unibyte);
306 c1 = ENCODE_CHAR (charset, c);
307 return ((c1 != CHARSET_INVALID_CODE (charset)) ? c1 : -1);
310 DEFUN ("characterp", Fcharacterp, Scharacterp, 1, 2, 0,
311 doc: /* Return non-nil if OBJECT is a character. */)
312 (object, ignore)
313 Lisp_Object object, ignore;
315 return (CHARACTERP (object) ? Qt : Qnil);
318 DEFUN ("max-char", Fmax_char, Smax_char, 0, 0, 0,
319 doc: /* Return the character of the maximum code. */)
322 return make_number (MAX_CHAR);
325 DEFUN ("unibyte-char-to-multibyte", Funibyte_char_to_multibyte,
326 Sunibyte_char_to_multibyte, 1, 1, 0,
327 doc: /* Convert the byte CH to multibyte character. */)
328 (ch)
329 Lisp_Object ch;
331 int c;
332 struct charset *charset;
334 CHECK_CHARACTER (ch);
335 c = XFASTINT (ch);
336 if (c >= 0400)
337 error ("Invalid unibyte character: %d", c);
338 charset = CHARSET_FROM_ID (charset_unibyte);
339 c = DECODE_CHAR (charset, c);
340 if (c < 0)
341 c = BYTE8_TO_CHAR (XFASTINT (ch));
342 return make_number (c);
345 DEFUN ("multibyte-char-to-unibyte", Fmultibyte_char_to_unibyte,
346 Smultibyte_char_to_unibyte, 1, 1, 0,
347 doc: /* Convert the multibyte character CH to a byte.
348 If the multibyte character does not represent a byte, return -1. */)
349 (ch)
350 Lisp_Object ch;
352 int cm;
354 CHECK_CHARACTER (ch);
355 cm = XFASTINT (ch);
356 if (cm < 256)
357 /* Can't distinguish a byte read from a unibyte buffer from
358 a latin1 char, so let's let it slide. */
359 return ch;
360 else
362 int cu = CHAR_TO_BYTE_SAFE (cm);
363 return make_number (cu);
367 DEFUN ("char-bytes", Fchar_bytes, Schar_bytes, 1, 1, 0,
368 doc: /* Return 1 regardless of the argument CHAR.
369 This is now an obsolete function. We keep it just for backward compatibility.
370 usage: (char-bytes CHAR) */)
371 (ch)
372 Lisp_Object ch;
374 CHECK_CHARACTER (ch);
375 return make_number (1);
378 DEFUN ("char-width", Fchar_width, Schar_width, 1, 1, 0,
379 doc: /* Return width of CHAR when displayed in the current buffer.
380 The width is measured by how many columns it occupies on the screen.
381 Tab is taken to occupy `tab-width' columns.
382 usage: (char-width CHAR) */)
383 (ch)
384 Lisp_Object ch;
386 Lisp_Object disp;
387 int c, width;
388 struct Lisp_Char_Table *dp = buffer_display_table ();
390 CHECK_CHARACTER (ch);
391 c = XINT (ch);
393 /* Get the way the display table would display it. */
394 disp = dp ? DISP_CHAR_VECTOR (dp, c) : Qnil;
396 if (VECTORP (disp))
397 width = ASIZE (disp);
398 else
399 width = CHAR_WIDTH (c);
401 return make_number (width);
404 /* Return width of string STR of length LEN when displayed in the
405 current buffer. The width is measured by how many columns it
406 occupies on the screen. If PRECISION > 0, return the width of
407 longest substring that doesn't exceed PRECISION, and set number of
408 characters and bytes of the substring in *NCHARS and *NBYTES
409 respectively. */
412 c_string_width (str, len, precision, nchars, nbytes)
413 const unsigned char *str;
414 int precision, *nchars, *nbytes;
416 int i = 0, i_byte = 0;
417 int width = 0;
418 struct Lisp_Char_Table *dp = buffer_display_table ();
420 while (i_byte < len)
422 int bytes, thiswidth;
423 Lisp_Object val;
424 int c = STRING_CHAR_AND_LENGTH (str + i_byte, len - i_byte, bytes);
426 if (dp)
428 val = DISP_CHAR_VECTOR (dp, c);
429 if (VECTORP (val))
430 thiswidth = XVECTOR (val)->size;
431 else
432 thiswidth = CHAR_WIDTH (c);
434 else
436 thiswidth = CHAR_WIDTH (c);
439 if (precision > 0
440 && (width + thiswidth > precision))
442 *nchars = i;
443 *nbytes = i_byte;
444 return width;
446 i++;
447 i_byte += bytes;
448 width += thiswidth;
451 if (precision > 0)
453 *nchars = i;
454 *nbytes = i_byte;
457 return width;
460 /* Return width of string STR of length LEN when displayed in the
461 current buffer. The width is measured by how many columns it
462 occupies on the screen. */
465 strwidth (str, len)
466 unsigned char *str;
467 int len;
469 return c_string_width (str, len, -1, NULL, NULL);
472 /* Return width of Lisp string STRING when displayed in the current
473 buffer. The width is measured by how many columns it occupies on
474 the screen while paying attention to compositions. If PRECISION >
475 0, return the width of longest substring that doesn't exceed
476 PRECISION, and set number of characters and bytes of the substring
477 in *NCHARS and *NBYTES respectively. */
480 lisp_string_width (string, precision, nchars, nbytes)
481 Lisp_Object string;
482 int precision, *nchars, *nbytes;
484 int len = SCHARS (string);
485 /* This set multibyte to 0 even if STRING is multibyte when it
486 contains only ascii and eight-bit-graphic, but that's
487 intentional. */
488 int multibyte = len < SBYTES (string);
489 unsigned char *str = SDATA (string);
490 int i = 0, i_byte = 0;
491 int width = 0;
492 struct Lisp_Char_Table *dp = buffer_display_table ();
494 while (i < len)
496 int chars, bytes, thiswidth;
497 Lisp_Object val;
498 int cmp_id;
499 EMACS_INT ignore, end;
501 if (find_composition (i, -1, &ignore, &end, &val, string)
502 && ((cmp_id = get_composition_id (i, i_byte, end - i, val, string))
503 >= 0))
505 thiswidth = composition_table[cmp_id]->width;
506 chars = end - i;
507 bytes = string_char_to_byte (string, end) - i_byte;
509 else
511 int c;
513 if (multibyte)
514 c = STRING_CHAR_AND_LENGTH (str + i_byte, len - i_byte, bytes);
515 else
516 c = str[i_byte], bytes = 1;
517 chars = 1;
518 if (dp)
520 val = DISP_CHAR_VECTOR (dp, c);
521 if (VECTORP (val))
522 thiswidth = XVECTOR (val)->size;
523 else
524 thiswidth = CHAR_WIDTH (c);
526 else
528 thiswidth = CHAR_WIDTH (c);
532 if (precision > 0
533 && (width + thiswidth > precision))
535 *nchars = i;
536 *nbytes = i_byte;
537 return width;
539 i += chars;
540 i_byte += bytes;
541 width += thiswidth;
544 if (precision > 0)
546 *nchars = i;
547 *nbytes = i_byte;
550 return width;
553 DEFUN ("string-width", Fstring_width, Sstring_width, 1, 1, 0,
554 doc: /* Return width of STRING when displayed in the current buffer.
555 Width is measured by how many columns it occupies on the screen.
556 When calculating width of a multibyte character in STRING,
557 only the base leading-code is considered; the validity of
558 the following bytes is not checked. Tabs in STRING are always
559 taken to occupy `tab-width' columns.
560 usage: (string-width STRING) */)
561 (str)
562 Lisp_Object str;
564 Lisp_Object val;
566 CHECK_STRING (str);
567 XSETFASTINT (val, lisp_string_width (str, -1, NULL, NULL));
568 return val;
571 DEFUN ("char-direction", Fchar_direction, Schar_direction, 1, 1, 0,
572 doc: /* Return the direction of CHAR.
573 The returned value is 0 for left-to-right and 1 for right-to-left.
574 usage: (char-direction CHAR) */)
575 (ch)
576 Lisp_Object ch;
578 int c;
580 CHECK_CHARACTER (ch);
581 c = XINT (ch);
582 return CHAR_TABLE_REF (Vchar_direction_table, c);
585 /* Return the number of characters in the NBYTES bytes at PTR.
586 This works by looking at the contents and checking for multibyte
587 sequences while assuming that there's no invalid sequence.
588 However, if the current buffer has enable-multibyte-characters =
589 nil, we treat each byte as a character. */
591 EMACS_INT
592 chars_in_text (ptr, nbytes)
593 const unsigned char *ptr;
594 EMACS_INT nbytes;
596 /* current_buffer is null at early stages of Emacs initialization. */
597 if (current_buffer == 0
598 || NILP (current_buffer->enable_multibyte_characters))
599 return nbytes;
601 return multibyte_chars_in_text (ptr, nbytes);
604 /* Return the number of characters in the NBYTES bytes at PTR.
605 This works by looking at the contents and checking for multibyte
606 sequences while assuming that there's no invalid sequence. It
607 ignores enable-multibyte-characters. */
609 EMACS_INT
610 multibyte_chars_in_text (ptr, nbytes)
611 const unsigned char *ptr;
612 EMACS_INT nbytes;
614 const unsigned char *endp = ptr + nbytes;
615 int chars = 0;
617 while (ptr < endp)
619 int len = MULTIBYTE_LENGTH (ptr, endp);
621 if (len == 0)
622 abort ();
623 ptr += len;
624 chars++;
627 return chars;
630 /* Parse unibyte text at STR of LEN bytes as a multibyte text, count
631 characters and bytes in it, and store them in *NCHARS and *NBYTES
632 respectively. On counting bytes, pay attention to that 8-bit
633 characters not constructing a valid multibyte sequence are
634 represented by 2-byte in a multibyte text. */
636 void
637 parse_str_as_multibyte (str, len, nchars, nbytes)
638 const unsigned char *str;
639 int len, *nchars, *nbytes;
641 const unsigned char *endp = str + len;
642 int n, chars = 0, bytes = 0;
644 if (len >= MAX_MULTIBYTE_LENGTH)
646 const unsigned char *adjusted_endp = endp - MAX_MULTIBYTE_LENGTH;
647 while (str < adjusted_endp)
649 if ((n = MULTIBYTE_LENGTH_NO_CHECK (str)) > 0)
650 str += n, bytes += n;
651 else
652 str++, bytes += 2;
653 chars++;
656 while (str < endp)
658 if ((n = MULTIBYTE_LENGTH (str, endp)) > 0)
659 str += n, bytes += n;
660 else
661 str++, bytes += 2;
662 chars++;
665 *nchars = chars;
666 *nbytes = bytes;
667 return;
670 /* Arrange unibyte text at STR of NBYTES bytes as a multibyte text.
671 It actually converts only such 8-bit characters that don't contruct
672 a multibyte sequence to multibyte forms of Latin-1 characters. If
673 NCHARS is nonzero, set *NCHARS to the number of characters in the
674 text. It is assured that we can use LEN bytes at STR as a work
675 area and that is enough. Return the number of bytes of the
676 resulting text. */
679 str_as_multibyte (str, len, nbytes, nchars)
680 unsigned char *str;
681 int len, nbytes, *nchars;
683 unsigned char *p = str, *endp = str + nbytes;
684 unsigned char *to;
685 int chars = 0;
686 int n;
688 if (nbytes >= MAX_MULTIBYTE_LENGTH)
690 unsigned char *adjusted_endp = endp - MAX_MULTIBYTE_LENGTH;
691 while (p < adjusted_endp
692 && (n = MULTIBYTE_LENGTH_NO_CHECK (p)) > 0)
693 p += n, chars++;
695 while ((n = MULTIBYTE_LENGTH (p, endp)) > 0)
696 p += n, chars++;
697 if (nchars)
698 *nchars = chars;
699 if (p == endp)
700 return nbytes;
702 to = p;
703 nbytes = endp - p;
704 endp = str + len;
705 safe_bcopy ((char *) p, (char *) (endp - nbytes), nbytes);
706 p = endp - nbytes;
708 if (nbytes >= MAX_MULTIBYTE_LENGTH)
710 unsigned char *adjusted_endp = endp - MAX_MULTIBYTE_LENGTH;
711 while (p < adjusted_endp)
713 if ((n = MULTIBYTE_LENGTH_NO_CHECK (p)) > 0)
715 while (n--)
716 *to++ = *p++;
718 else
720 int c = *p++;
721 c = BYTE8_TO_CHAR (c);
722 to += CHAR_STRING (c, to);
725 chars++;
727 while (p < endp)
729 if ((n = MULTIBYTE_LENGTH (p, endp)) > 0)
731 while (n--)
732 *to++ = *p++;
734 else
736 int c = *p++;
737 c = BYTE8_TO_CHAR (c);
738 to += CHAR_STRING (c, to);
740 chars++;
742 if (nchars)
743 *nchars = chars;
744 return (to - str);
747 /* Parse unibyte string at STR of LEN bytes, and return the number of
748 bytes it may ocupy when converted to multibyte string by
749 `str_to_multibyte'. */
752 parse_str_to_multibyte (str, len)
753 unsigned char *str;
754 int len;
756 unsigned char *endp = str + len;
757 int bytes;
759 for (bytes = 0; str < endp; str++)
760 bytes += (*str < 0x80) ? 1 : 2;
761 return bytes;
765 /* Convert unibyte text at STR of NBYTES bytes to a multibyte text
766 that contains the same single-byte characters. It actually
767 converts all 8-bit characters to multibyte forms. It is assured
768 that we can use LEN bytes at STR as a work area and that is
769 enough. */
772 str_to_multibyte (str, len, bytes)
773 unsigned char *str;
774 int len, bytes;
776 unsigned char *p = str, *endp = str + bytes;
777 unsigned char *to;
779 while (p < endp && *p < 0x80) p++;
780 if (p == endp)
781 return bytes;
782 to = p;
783 bytes = endp - p;
784 endp = str + len;
785 safe_bcopy ((char *) p, (char *) (endp - bytes), bytes);
786 p = endp - bytes;
787 while (p < endp)
789 int c = *p++;
791 if (c >= 0x80)
792 c = BYTE8_TO_CHAR (c);
793 to += CHAR_STRING (c, to);
795 return (to - str);
798 /* Arrange multibyte text at STR of LEN bytes as a unibyte text. It
799 actually converts characters in the range 0x80..0xFF to
800 unibyte. */
803 str_as_unibyte (str, bytes)
804 unsigned char *str;
805 int bytes;
807 const unsigned char *p = str, *endp = str + bytes;
808 unsigned char *to;
809 int c, len;
811 while (p < endp)
813 c = *p;
814 len = BYTES_BY_CHAR_HEAD (c);
815 if (CHAR_BYTE8_HEAD_P (c))
816 break;
817 p += len;
819 to = str + (p - str);
820 while (p < endp)
822 c = *p;
823 len = BYTES_BY_CHAR_HEAD (c);
824 if (CHAR_BYTE8_HEAD_P (c))
826 c = STRING_CHAR_ADVANCE (p);
827 *to++ = CHAR_TO_BYTE8 (c);
829 else
831 while (len--) *to++ = *p++;
834 return (to - str);
838 string_count_byte8 (string)
839 Lisp_Object string;
841 int multibyte = STRING_MULTIBYTE (string);
842 int nbytes = SBYTES (string);
843 unsigned char *p = SDATA (string);
844 unsigned char *pend = p + nbytes;
845 int count = 0;
846 int c, len;
848 if (multibyte)
849 while (p < pend)
851 c = *p;
852 len = BYTES_BY_CHAR_HEAD (c);
854 if (CHAR_BYTE8_HEAD_P (c))
855 count++;
856 p += len;
858 else
859 while (p < pend)
861 if (*p++ >= 0x80)
862 count++;
864 return count;
868 Lisp_Object
869 string_escape_byte8 (string)
870 Lisp_Object string;
872 int nchars = SCHARS (string);
873 int nbytes = SBYTES (string);
874 int multibyte = STRING_MULTIBYTE (string);
875 int byte8_count;
876 const unsigned char *src, *src_end;
877 unsigned char *dst;
878 Lisp_Object val;
879 int c, len;
881 if (multibyte && nchars == nbytes)
882 return string;
884 byte8_count = string_count_byte8 (string);
886 if (byte8_count == 0)
887 return string;
889 if (multibyte)
890 /* Convert 2-byte sequence of byte8 chars to 4-byte octal. */
891 val = make_uninit_multibyte_string (nchars + byte8_count * 3,
892 nbytes + byte8_count * 2);
893 else
894 /* Convert 1-byte sequence of byte8 chars to 4-byte octal. */
895 val = make_uninit_string (nbytes + byte8_count * 3);
897 src = SDATA (string);
898 src_end = src + nbytes;
899 dst = SDATA (val);
900 if (multibyte)
901 while (src < src_end)
903 c = *src;
904 len = BYTES_BY_CHAR_HEAD (c);
906 if (CHAR_BYTE8_HEAD_P (c))
908 c = STRING_CHAR_ADVANCE (src);
909 c = CHAR_TO_BYTE8 (c);
910 sprintf ((char *) dst, "\\%03o", c);
911 dst += 4;
913 else
914 while (len--) *dst++ = *src++;
916 else
917 while (src < src_end)
919 c = *src++;
920 if (c >= 0x80)
922 sprintf ((char *) dst, "\\%03o", c);
923 dst += 4;
925 else
926 *dst++ = c;
928 return val;
932 DEFUN ("string", Fstring, Sstring, 0, MANY, 0,
933 doc: /*
934 Concatenate all the argument characters and make the result a string.
935 usage: (string &rest CHARACTERS) */)
936 (n, args)
937 int n;
938 Lisp_Object *args;
940 int i;
941 unsigned char *buf = (unsigned char *) alloca (MAX_MULTIBYTE_LENGTH * n);
942 unsigned char *p = buf;
943 int c;
945 for (i = 0; i < n; i++)
947 CHECK_CHARACTER (args[i]);
948 c = XINT (args[i]);
949 p += CHAR_STRING (c, p);
952 return make_string_from_bytes ((char *) buf, n, p - buf);
955 DEFUN ("unibyte-string", Funibyte_string, Sunibyte_string, 0, MANY, 0,
956 doc: /* Concatenate all the argument bytes and make the result a unibyte string.
957 usage: (unibyte-string &rest BYTES) */)
958 (n, args)
959 int n;
960 Lisp_Object *args;
962 int i;
963 unsigned char *buf = (unsigned char *) alloca (n);
964 unsigned char *p = buf;
965 unsigned c;
967 for (i = 0; i < n; i++)
969 CHECK_NATNUM (args[i]);
970 c = XFASTINT (args[i]);
971 if (c >= 256)
972 args_out_of_range_3 (args[i], make_number (0), make_number (255));
973 *p++ = c;
976 return make_string_from_bytes ((char *) buf, n, p - buf);
979 DEFUN ("char-resolve-modifers", Fchar_resolve_modifiers,
980 Schar_resolve_modifiers, 1, 1, 0,
981 doc: /* Resolve modifiers in the character CHAR.
982 The value is a character with modifiers resolved into the character
983 code. Unresolved modifiers are kept in the value.
984 usage: (char-resolve-modifers CHAR) */)
985 (character)
986 Lisp_Object character;
988 int c;
990 CHECK_NUMBER (character);
991 c = XINT (character);
992 return make_number (char_resolve_modifier_mask (c));
995 void
996 init_character_once ()
1000 #ifdef emacs
1002 void
1003 syms_of_character ()
1005 DEFSYM (Qcharacterp, "characterp");
1006 DEFSYM (Qauto_fill_chars, "auto-fill-chars");
1008 staticpro (&Vchar_unify_table);
1009 Vchar_unify_table = Qnil;
1011 defsubr (&Smax_char);
1012 defsubr (&Scharacterp);
1013 defsubr (&Sunibyte_char_to_multibyte);
1014 defsubr (&Smultibyte_char_to_unibyte);
1015 defsubr (&Schar_bytes);
1016 defsubr (&Schar_width);
1017 defsubr (&Sstring_width);
1018 defsubr (&Schar_direction);
1019 defsubr (&Sstring);
1020 defsubr (&Sunibyte_string);
1021 defsubr (&Schar_resolve_modifiers);
1023 DEFVAR_LISP ("translation-table-vector", &Vtranslation_table_vector,
1024 doc: /*
1025 Vector recording all translation tables ever defined.
1026 Each element is a pair (SYMBOL . TABLE) relating the table to the
1027 symbol naming it. The ID of a translation table is an index into this vector. */);
1028 Vtranslation_table_vector = Fmake_vector (make_number (16), Qnil);
1030 DEFVAR_LISP ("auto-fill-chars", &Vauto_fill_chars,
1031 doc: /*
1032 A char-table for characters which invoke auto-filling.
1033 Such characters have value t in this table. */);
1034 Vauto_fill_chars = Fmake_char_table (Qauto_fill_chars, Qnil);
1035 CHAR_TABLE_SET (Vauto_fill_chars, ' ', Qt);
1036 CHAR_TABLE_SET (Vauto_fill_chars, '\n', Qt);
1038 DEFVAR_LISP ("char-width-table", &Vchar_width_table,
1039 doc: /*
1040 A char-table for width (columns) of each character. */);
1041 Vchar_width_table = Fmake_char_table (Qnil, make_number (1));
1042 char_table_set_range (Vchar_width_table, 0x80, 0x9F, make_number (4));
1043 char_table_set_range (Vchar_width_table, MAX_5_BYTE_CHAR + 1, MAX_CHAR,
1044 make_number (4));
1046 DEFVAR_LISP ("char-direction-table", &Vchar_direction_table,
1047 doc: /* A char-table for direction of each character. */);
1048 Vchar_direction_table = Fmake_char_table (Qnil, make_number (1));
1050 DEFVAR_LISP ("printable-chars", &Vprintable_chars,
1051 doc: /* A char-table for each printable character. */);
1052 Vprintable_chars = Fmake_char_table (Qnil, Qnil);
1053 Fset_char_table_range (Vprintable_chars,
1054 Fcons (make_number (32), make_number (126)), Qt);
1055 Fset_char_table_range (Vprintable_chars,
1056 Fcons (make_number (160),
1057 make_number (MAX_5_BYTE_CHAR)), Qt);
1059 DEFVAR_LISP ("char-script-table", &Vchar_script_table,
1060 doc: /* Char table of script symbols.
1061 It has one extra slot whose value is a list of script symbols. */);
1063 /* Intern this now in case it isn't already done.
1064 Setting this variable twice is harmless.
1065 But don't staticpro it here--that is done in alloc.c. */
1066 Qchar_table_extra_slots = intern ("char-table-extra-slots");
1067 DEFSYM (Qchar_script_table, "char-script-table");
1068 Fput (Qchar_script_table, Qchar_table_extra_slots, make_number (1));
1069 Vchar_script_table = Fmake_char_table (Qchar_script_table, Qnil);
1071 DEFVAR_LISP ("script-representative-chars", &Vscript_representative_chars,
1072 doc: /* Alist of scripts vs the representative characters. */);
1073 Vscript_representative_chars = Qnil;
1076 #endif /* emacs */
1078 /* arch-tag: b6665960-3c3d-4184-85cd-af4318197999
1079 (do not change this comment) */