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>
38 #include "character.h"
41 #include "composite.h"
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. Mainly used by the macro MAYBE_UNIFY_CHAR. */
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
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 Lisp_Object Vunicode_category_table
;
90 /* Mapping table from unibyte chars to multibyte chars. */
91 int unibyte_to_multibyte_table
[256];
95 /* If character code C has modifier masks, reflect them to the
96 character code if possible. Return the resulting code. */
99 char_resolve_modifier_mask (c
)
102 /* A non-ASCII character can't reflect modifier bits to the code. */
103 if (! ASCII_CHAR_P ((c
& ~CHAR_MODIFIER_MASK
)))
106 /* For Meta, Shift, and Control modifiers, we need special care. */
109 /* Shift modifier is valid only with [A-Za-z]. */
110 if ((c
& 0377) >= 'A' && (c
& 0377) <= 'Z')
112 else if ((c
& 0377) >= 'a' && (c
& 0377) <= 'z')
113 c
= (c
& ~CHAR_SHIFT
) - ('a' - 'A');
114 /* Shift modifier for control characters and SPC is ignored. */
115 else if ((c
& ~CHAR_MODIFIER_MASK
) <= 0x20)
120 /* Simulate the code in lread.c. */
121 /* Allow `\C- ' and `\C-?'. */
122 if ((c
& 0377) == ' ')
123 c
&= ~0177 & ~ CHAR_CTL
;
124 else if ((c
& 0377) == '?')
125 c
= 0177 | (c
& ~0177 & ~CHAR_CTL
);
126 /* ASCII control chars are made from letters (both cases),
127 as well as the non-letters within 0100...0137. */
128 else if ((c
& 0137) >= 0101 && (c
& 0137) <= 0132)
129 c
&= (037 | (~0177 & ~CHAR_CTL
));
130 else if ((c
& 0177) >= 0100 && (c
& 0177) <= 0137)
131 c
&= (037 | (~0177 & ~CHAR_CTL
));
135 /* Move the meta bit to the right place for a string. */
136 c
= (c
& ~CHAR_META
) | 0x80;
143 /* Store multibyte form of character C at P. If C has modifier bits,
144 handle them appropriately. */
153 if (c
& CHAR_MODIFIER_MASK
)
155 c
= (unsigned) char_resolve_modifier_mask ((int) c
);
156 /* If C still has any modifier bits, just ignore it. */
157 c
&= ~CHAR_MODIFIER_MASK
;
160 MAYBE_UNIFY_CHAR (c
);
162 if (c
<= MAX_3_BYTE_CHAR
)
164 bytes
= CHAR_STRING (c
, p
);
166 else if (c
<= MAX_4_BYTE_CHAR
)
168 p
[0] = (0xF0 | (c
>> 18));
169 p
[1] = (0x80 | ((c
>> 12) & 0x3F));
170 p
[2] = (0x80 | ((c
>> 6) & 0x3F));
171 p
[3] = (0x80 | (c
& 0x3F));
174 else if (c
<= MAX_5_BYTE_CHAR
)
177 p
[1] = (0x80 | ((c
>> 18) & 0x0F));
178 p
[2] = (0x80 | ((c
>> 12) & 0x3F));
179 p
[3] = (0x80 | ((c
>> 6) & 0x3F));
180 p
[4] = (0x80 | (c
& 0x3F));
183 else if (c
<= MAX_CHAR
)
185 c
= CHAR_TO_BYTE8 (c
);
186 bytes
= BYTE8_STRING (c
, p
);
189 error ("Invalid character: %d", c
);
195 /* Return a character whose multibyte form is at P. Set LEN is not
196 NULL, it must be a pointer to integer. In that case, set *LEN to
197 the byte length of the multibyte form. If ADVANCED is not NULL, is
198 must be a pointer to unsigned char. In that case, set *ADVANCED to
199 the ending address (i.e. the starting address of the next
200 character) of the multibyte form. */
203 string_char (p
, advanced
, len
)
204 const unsigned char *p
;
205 const unsigned char **advanced
;
209 const unsigned char *saved_p
= p
;
211 if (*p
< 0x80 || ! (*p
& 0x20) || ! (*p
& 0x10))
213 c
= STRING_CHAR_ADVANCE (p
);
215 else if (! (*p
& 0x08))
217 c
= ((((p
)[0] & 0xF) << 18)
218 | (((p
)[1] & 0x3F) << 12)
219 | (((p
)[2] & 0x3F) << 6)
225 c
= ((((p
)[1] & 0x3F) << 18)
226 | (((p
)[2] & 0x3F) << 12)
227 | (((p
)[3] & 0x3F) << 6)
232 MAYBE_UNIFY_CHAR (c
);
242 /* Translate character C by translation table TABLE. If C is
243 negative, translate a character specified by CHARSET and CODE. If
244 no translation is found in TABLE, return the untranslated
245 character. If TABLE is a list, elements are char tables. In this
246 case, translace C by all tables. */
249 translate_char (table
, c
)
253 if (CHAR_TABLE_P (table
))
257 ch
= CHAR_TABLE_REF (table
, c
);
263 for (; CONSP (table
); table
= XCDR (table
))
264 c
= translate_char (XCAR (table
), c
);
269 /* Convert ASCII or 8-bit character C to unibyte. If C is none of
270 them, return (C & 0xFF).
272 The argument REV_TBL is now ignored. It will be removed in the
276 multibyte_char_to_unibyte (c
, rev_tbl
)
282 if (CHAR_BYTE8_P (c
))
283 return CHAR_TO_BYTE8 (c
);
287 /* Like multibyte_char_to_unibyte, but return -1 if C is not supported
288 by charset_unibyte. */
291 multibyte_char_to_unibyte_safe (c
)
296 if (CHAR_BYTE8_P (c
))
297 return CHAR_TO_BYTE8 (c
);
301 DEFUN ("characterp", Fcharacterp
, Scharacterp
, 1, 2, 0,
302 doc
: /* Return non-nil if OBJECT is a character. */)
304 Lisp_Object object
, ignore
;
306 return (CHARACTERP (object
) ? Qt
: Qnil
);
309 DEFUN ("max-char", Fmax_char
, Smax_char
, 0, 0, 0,
310 doc
: /* Return the character of the maximum code. */)
313 return make_number (MAX_CHAR
);
316 DEFUN ("unibyte-char-to-multibyte", Funibyte_char_to_multibyte
,
317 Sunibyte_char_to_multibyte
, 1, 1, 0,
318 doc
: /* Convert the byte CH to multibyte character. */)
324 CHECK_CHARACTER (ch
);
327 error ("Not a unibyte character: %d", c
);
329 c
= BYTE8_TO_CHAR (c
);
330 return make_number (c
);
333 DEFUN ("multibyte-char-to-unibyte", Fmultibyte_char_to_unibyte
,
334 Smultibyte_char_to_unibyte
, 1, 1, 0,
335 doc
: /* Convert the multibyte character CH to a byte.
336 If the multibyte character does not represent a byte, return -1. */)
342 CHECK_CHARACTER (ch
);
345 /* Can't distinguish a byte read from a unibyte buffer from
346 a latin1 char, so let's let it slide. */
350 int cu
= CHAR_TO_BYTE_SAFE (cm
);
351 return make_number (cu
);
355 DEFUN ("char-bytes", Fchar_bytes
, Schar_bytes
, 1, 1, 0,
356 doc
: /* Return 1 regardless of the argument CHAR.
357 This is now an obsolete function. We keep it just for backward compatibility.
358 usage: (char-bytes CHAR) */)
362 CHECK_CHARACTER (ch
);
363 return make_number (1);
366 DEFUN ("char-width", Fchar_width
, Schar_width
, 1, 1, 0,
367 doc
: /* Return width of CHAR when displayed in the current buffer.
368 The width is measured by how many columns it occupies on the screen.
369 Tab is taken to occupy `tab-width' columns.
370 usage: (char-width CHAR) */)
376 struct Lisp_Char_Table
*dp
= buffer_display_table ();
378 CHECK_CHARACTER (ch
);
381 /* Get the way the display table would display it. */
382 disp
= dp
? DISP_CHAR_VECTOR (dp
, c
) : Qnil
;
385 width
= ASIZE (disp
);
387 width
= CHAR_WIDTH (c
);
389 return make_number (width
);
392 /* Return width of string STR of length LEN when displayed in the
393 current buffer. The width is measured by how many columns it
394 occupies on the screen. If PRECISION > 0, return the width of
395 longest substring that doesn't exceed PRECISION, and set number of
396 characters and bytes of the substring in *NCHARS and *NBYTES
400 c_string_width (const unsigned char *str
, int len
, int precision
, int *nchars
, int *nbytes
)
402 int i
= 0, i_byte
= 0;
404 struct Lisp_Char_Table
*dp
= buffer_display_table ();
408 int bytes
, thiswidth
;
410 int c
= STRING_CHAR_AND_LENGTH (str
+ i_byte
, len
- i_byte
, bytes
);
414 val
= DISP_CHAR_VECTOR (dp
, c
);
416 thiswidth
= XVECTOR (val
)->size
;
418 thiswidth
= CHAR_WIDTH (c
);
422 thiswidth
= CHAR_WIDTH (c
);
426 && (width
+ thiswidth
> precision
))
446 /* Return width of string STR of length LEN when displayed in the
447 current buffer. The width is measured by how many columns it
448 occupies on the screen. */
455 return c_string_width (str
, len
, -1, NULL
, NULL
);
458 /* Return width of Lisp string STRING when displayed in the current
459 buffer. The width is measured by how many columns it occupies on
460 the screen while paying attention to compositions. If PRECISION >
461 0, return the width of longest substring that doesn't exceed
462 PRECISION, and set number of characters and bytes of the substring
463 in *NCHARS and *NBYTES respectively. */
466 lisp_string_width (string
, precision
, nchars
, nbytes
)
468 int precision
, *nchars
, *nbytes
;
470 int len
= SCHARS (string
);
471 /* This set multibyte to 0 even if STRING is multibyte when it
472 contains only ascii and eight-bit-graphic, but that's
474 int multibyte
= len
< SBYTES (string
);
475 unsigned char *str
= SDATA (string
);
476 int i
= 0, i_byte
= 0;
478 struct Lisp_Char_Table
*dp
= buffer_display_table ();
482 int chars
, bytes
, thiswidth
;
485 EMACS_INT ignore
, end
;
487 if (find_composition (i
, -1, &ignore
, &end
, &val
, string
)
488 && ((cmp_id
= get_composition_id (i
, i_byte
, end
- i
, val
, string
))
491 thiswidth
= composition_table
[cmp_id
]->width
;
493 bytes
= string_char_to_byte (string
, end
) - i_byte
;
500 c
= STRING_CHAR_AND_LENGTH (str
+ i_byte
, len
- i_byte
, bytes
);
502 c
= str
[i_byte
], bytes
= 1;
506 val
= DISP_CHAR_VECTOR (dp
, c
);
508 thiswidth
= XVECTOR (val
)->size
;
510 thiswidth
= CHAR_WIDTH (c
);
514 thiswidth
= CHAR_WIDTH (c
);
519 && (width
+ thiswidth
> precision
))
539 DEFUN ("string-width", Fstring_width
, Sstring_width
, 1, 1, 0,
540 doc
: /* Return width of STRING when displayed in the current buffer.
541 Width is measured by how many columns it occupies on the screen.
542 When calculating width of a multibyte character in STRING,
543 only the base leading-code is considered; the validity of
544 the following bytes is not checked. Tabs in STRING are always
545 taken to occupy `tab-width' columns.
546 usage: (string-width STRING) */)
553 XSETFASTINT (val
, lisp_string_width (str
, -1, NULL
, NULL
));
557 DEFUN ("char-direction", Fchar_direction
, Schar_direction
, 1, 1, 0,
558 doc
: /* Return the direction of CHAR.
559 The returned value is 0 for left-to-right and 1 for right-to-left.
560 usage: (char-direction CHAR) */)
566 CHECK_CHARACTER (ch
);
568 return CHAR_TABLE_REF (Vchar_direction_table
, c
);
571 /* Return the number of characters in the NBYTES bytes at PTR.
572 This works by looking at the contents and checking for multibyte
573 sequences while assuming that there's no invalid sequence.
574 However, if the current buffer has enable-multibyte-characters =
575 nil, we treat each byte as a character. */
578 chars_in_text (ptr
, nbytes
)
579 const unsigned char *ptr
;
582 /* current_buffer is null at early stages of Emacs initialization. */
583 if (current_buffer
== 0
584 || NILP (current_buffer
->enable_multibyte_characters
))
587 return multibyte_chars_in_text (ptr
, nbytes
);
590 /* Return the number of characters in the NBYTES bytes at PTR.
591 This works by looking at the contents and checking for multibyte
592 sequences while assuming that there's no invalid sequence. It
593 ignores enable-multibyte-characters. */
596 multibyte_chars_in_text (ptr
, nbytes
)
597 const unsigned char *ptr
;
600 const unsigned char *endp
= ptr
+ nbytes
;
605 int len
= MULTIBYTE_LENGTH (ptr
, endp
);
616 /* Parse unibyte text at STR of LEN bytes as a multibyte text, count
617 characters and bytes in it, and store them in *NCHARS and *NBYTES
618 respectively. On counting bytes, pay attention to that 8-bit
619 characters not constructing a valid multibyte sequence are
620 represented by 2-byte in a multibyte text. */
623 parse_str_as_multibyte (str
, len
, nchars
, nbytes
)
624 const unsigned char *str
;
625 int len
, *nchars
, *nbytes
;
627 const unsigned char *endp
= str
+ len
;
628 int n
, chars
= 0, bytes
= 0;
630 if (len
>= MAX_MULTIBYTE_LENGTH
)
632 const unsigned char *adjusted_endp
= endp
- MAX_MULTIBYTE_LENGTH
;
633 while (str
< adjusted_endp
)
635 if ((n
= MULTIBYTE_LENGTH_NO_CHECK (str
)) > 0)
636 str
+= n
, bytes
+= n
;
644 if ((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 && (n
= MULTIBYTE_LENGTH_NO_CHECK (p
)) > 0)
681 while ((n
= MULTIBYTE_LENGTH (p
, endp
)) > 0)
691 safe_bcopy ((char *) p
, (char *) (endp
- nbytes
), nbytes
);
694 if (nbytes
>= MAX_MULTIBYTE_LENGTH
)
696 unsigned char *adjusted_endp
= endp
- MAX_MULTIBYTE_LENGTH
;
697 while (p
< adjusted_endp
)
699 if ((n
= MULTIBYTE_LENGTH_NO_CHECK (p
)) > 0)
707 c
= BYTE8_TO_CHAR (c
);
708 to
+= CHAR_STRING (c
, to
);
715 if ((n
= MULTIBYTE_LENGTH (p
, endp
)) > 0)
723 c
= BYTE8_TO_CHAR (c
);
724 to
+= CHAR_STRING (c
, to
);
733 /* Parse unibyte string at STR of LEN bytes, and return the number of
734 bytes it may ocupy when converted to multibyte string by
735 `str_to_multibyte'. */
738 parse_str_to_multibyte (str
, len
)
742 unsigned char *endp
= str
+ len
;
745 for (bytes
= 0; str
< endp
; str
++)
746 bytes
+= (*str
< 0x80) ? 1 : 2;
751 /* Convert unibyte text at STR of NBYTES bytes to a multibyte text
752 that contains the same single-byte characters. It actually
753 converts all 8-bit characters to multibyte forms. It is assured
754 that we can use LEN bytes at STR as a work area and that is
758 str_to_multibyte (str
, len
, bytes
)
762 unsigned char *p
= str
, *endp
= str
+ bytes
;
765 while (p
< endp
&& *p
< 0x80) p
++;
771 safe_bcopy ((char *) p
, (char *) (endp
- bytes
), bytes
);
778 c
= BYTE8_TO_CHAR (c
);
779 to
+= CHAR_STRING (c
, to
);
784 /* Arrange multibyte text at STR of LEN bytes as a unibyte text. It
785 actually converts characters in the range 0x80..0xFF to
789 str_as_unibyte (str
, bytes
)
793 const unsigned char *p
= str
, *endp
= str
+ bytes
;
800 len
= BYTES_BY_CHAR_HEAD (c
);
801 if (CHAR_BYTE8_HEAD_P (c
))
805 to
= str
+ (p
- str
);
809 len
= BYTES_BY_CHAR_HEAD (c
);
810 if (CHAR_BYTE8_HEAD_P (c
))
812 c
= STRING_CHAR_ADVANCE (p
);
813 *to
++ = CHAR_TO_BYTE8 (c
);
817 while (len
--) *to
++ = *p
++;
823 /* Convert eight-bit chars in SRC (in multibyte form) to the
824 corresponding byte and store in DST. CHARS is the number of
825 characters in SRC. The value is the number of bytes stored in DST.
826 Usually, the value is the same as CHARS, but is less than it if SRC
827 contains a non-ASCII, non-eight-bit characater. If ACCEPT_LATIN_1
828 is nonzero, a Latin-1 character is accepted and converted to a byte
829 of that character code.
830 Note: Currently the arg ACCEPT_LATIN_1 is not used. */
833 str_to_unibyte (src
, dst
, chars
, accept_latin_1
)
834 const unsigned char *src
;
841 for (i
= 0; i
< chars
; i
++)
843 int c
= STRING_CHAR_ADVANCE (src
);
845 if (CHAR_BYTE8_P (c
))
846 c
= CHAR_TO_BYTE8 (c
);
847 else if (! ASCII_CHAR_P (c
)
848 && (! accept_latin_1
|| c
>= 0x100))
857 string_count_byte8 (string
)
860 int multibyte
= STRING_MULTIBYTE (string
);
861 int nbytes
= SBYTES (string
);
862 unsigned char *p
= SDATA (string
);
863 unsigned char *pend
= p
+ nbytes
;
871 len
= BYTES_BY_CHAR_HEAD (c
);
873 if (CHAR_BYTE8_HEAD_P (c
))
888 string_escape_byte8 (string
)
891 int nchars
= SCHARS (string
);
892 int nbytes
= SBYTES (string
);
893 int multibyte
= STRING_MULTIBYTE (string
);
895 const unsigned char *src
, *src_end
;
900 if (multibyte
&& nchars
== nbytes
)
903 byte8_count
= string_count_byte8 (string
);
905 if (byte8_count
== 0)
909 /* Convert 2-byte sequence of byte8 chars to 4-byte octal. */
910 val
= make_uninit_multibyte_string (nchars
+ byte8_count
* 3,
911 nbytes
+ byte8_count
* 2);
913 /* Convert 1-byte sequence of byte8 chars to 4-byte octal. */
914 val
= make_uninit_string (nbytes
+ byte8_count
* 3);
916 src
= SDATA (string
);
917 src_end
= src
+ nbytes
;
920 while (src
< src_end
)
923 len
= BYTES_BY_CHAR_HEAD (c
);
925 if (CHAR_BYTE8_HEAD_P (c
))
927 c
= STRING_CHAR_ADVANCE (src
);
928 c
= CHAR_TO_BYTE8 (c
);
929 sprintf ((char *) dst
, "\\%03o", c
);
933 while (len
--) *dst
++ = *src
++;
936 while (src
< src_end
)
941 sprintf ((char *) dst
, "\\%03o", c
);
951 DEFUN ("string", Fstring
, Sstring
, 0, MANY
, 0,
953 Concatenate all the argument characters and make the result a string.
954 usage: (string &rest CHARACTERS) */)
960 unsigned char *buf
= (unsigned char *) alloca (MAX_MULTIBYTE_LENGTH
* n
);
961 unsigned char *p
= buf
;
964 for (i
= 0; i
< n
; i
++)
966 CHECK_CHARACTER (args
[i
]);
968 p
+= CHAR_STRING (c
, p
);
971 return make_string_from_bytes ((char *) buf
, n
, p
- buf
);
974 DEFUN ("unibyte-string", Funibyte_string
, Sunibyte_string
, 0, MANY
, 0,
975 doc
: /* Concatenate all the argument bytes and make the result a unibyte string.
976 usage: (unibyte-string &rest BYTES) */)
982 unsigned char *buf
= (unsigned char *) alloca (n
);
983 unsigned char *p
= buf
;
986 for (i
= 0; i
< n
; i
++)
988 CHECK_NATNUM (args
[i
]);
989 c
= XFASTINT (args
[i
]);
991 args_out_of_range_3 (args
[i
], make_number (0), make_number (255));
995 return make_string_from_bytes ((char *) buf
, n
, p
- buf
);
998 DEFUN ("char-resolve-modifiers", Fchar_resolve_modifiers
,
999 Schar_resolve_modifiers
, 1, 1, 0,
1000 doc
: /* Resolve modifiers in the character CHAR.
1001 The value is a character with modifiers resolved into the character
1002 code. Unresolved modifiers are kept in the value.
1003 usage: (char-resolve-modifiers CHAR) */)
1005 Lisp_Object character
;
1009 CHECK_NUMBER (character
);
1010 c
= XINT (character
);
1011 return make_number (char_resolve_modifier_mask (c
));
1014 DEFUN ("get-byte", Fget_byte
, Sget_byte
, 0, 2, 0,
1015 doc
: /* Return a byte value of a character at point.
1016 Optional 1st arg POSITION, if non-nil, is a position of a character to get
1018 Optional 2nd arg STRING, if non-nil, is a string of which first
1019 character is a target to get a byte value. In this case, POSITION, if
1020 non-nil, is an index of a target character in the string.
1022 If the current buffer (or STRING) is multibyte, and the target
1023 character is not ASCII nor 8-bit character, an error is signalled. */)
1025 Lisp_Object position
, string
;
1033 if (NILP (position
))
1039 CHECK_NUMBER_COERCE_MARKER (position
);
1040 if (XINT (position
) < BEGV
|| XINT (position
) >= ZV
)
1041 args_out_of_range_3 (position
, make_number (BEGV
), make_number (ZV
));
1042 pos
= XFASTINT (position
);
1043 p
= CHAR_POS_ADDR (pos
);
1045 if (NILP (current_buffer
->enable_multibyte_characters
))
1046 return make_number (*p
);
1050 CHECK_STRING (string
);
1051 if (NILP (position
))
1057 CHECK_NATNUM (position
);
1058 if (XINT (position
) >= SCHARS (string
))
1059 args_out_of_range (string
, position
);
1060 pos
= XFASTINT (position
);
1061 p
= SDATA (string
) + string_char_to_byte (string
, pos
);
1063 if (! STRING_MULTIBYTE (string
))
1064 return make_number (*p
);
1066 c
= STRING_CHAR (p
, 0);
1067 if (CHAR_BYTE8_P (c
))
1068 c
= CHAR_TO_BYTE8 (c
);
1069 else if (! ASCII_CHAR_P (c
))
1070 error ("Not an ASCII nor an 8-bit character: %d", c
);
1071 return make_number (c
);
1076 init_character_once ()
1083 syms_of_character ()
1085 DEFSYM (Qcharacterp
, "characterp");
1086 DEFSYM (Qauto_fill_chars
, "auto-fill-chars");
1088 staticpro (&Vchar_unify_table
);
1089 Vchar_unify_table
= Qnil
;
1091 defsubr (&Smax_char
);
1092 defsubr (&Scharacterp
);
1093 defsubr (&Sunibyte_char_to_multibyte
);
1094 defsubr (&Smultibyte_char_to_unibyte
);
1095 defsubr (&Schar_bytes
);
1096 defsubr (&Schar_width
);
1097 defsubr (&Sstring_width
);
1098 defsubr (&Schar_direction
);
1100 defsubr (&Sunibyte_string
);
1101 defsubr (&Schar_resolve_modifiers
);
1102 defsubr (&Sget_byte
);
1104 DEFVAR_LISP ("translation-table-vector", &Vtranslation_table_vector
,
1106 Vector recording all translation tables ever defined.
1107 Each element is a pair (SYMBOL . TABLE) relating the table to the
1108 symbol naming it. The ID of a translation table is an index into this vector. */);
1109 Vtranslation_table_vector
= Fmake_vector (make_number (16), Qnil
);
1111 DEFVAR_LISP ("auto-fill-chars", &Vauto_fill_chars
,
1113 A char-table for characters which invoke auto-filling.
1114 Such characters have value t in this table. */);
1115 Vauto_fill_chars
= Fmake_char_table (Qauto_fill_chars
, Qnil
);
1116 CHAR_TABLE_SET (Vauto_fill_chars
, ' ', Qt
);
1117 CHAR_TABLE_SET (Vauto_fill_chars
, '\n', Qt
);
1119 DEFVAR_LISP ("char-width-table", &Vchar_width_table
,
1121 A char-table for width (columns) of each character. */);
1122 Vchar_width_table
= Fmake_char_table (Qnil
, make_number (1));
1123 char_table_set_range (Vchar_width_table
, 0x80, 0x9F, make_number (4));
1124 char_table_set_range (Vchar_width_table
, MAX_5_BYTE_CHAR
+ 1, MAX_CHAR
,
1127 DEFVAR_LISP ("char-direction-table", &Vchar_direction_table
,
1128 doc
: /* A char-table for direction of each character. */);
1129 Vchar_direction_table
= Fmake_char_table (Qnil
, make_number (1));
1131 DEFVAR_LISP ("printable-chars", &Vprintable_chars
,
1132 doc
: /* A char-table for each printable character. */);
1133 Vprintable_chars
= Fmake_char_table (Qnil
, Qnil
);
1134 Fset_char_table_range (Vprintable_chars
,
1135 Fcons (make_number (32), make_number (126)), Qt
);
1136 Fset_char_table_range (Vprintable_chars
,
1137 Fcons (make_number (160),
1138 make_number (MAX_5_BYTE_CHAR
)), Qt
);
1140 DEFVAR_LISP ("char-script-table", &Vchar_script_table
,
1141 doc
: /* Char table of script symbols.
1142 It has one extra slot whose value is a list of script symbols. */);
1144 /* Intern this now in case it isn't already done.
1145 Setting this variable twice is harmless.
1146 But don't staticpro it here--that is done in alloc.c. */
1147 Qchar_table_extra_slots
= intern ("char-table-extra-slots");
1148 DEFSYM (Qchar_script_table
, "char-script-table");
1149 Fput (Qchar_script_table
, Qchar_table_extra_slots
, make_number (1));
1150 Vchar_script_table
= Fmake_char_table (Qchar_script_table
, Qnil
);
1152 DEFVAR_LISP ("script-representative-chars", &Vscript_representative_chars
,
1153 doc
: /* Alist of scripts vs the representative characters.
1154 Each element is a cons (SCRIPT . CHARS).
1155 SCRIPT is a symbol representing a script or a subgroup of a script.
1156 CHARS is a list or a vector of characters.
1157 If it is a list, all characters in the list are necessary for supporting SCRIPT.
1158 If it is a vector, one of the characters in the vector is necessary.
1159 This variable is used to find a font for a specific script. */);
1160 Vscript_representative_chars
= Qnil
;
1162 DEFVAR_LISP ("unicode-category-table", &Vunicode_category_table
,
1163 doc
: /* Char table of Unicode's "General Category".
1164 All Unicode characters have one of the following values (symbol):
1165 Lu, Ll, Lt, Lm, Lo, Mn, Mc, Me, Nd, Nl, No, Pc, Pd, Ps, Pe, Pi, Pf, Po,
1166 Sm, Sc, Sk, So, Zs, Zl, Zp, Cc, Cf, Cs, Co, Cn
1167 See The Unicode Standard for the meaning of those values. */);
1168 /* The correct char-table is setup in characters.el. */
1169 Vunicode_category_table
= Qnil
;
1174 /* arch-tag: b6665960-3c3d-4184-85cd-af4318197999
1175 (do not change this comment) */