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
5 Free Software Foundation, Inc.
6 Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009
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
));
132 /* Move the meta bit to the right place for a string. */
133 c
= (c
& ~CHAR_META
) | 0x80;
140 /* Store multibyte form of character C at P. If C has modifier bits,
141 handle them appropriately. */
150 if (c
& CHAR_MODIFIER_MASK
)
152 c
= (unsigned) char_resolve_modifier_mask ((int) c
);
153 /* If C still has any modifier bits, just ignore it. */
154 c
&= ~CHAR_MODIFIER_MASK
;
157 MAYBE_UNIFY_CHAR (c
);
159 if (c
<= MAX_3_BYTE_CHAR
)
161 bytes
= CHAR_STRING (c
, p
);
163 else if (c
<= MAX_4_BYTE_CHAR
)
165 p
[0] = (0xF0 | (c
>> 18));
166 p
[1] = (0x80 | ((c
>> 12) & 0x3F));
167 p
[2] = (0x80 | ((c
>> 6) & 0x3F));
168 p
[3] = (0x80 | (c
& 0x3F));
171 else if (c
<= MAX_5_BYTE_CHAR
)
174 p
[1] = (0x80 | ((c
>> 18) & 0x0F));
175 p
[2] = (0x80 | ((c
>> 12) & 0x3F));
176 p
[3] = (0x80 | ((c
>> 6) & 0x3F));
177 p
[4] = (0x80 | (c
& 0x3F));
180 else if (c
<= MAX_CHAR
)
182 c
= CHAR_TO_BYTE8 (c
);
183 bytes
= BYTE8_STRING (c
, p
);
186 error ("Invalid character: %d", c
);
192 /* Return a character whose multibyte form is at P. Set LEN is not
193 NULL, it must be a pointer to integer. In that case, set *LEN to
194 the byte length of the multibyte form. If ADVANCED is not NULL, is
195 must be a pointer to unsigned char. In that case, set *ADVANCED to
196 the ending address (i.e. the starting address of the next
197 character) of the multibyte form. */
200 string_char (p
, advanced
, len
)
201 const unsigned char *p
;
202 const unsigned char **advanced
;
206 const unsigned char *saved_p
= p
;
208 if (*p
< 0x80 || ! (*p
& 0x20) || ! (*p
& 0x10))
210 c
= STRING_CHAR_ADVANCE (p
);
212 else if (! (*p
& 0x08))
214 c
= ((((p
)[0] & 0xF) << 18)
215 | (((p
)[1] & 0x3F) << 12)
216 | (((p
)[2] & 0x3F) << 6)
222 c
= ((((p
)[1] & 0x3F) << 18)
223 | (((p
)[2] & 0x3F) << 12)
224 | (((p
)[3] & 0x3F) << 6)
229 MAYBE_UNIFY_CHAR (c
);
239 /* Translate character C by translation table TABLE. If C is
240 negative, translate a character specified by CHARSET and CODE. If
241 no translation is found in TABLE, return the untranslated
242 character. If TABLE is a list, elements are char tables. In this
243 case, translace C by all tables. */
246 translate_char (table
, c
)
250 if (CHAR_TABLE_P (table
))
254 ch
= CHAR_TABLE_REF (table
, c
);
260 for (; CONSP (table
); table
= XCDR (table
))
261 c
= translate_char (XCAR (table
), c
);
266 /* Convert ASCII or 8-bit character C to unibyte. If C is none of
267 them, return (C & 0xFF).
269 The argument REV_TBL is now ignored. It will be removed in the
273 multibyte_char_to_unibyte (c
, rev_tbl
)
279 if (CHAR_BYTE8_P (c
))
280 return CHAR_TO_BYTE8 (c
);
284 /* Like multibyte_char_to_unibyte, but return -1 if C is not supported
285 by charset_unibyte. */
288 multibyte_char_to_unibyte_safe (c
)
293 if (CHAR_BYTE8_P (c
))
294 return CHAR_TO_BYTE8 (c
);
298 DEFUN ("characterp", Fcharacterp
, Scharacterp
, 1, 2, 0,
299 doc
: /* Return non-nil if OBJECT is a character. */)
301 Lisp_Object object
, ignore
;
303 return (CHARACTERP (object
) ? Qt
: Qnil
);
306 DEFUN ("max-char", Fmax_char
, Smax_char
, 0, 0, 0,
307 doc
: /* Return the character of the maximum code. */)
310 return make_number (MAX_CHAR
);
313 DEFUN ("unibyte-char-to-multibyte", Funibyte_char_to_multibyte
,
314 Sunibyte_char_to_multibyte
, 1, 1, 0,
315 doc
: /* Convert the byte CH to multibyte character. */)
321 CHECK_CHARACTER (ch
);
324 error ("Not a unibyte character: %d", c
);
325 MAKE_CHAR_MULTIBYTE (c
);
326 return make_number (c
);
329 DEFUN ("multibyte-char-to-unibyte", Fmultibyte_char_to_unibyte
,
330 Smultibyte_char_to_unibyte
, 1, 1, 0,
331 doc
: /* Convert the multibyte character CH to a byte.
332 If the multibyte character does not represent a byte, return -1. */)
338 CHECK_CHARACTER (ch
);
341 /* Can't distinguish a byte read from a unibyte buffer from
342 a latin1 char, so let's let it slide. */
346 int cu
= CHAR_TO_BYTE_SAFE (cm
);
347 return make_number (cu
);
351 DEFUN ("char-bytes", Fchar_bytes
, Schar_bytes
, 1, 1, 0,
352 doc
: /* Return 1 regardless of the argument CHAR.
353 This is now an obsolete function. We keep it just for backward compatibility.
354 usage: (char-bytes CHAR) */)
358 CHECK_CHARACTER (ch
);
359 return make_number (1);
362 DEFUN ("char-width", Fchar_width
, Schar_width
, 1, 1, 0,
363 doc
: /* Return width of CHAR when displayed in the current buffer.
364 The width is measured by how many columns it occupies on the screen.
365 Tab is taken to occupy `tab-width' columns.
366 usage: (char-width CHAR) */)
372 struct Lisp_Char_Table
*dp
= buffer_display_table ();
374 CHECK_CHARACTER (ch
);
377 /* Get the way the display table would display it. */
378 disp
= dp
? DISP_CHAR_VECTOR (dp
, c
) : Qnil
;
381 width
= ASIZE (disp
);
383 width
= CHAR_WIDTH (c
);
385 return make_number (width
);
388 /* Return width of string STR of length LEN when displayed in the
389 current buffer. The width is measured by how many columns it
390 occupies on the screen. If PRECISION > 0, return the width of
391 longest substring that doesn't exceed PRECISION, and set number of
392 characters and bytes of the substring in *NCHARS and *NBYTES
396 c_string_width (const unsigned char *str
, int len
, int precision
, int *nchars
, int *nbytes
)
398 int i
= 0, i_byte
= 0;
400 struct Lisp_Char_Table
*dp
= buffer_display_table ();
404 int bytes
, thiswidth
;
406 int c
= STRING_CHAR_AND_LENGTH (str
+ i_byte
, len
- i_byte
, bytes
);
410 val
= DISP_CHAR_VECTOR (dp
, c
);
412 thiswidth
= XVECTOR (val
)->size
;
414 thiswidth
= CHAR_WIDTH (c
);
418 thiswidth
= CHAR_WIDTH (c
);
422 && (width
+ thiswidth
> precision
))
442 /* Return width of string STR of length LEN when displayed in the
443 current buffer. The width is measured by how many columns it
444 occupies on the screen. */
451 return c_string_width (str
, len
, -1, NULL
, NULL
);
454 /* Return width of Lisp string STRING when displayed in the current
455 buffer. The width is measured by how many columns it occupies on
456 the screen while paying attention to compositions. If PRECISION >
457 0, return the width of longest substring that doesn't exceed
458 PRECISION, and set number of characters and bytes of the substring
459 in *NCHARS and *NBYTES respectively. */
462 lisp_string_width (string
, precision
, nchars
, nbytes
)
464 int precision
, *nchars
, *nbytes
;
466 int len
= SCHARS (string
);
467 /* This set multibyte to 0 even if STRING is multibyte when it
468 contains only ascii and eight-bit-graphic, but that's
470 int multibyte
= len
< SBYTES (string
);
471 unsigned char *str
= SDATA (string
);
472 int i
= 0, i_byte
= 0;
474 struct Lisp_Char_Table
*dp
= buffer_display_table ();
478 int chars
, bytes
, thiswidth
;
481 EMACS_INT ignore
, end
;
483 if (find_composition (i
, -1, &ignore
, &end
, &val
, string
)
484 && ((cmp_id
= get_composition_id (i
, i_byte
, end
- i
, val
, string
))
487 thiswidth
= composition_table
[cmp_id
]->width
;
489 bytes
= string_char_to_byte (string
, end
) - i_byte
;
496 c
= STRING_CHAR_AND_LENGTH (str
+ i_byte
, len
- i_byte
, bytes
);
498 c
= str
[i_byte
], bytes
= 1;
502 val
= DISP_CHAR_VECTOR (dp
, c
);
504 thiswidth
= XVECTOR (val
)->size
;
506 thiswidth
= CHAR_WIDTH (c
);
510 thiswidth
= CHAR_WIDTH (c
);
515 && (width
+ thiswidth
> precision
))
535 DEFUN ("string-width", Fstring_width
, Sstring_width
, 1, 1, 0,
536 doc
: /* Return width of STRING when displayed in the current buffer.
537 Width is measured by how many columns it occupies on the screen.
538 When calculating width of a multibyte character in STRING,
539 only the base leading-code is considered; the validity of
540 the following bytes is not checked. Tabs in STRING are always
541 taken to occupy `tab-width' columns.
542 usage: (string-width STRING) */)
549 XSETFASTINT (val
, lisp_string_width (str
, -1, NULL
, NULL
));
553 DEFUN ("char-direction", Fchar_direction
, Schar_direction
, 1, 1, 0,
554 doc
: /* Return the direction of CHAR.
555 The returned value is 0 for left-to-right and 1 for right-to-left.
556 usage: (char-direction CHAR) */)
562 CHECK_CHARACTER (ch
);
564 return CHAR_TABLE_REF (Vchar_direction_table
, c
);
567 /* Return the number of characters in the NBYTES bytes at PTR.
568 This works by looking at the contents and checking for multibyte
569 sequences while assuming that there's no invalid sequence.
570 However, if the current buffer has enable-multibyte-characters =
571 nil, we treat each byte as a character. */
574 chars_in_text (ptr
, nbytes
)
575 const unsigned char *ptr
;
578 /* current_buffer is null at early stages of Emacs initialization. */
579 if (current_buffer
== 0
580 || NILP (current_buffer
->enable_multibyte_characters
))
583 return multibyte_chars_in_text (ptr
, nbytes
);
586 /* Return the number of characters in the NBYTES bytes at PTR.
587 This works by looking at the contents and checking for multibyte
588 sequences while assuming that there's no invalid sequence. It
589 ignores enable-multibyte-characters. */
592 multibyte_chars_in_text (ptr
, nbytes
)
593 const unsigned char *ptr
;
596 const unsigned char *endp
= ptr
+ nbytes
;
601 int len
= MULTIBYTE_LENGTH (ptr
, endp
);
612 /* Parse unibyte text at STR of LEN bytes as a multibyte text, count
613 characters and bytes in it, and store them in *NCHARS and *NBYTES
614 respectively. On counting bytes, pay attention to that 8-bit
615 characters not constructing a valid multibyte sequence are
616 represented by 2-byte in a multibyte text. */
619 parse_str_as_multibyte (str
, len
, nchars
, nbytes
)
620 const unsigned char *str
;
621 int len
, *nchars
, *nbytes
;
623 const unsigned char *endp
= str
+ len
;
624 int n
, chars
= 0, bytes
= 0;
626 if (len
>= MAX_MULTIBYTE_LENGTH
)
628 const unsigned char *adjusted_endp
= endp
- MAX_MULTIBYTE_LENGTH
;
629 while (str
< adjusted_endp
)
631 if ((n
= MULTIBYTE_LENGTH_NO_CHECK (str
)) > 0)
632 str
+= n
, bytes
+= n
;
640 if ((n
= MULTIBYTE_LENGTH (str
, endp
)) > 0)
641 str
+= n
, bytes
+= n
;
652 /* Arrange unibyte text at STR of NBYTES bytes as a multibyte text.
653 It actually converts only such 8-bit characters that don't contruct
654 a multibyte sequence to multibyte forms of Latin-1 characters. If
655 NCHARS is nonzero, set *NCHARS to the number of characters in the
656 text. It is assured that we can use LEN bytes at STR as a work
657 area and that is enough. Return the number of bytes of the
661 str_as_multibyte (str
, len
, nbytes
, nchars
)
663 int len
, nbytes
, *nchars
;
665 unsigned char *p
= str
, *endp
= str
+ nbytes
;
670 if (nbytes
>= MAX_MULTIBYTE_LENGTH
)
672 unsigned char *adjusted_endp
= endp
- MAX_MULTIBYTE_LENGTH
;
673 while (p
< adjusted_endp
674 && (n
= MULTIBYTE_LENGTH_NO_CHECK (p
)) > 0)
677 while ((n
= MULTIBYTE_LENGTH (p
, endp
)) > 0)
687 safe_bcopy ((char *) p
, (char *) (endp
- nbytes
), nbytes
);
690 if (nbytes
>= MAX_MULTIBYTE_LENGTH
)
692 unsigned char *adjusted_endp
= endp
- MAX_MULTIBYTE_LENGTH
;
693 while (p
< adjusted_endp
)
695 if ((n
= MULTIBYTE_LENGTH_NO_CHECK (p
)) > 0)
703 c
= BYTE8_TO_CHAR (c
);
704 to
+= CHAR_STRING (c
, to
);
711 if ((n
= MULTIBYTE_LENGTH (p
, endp
)) > 0)
719 c
= BYTE8_TO_CHAR (c
);
720 to
+= CHAR_STRING (c
, to
);
729 /* Parse unibyte string at STR of LEN bytes, and return the number of
730 bytes it may ocupy when converted to multibyte string by
731 `str_to_multibyte'. */
734 parse_str_to_multibyte (str
, len
)
738 unsigned char *endp
= str
+ len
;
741 for (bytes
= 0; str
< endp
; str
++)
742 bytes
+= (*str
< 0x80) ? 1 : 2;
747 /* Convert unibyte text at STR of NBYTES bytes to a multibyte text
748 that contains the same single-byte characters. It actually
749 converts all 8-bit characters to multibyte forms. It is assured
750 that we can use LEN bytes at STR as a work area and that is
754 str_to_multibyte (str
, len
, bytes
)
758 unsigned char *p
= str
, *endp
= str
+ bytes
;
761 while (p
< endp
&& *p
< 0x80) p
++;
767 safe_bcopy ((char *) p
, (char *) (endp
- bytes
), bytes
);
774 c
= BYTE8_TO_CHAR (c
);
775 to
+= CHAR_STRING (c
, to
);
780 /* Arrange multibyte text at STR of LEN bytes as a unibyte text. It
781 actually converts characters in the range 0x80..0xFF to
785 str_as_unibyte (str
, bytes
)
789 const unsigned char *p
= str
, *endp
= str
+ bytes
;
796 len
= BYTES_BY_CHAR_HEAD (c
);
797 if (CHAR_BYTE8_HEAD_P (c
))
801 to
= str
+ (p
- str
);
805 len
= BYTES_BY_CHAR_HEAD (c
);
806 if (CHAR_BYTE8_HEAD_P (c
))
808 c
= STRING_CHAR_ADVANCE (p
);
809 *to
++ = CHAR_TO_BYTE8 (c
);
813 while (len
--) *to
++ = *p
++;
819 /* Convert eight-bit chars in SRC (in multibyte form) to the
820 corresponding byte and store in DST. CHARS is the number of
821 characters in SRC. The value is the number of bytes stored in DST.
822 Usually, the value is the same as CHARS, but is less than it if SRC
823 contains a non-ASCII, non-eight-bit characater. If ACCEPT_LATIN_1
824 is nonzero, a Latin-1 character is accepted and converted to a byte
825 of that character code.
826 Note: Currently the arg ACCEPT_LATIN_1 is not used. */
829 str_to_unibyte (src
, dst
, chars
, accept_latin_1
)
830 const unsigned char *src
;
837 for (i
= 0; i
< chars
; i
++)
839 int c
= STRING_CHAR_ADVANCE (src
);
841 if (CHAR_BYTE8_P (c
))
842 c
= CHAR_TO_BYTE8 (c
);
843 else if (! ASCII_CHAR_P (c
)
844 && (! accept_latin_1
|| c
>= 0x100))
853 string_count_byte8 (string
)
856 int multibyte
= STRING_MULTIBYTE (string
);
857 int nbytes
= SBYTES (string
);
858 unsigned char *p
= SDATA (string
);
859 unsigned char *pend
= p
+ nbytes
;
867 len
= BYTES_BY_CHAR_HEAD (c
);
869 if (CHAR_BYTE8_HEAD_P (c
))
884 string_escape_byte8 (string
)
887 int nchars
= SCHARS (string
);
888 int nbytes
= SBYTES (string
);
889 int multibyte
= STRING_MULTIBYTE (string
);
891 const unsigned char *src
, *src_end
;
896 if (multibyte
&& nchars
== nbytes
)
899 byte8_count
= string_count_byte8 (string
);
901 if (byte8_count
== 0)
905 /* Convert 2-byte sequence of byte8 chars to 4-byte octal. */
906 val
= make_uninit_multibyte_string (nchars
+ byte8_count
* 3,
907 nbytes
+ byte8_count
* 2);
909 /* Convert 1-byte sequence of byte8 chars to 4-byte octal. */
910 val
= make_uninit_string (nbytes
+ byte8_count
* 3);
912 src
= SDATA (string
);
913 src_end
= src
+ nbytes
;
916 while (src
< src_end
)
919 len
= BYTES_BY_CHAR_HEAD (c
);
921 if (CHAR_BYTE8_HEAD_P (c
))
923 c
= STRING_CHAR_ADVANCE (src
);
924 c
= CHAR_TO_BYTE8 (c
);
925 sprintf ((char *) dst
, "\\%03o", c
);
929 while (len
--) *dst
++ = *src
++;
932 while (src
< src_end
)
937 sprintf ((char *) dst
, "\\%03o", c
);
947 DEFUN ("string", Fstring
, Sstring
, 0, MANY
, 0,
949 Concatenate all the argument characters and make the result a string.
950 usage: (string &rest CHARACTERS) */)
956 unsigned char *buf
= (unsigned char *) alloca (MAX_MULTIBYTE_LENGTH
* n
);
957 unsigned char *p
= buf
;
960 for (i
= 0; i
< n
; i
++)
962 CHECK_CHARACTER (args
[i
]);
964 p
+= CHAR_STRING (c
, p
);
967 return make_string_from_bytes ((char *) buf
, n
, p
- buf
);
970 DEFUN ("unibyte-string", Funibyte_string
, Sunibyte_string
, 0, MANY
, 0,
971 doc
: /* Concatenate all the argument bytes and make the result a unibyte string.
972 usage: (unibyte-string &rest BYTES) */)
978 unsigned char *buf
= (unsigned char *) alloca (n
);
979 unsigned char *p
= buf
;
982 for (i
= 0; i
< n
; i
++)
984 CHECK_NATNUM (args
[i
]);
985 c
= XFASTINT (args
[i
]);
987 args_out_of_range_3 (args
[i
], make_number (0), make_number (255));
991 return make_string_from_bytes ((char *) buf
, n
, p
- buf
);
994 DEFUN ("char-resolve-modifiers", Fchar_resolve_modifiers
,
995 Schar_resolve_modifiers
, 1, 1, 0,
996 doc
: /* Resolve modifiers in the character CHAR.
997 The value is a character with modifiers resolved into the character
998 code. Unresolved modifiers are kept in the value.
999 usage: (char-resolve-modifiers CHAR) */)
1001 Lisp_Object character
;
1005 CHECK_NUMBER (character
);
1006 c
= XINT (character
);
1007 return make_number (char_resolve_modifier_mask (c
));
1010 DEFUN ("get-byte", Fget_byte
, Sget_byte
, 0, 2, 0,
1011 doc
: /* Return a byte value of a character at point.
1012 Optional 1st arg POSITION, if non-nil, is a position of a character to get
1014 Optional 2nd arg STRING, if non-nil, is a string of which first
1015 character is a target to get a byte value. In this case, POSITION, if
1016 non-nil, is an index of a target character in the string.
1018 If the current buffer (or STRING) is multibyte, and the target
1019 character is not ASCII nor 8-bit character, an error is signalled. */)
1021 Lisp_Object position
, string
;
1029 if (NILP (position
))
1035 CHECK_NUMBER_COERCE_MARKER (position
);
1036 if (XINT (position
) < BEGV
|| XINT (position
) >= ZV
)
1037 args_out_of_range_3 (position
, make_number (BEGV
), make_number (ZV
));
1038 pos
= XFASTINT (position
);
1039 p
= CHAR_POS_ADDR (pos
);
1041 if (NILP (current_buffer
->enable_multibyte_characters
))
1042 return make_number (*p
);
1046 CHECK_STRING (string
);
1047 if (NILP (position
))
1053 CHECK_NATNUM (position
);
1054 if (XINT (position
) >= SCHARS (string
))
1055 args_out_of_range (string
, position
);
1056 pos
= XFASTINT (position
);
1057 p
= SDATA (string
) + string_char_to_byte (string
, pos
);
1059 if (! STRING_MULTIBYTE (string
))
1060 return make_number (*p
);
1062 c
= STRING_CHAR (p
, 0);
1063 if (CHAR_BYTE8_P (c
))
1064 c
= CHAR_TO_BYTE8 (c
);
1065 else if (! ASCII_CHAR_P (c
))
1066 error ("Not an ASCII nor an 8-bit character: %d", c
);
1067 return make_number (c
);
1072 init_character_once ()
1079 syms_of_character ()
1081 DEFSYM (Qcharacterp
, "characterp");
1082 DEFSYM (Qauto_fill_chars
, "auto-fill-chars");
1084 staticpro (&Vchar_unify_table
);
1085 Vchar_unify_table
= Qnil
;
1087 defsubr (&Smax_char
);
1088 defsubr (&Scharacterp
);
1089 defsubr (&Sunibyte_char_to_multibyte
);
1090 defsubr (&Smultibyte_char_to_unibyte
);
1091 defsubr (&Schar_bytes
);
1092 defsubr (&Schar_width
);
1093 defsubr (&Sstring_width
);
1094 defsubr (&Schar_direction
);
1096 defsubr (&Sunibyte_string
);
1097 defsubr (&Schar_resolve_modifiers
);
1098 defsubr (&Sget_byte
);
1100 DEFVAR_LISP ("translation-table-vector", &Vtranslation_table_vector
,
1102 Vector recording all translation tables ever defined.
1103 Each element is a pair (SYMBOL . TABLE) relating the table to the
1104 symbol naming it. The ID of a translation table is an index into this vector. */);
1105 Vtranslation_table_vector
= Fmake_vector (make_number (16), Qnil
);
1107 DEFVAR_LISP ("auto-fill-chars", &Vauto_fill_chars
,
1109 A char-table for characters which invoke auto-filling.
1110 Such characters have value t in this table. */);
1111 Vauto_fill_chars
= Fmake_char_table (Qauto_fill_chars
, Qnil
);
1112 CHAR_TABLE_SET (Vauto_fill_chars
, ' ', Qt
);
1113 CHAR_TABLE_SET (Vauto_fill_chars
, '\n', Qt
);
1115 DEFVAR_LISP ("char-width-table", &Vchar_width_table
,
1117 A char-table for width (columns) of each character. */);
1118 Vchar_width_table
= Fmake_char_table (Qnil
, make_number (1));
1119 char_table_set_range (Vchar_width_table
, 0x80, 0x9F, make_number (4));
1120 char_table_set_range (Vchar_width_table
, MAX_5_BYTE_CHAR
+ 1, MAX_CHAR
,
1123 DEFVAR_LISP ("char-direction-table", &Vchar_direction_table
,
1124 doc
: /* A char-table for direction of each character. */);
1125 Vchar_direction_table
= Fmake_char_table (Qnil
, make_number (1));
1127 DEFVAR_LISP ("printable-chars", &Vprintable_chars
,
1128 doc
: /* A char-table for each printable character. */);
1129 Vprintable_chars
= Fmake_char_table (Qnil
, Qnil
);
1130 Fset_char_table_range (Vprintable_chars
,
1131 Fcons (make_number (32), make_number (126)), Qt
);
1132 Fset_char_table_range (Vprintable_chars
,
1133 Fcons (make_number (160),
1134 make_number (MAX_5_BYTE_CHAR
)), Qt
);
1136 DEFVAR_LISP ("char-script-table", &Vchar_script_table
,
1137 doc
: /* Char table of script symbols.
1138 It has one extra slot whose value is a list of script symbols. */);
1140 /* Intern this now in case it isn't already done.
1141 Setting this variable twice is harmless.
1142 But don't staticpro it here--that is done in alloc.c. */
1143 Qchar_table_extra_slots
= intern ("char-table-extra-slots");
1144 DEFSYM (Qchar_script_table
, "char-script-table");
1145 Fput (Qchar_script_table
, Qchar_table_extra_slots
, make_number (1));
1146 Vchar_script_table
= Fmake_char_table (Qchar_script_table
, Qnil
);
1148 DEFVAR_LISP ("script-representative-chars", &Vscript_representative_chars
,
1149 doc
: /* Alist of scripts vs the representative characters.
1150 Each element is a cons (SCRIPT . CHARS).
1151 SCRIPT is a symbol representing a script or a subgroup of a script.
1152 CHARS is a list or a vector of characters.
1153 If it is a list, all characters in the list are necessary for supporting SCRIPT.
1154 If it is a vector, one of the characters in the vector is necessary.
1155 This variable is used to find a font for a specific script. */);
1156 Vscript_representative_chars
= Qnil
;
1158 DEFVAR_LISP ("unicode-category-table", &Vunicode_category_table
,
1159 doc
: /* Char table of Unicode's "General Category".
1160 All Unicode characters have one of the following values (symbol):
1161 Lu, Ll, Lt, Lm, Lo, Mn, Mc, Me, Nd, Nl, No, Pc, Pd, Ps, Pe, Pi, Pf, Po,
1162 Sm, Sc, Sk, So, Zs, Zl, Zp, Cc, Cf, Cs, Co, Cn
1163 See The Unicode Standard for the meaning of those values. */);
1164 /* The correct char-table is setup in characters.el. */
1165 Vunicode_category_table
= Qnil
;
1170 /* arch-tag: b6665960-3c3d-4184-85cd-af4318197999
1171 (do not change this comment) */