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
36 #include <sys/types.h>
39 #include "character.h"
42 #include "composite.h"
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
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. */
96 char_resolve_modifier_mask (c
)
99 /* A non-ASCII character can't reflect modifier bits to the code. */
100 if (! ASCII_CHAR_P ((c
& ~CHAR_MODIFIER_MASK
)))
103 /* For Meta, Shift, and Control modifiers, we need special care. */
106 /* Shift modifier is valid only with [A-Za-z]. */
107 if ((c
& 0377) >= 'A' && (c
& 0377) <= 'Z')
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)
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) */
133 /* Move the meta bit to the right place for a string. */
134 c
= (c
& ~CHAR_META
) | 0x80;
142 /* Store multibyte form of character C at P. If C has modifier bits,
143 handle them appropriately. */
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));
173 else if (c
<= MAX_5_BYTE_CHAR
)
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));
182 else if (c
<= MAX_CHAR
)
184 c
= CHAR_TO_BYTE8 (c
);
185 bytes
= BYTE8_STRING (c
, p
);
188 error ("Invalid character: %d", c
);
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
;
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)
224 c
= ((((p
)[1] & 0x3F) << 18)
225 | (((p
)[2] & 0x3F) << 12)
226 | (((p
)[3] & 0x3F) << 6)
231 MAYBE_UNIFY_CHAR (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
)
252 if (CHAR_TABLE_P (table
))
256 ch
= CHAR_TABLE_REF (table
, c
);
262 for (; CONSP (table
); table
= XCDR (table
))
263 c
= translate_char (XCAR (table
), 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
275 multibyte_char_to_unibyte (c
, rev_tbl
)
281 if (CHAR_BYTE8_P (c
))
282 return CHAR_TO_BYTE8 (c
);
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
)
295 if (CHAR_BYTE8_P (c
))
296 return CHAR_TO_BYTE8 (c
);
300 DEFUN ("characterp", Fcharacterp
, Scharacterp
, 1, 2, 0,
301 doc
: /* Return non-nil if OBJECT is a character. */)
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. */)
323 CHECK_CHARACTER (ch
);
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. */)
340 CHECK_CHARACTER (ch
);
343 /* Can't distinguish a byte read from a unibyte buffer from
344 a latin1 char, so let's let it slide. */
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) */)
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) */)
374 struct Lisp_Char_Table
*dp
= buffer_display_table ();
376 CHECK_CHARACTER (ch
);
379 /* Get the way the display table would display it. */
380 disp
= dp
? DISP_CHAR_VECTOR (dp
, c
) : Qnil
;
383 width
= ASIZE (disp
);
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
398 c_string_width (const unsigned char *str
, int len
, int precision
, int *nchars
, int *nbytes
)
400 int i
= 0, i_byte
= 0;
402 struct Lisp_Char_Table
*dp
= buffer_display_table ();
406 int bytes
, thiswidth
;
408 int c
= STRING_CHAR_AND_LENGTH (str
+ i_byte
, bytes
);
412 val
= DISP_CHAR_VECTOR (dp
, c
);
414 thiswidth
= XVECTOR (val
)->size
;
416 thiswidth
= CHAR_WIDTH (c
);
420 thiswidth
= CHAR_WIDTH (c
);
424 && (width
+ thiswidth
> precision
))
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. */
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
)
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
472 int multibyte
= len
< SBYTES (string
);
473 unsigned char *str
= SDATA (string
);
474 int i
= 0, i_byte
= 0;
476 struct Lisp_Char_Table
*dp
= buffer_display_table ();
480 int chars
, bytes
, thiswidth
;
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
))
489 thiswidth
= composition_table
[cmp_id
]->width
;
491 bytes
= string_char_to_byte (string
, end
) - i_byte
;
498 c
= STRING_CHAR_AND_LENGTH (str
+ i_byte
, bytes
);
500 c
= str
[i_byte
], bytes
= 1;
504 val
= DISP_CHAR_VECTOR (dp
, c
);
506 thiswidth
= XVECTOR (val
)->size
;
508 thiswidth
= CHAR_WIDTH (c
);
512 thiswidth
= CHAR_WIDTH (c
);
517 && (width
+ thiswidth
> precision
))
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) */)
551 XSETFASTINT (val
, lisp_string_width (str
, -1, NULL
, NULL
));
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) */)
564 CHECK_CHARACTER (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. */
576 chars_in_text (ptr
, nbytes
)
577 const unsigned char *ptr
;
580 /* current_buffer is null at early stages of Emacs initialization. */
581 if (current_buffer
== 0
582 || NILP (current_buffer
->enable_multibyte_characters
))
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. */
594 multibyte_chars_in_text (ptr
, nbytes
)
595 const unsigned char *ptr
;
598 const unsigned char *endp
= ptr
+ nbytes
;
603 int len
= MULTIBYTE_LENGTH (ptr
, endp
);
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. */
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
;
643 if (! CHAR_BYTE8_HEAD_P (*str
)
644 && (n
= MULTIBYTE_LENGTH (str
, endp
)) > 0)
645 str
+= n
, bytes
+= n
;
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
665 str_as_multibyte (str
, len
, nbytes
, nchars
)
667 int len
, nbytes
, *nchars
;
669 unsigned char *p
= str
, *endp
= str
+ nbytes
;
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)
683 && ! CHAR_BYTE8_HEAD_P (*p
)
684 && (n
= MULTIBYTE_LENGTH (p
, endp
)) > 0)
694 safe_bcopy ((char *) p
, (char *) (endp
- nbytes
), 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)
711 c
= BYTE8_TO_CHAR (c
);
712 to
+= CHAR_STRING (c
, to
);
719 if (! CHAR_BYTE8_HEAD_P (*p
)
720 && (n
= MULTIBYTE_LENGTH (p
, endp
)) > 0)
728 c
= BYTE8_TO_CHAR (c
);
729 to
+= CHAR_STRING (c
, to
);
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
)
747 unsigned char *endp
= str
+ len
;
750 for (bytes
= 0; str
< endp
; str
++)
751 bytes
+= (*str
< 0x80) ? 1 : 2;
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
763 str_to_multibyte (str
, len
, bytes
)
767 unsigned char *p
= str
, *endp
= str
+ bytes
;
770 while (p
< endp
&& *p
< 0x80) p
++;
776 safe_bcopy ((char *) p
, (char *) (endp
- bytes
), bytes
);
783 c
= BYTE8_TO_CHAR (c
);
784 to
+= CHAR_STRING (c
, to
);
789 /* Arrange multibyte text at STR of LEN bytes as a unibyte text. It
790 actually converts characters in the range 0x80..0xFF to
794 str_as_unibyte (str
, bytes
)
798 const unsigned char *p
= str
, *endp
= str
+ bytes
;
805 len
= BYTES_BY_CHAR_HEAD (c
);
806 if (CHAR_BYTE8_HEAD_P (c
))
810 to
= str
+ (p
- str
);
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
);
822 while (len
--) *to
++ = *p
++;
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. */
838 str_to_unibyte (src
, dst
, chars
, accept_latin_1
)
839 const unsigned char *src
;
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))
862 string_count_byte8 (string
)
865 int multibyte
= STRING_MULTIBYTE (string
);
866 int nbytes
= SBYTES (string
);
867 unsigned char *p
= SDATA (string
);
868 unsigned char *pend
= p
+ nbytes
;
876 len
= BYTES_BY_CHAR_HEAD (c
);
878 if (CHAR_BYTE8_HEAD_P (c
))
893 string_escape_byte8 (string
)
896 int nchars
= SCHARS (string
);
897 int nbytes
= SBYTES (string
);
898 int multibyte
= STRING_MULTIBYTE (string
);
900 const unsigned char *src
, *src_end
;
905 if (multibyte
&& nchars
== nbytes
)
908 byte8_count
= string_count_byte8 (string
);
910 if (byte8_count
== 0)
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);
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
;
925 while (src
< src_end
)
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
);
938 while (len
--) *dst
++ = *src
++;
941 while (src
< src_end
)
946 sprintf ((char *) dst
, "\\%03o", c
);
956 DEFUN ("string", Fstring
, Sstring
, 0, MANY
, 0,
958 Concatenate all the argument characters and make the result a string.
959 usage: (string &rest CHARACTERS) */)
965 unsigned char *buf
= (unsigned char *) alloca (MAX_MULTIBYTE_LENGTH
* n
);
966 unsigned char *p
= buf
;
969 for (i
= 0; i
< n
; i
++)
971 CHECK_CHARACTER (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) */)
987 unsigned char *buf
= (unsigned char *) alloca (n
);
988 unsigned char *p
= buf
;
991 for (i
= 0; i
< n
; i
++)
993 CHECK_NATNUM (args
[i
]);
994 c
= XFASTINT (args
[i
]);
996 args_out_of_range_3 (args
[i
], make_number (0), make_number (255));
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) */)
1010 Lisp_Object character
;
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
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. */)
1030 Lisp_Object position
, string
;
1038 if (NILP (position
))
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
);
1055 CHECK_STRING (string
);
1056 if (NILP (position
))
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
);
1081 init_character_once ()
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
);
1105 defsubr (&Sunibyte_string
);
1106 defsubr (&Schar_resolve_modifiers
);
1107 defsubr (&Sget_byte
);
1109 DEFVAR_LISP ("translation-table-vector", &Vtranslation_table_vector
,
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
,
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
,
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
,
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
;
1179 /* arch-tag: b6665960-3c3d-4184-85cd-af4318197999
1180 (do not change this comment) */