1 ;;;; character functions
3 ;;;; This software is part of the SBCL system. See the README file for
6 ;;;; This software is derived from the CMU CL system, which was
7 ;;;; written at Carnegie Mellon University and released into the
8 ;;;; public domain. The software is in the public domain and is
9 ;;;; provided with absolutely no warranty. See the COPYING and CREDITS
10 ;;;; files for more information.
12 (in-package "SB!IMPL")
14 ;;; We compile some trivial character operations via inline expansion.
16 (declaim (inline standard-char-p graphic-char-p alpha-char-p
17 upper-case-p lower-case-p both-case-p alphanumericp
19 (declaim (maybe-inline digit-char-p digit-weight))
22 `(integer 0 (,char-code-limit)))
26 (defvar *unicode-character-name-database*)
27 (defvar *unicode-character-name-huffman-tree*))
31 (flet ((file (name type)
32 (merge-pathnames (make-pathname
34 '(:relative :up :up "output")
35 :name name :type type)
36 sb!xc:*compile-file-truename*)))
37 (let ((character-database
38 (with-open-file (stream (file "ucd" "dat")
40 :element-type '(unsigned-byte 8))
41 (let* ((length (file-length stream))
43 length :element-type '(unsigned-byte 8))))
44 (read-sequence array stream)
47 (declaim (type (simple-array (unsigned-byte 8) (*)) **character-database**))
48 (defglobal **character-database** ,character-database)
49 (defun !character-database-cold-init ()
50 (setf **character-database** ,character-database))
51 ,(with-open-file (stream (file "ucd-names" "lisp-expr")
53 :element-type 'character)
54 (let ((names (make-hash-table)))
57 for code-point = (read stream nil nil)
58 for char-name = (string-upcase (read stream nil nil))
60 do (setf (gethash code-point names) char-name))
65 (maphash (lambda (code name)
66 (declare (ignore code))
71 (make-array (hash-table-count names)
74 (maphash (lambda (code name)
76 (cons code (huffman-encode name tree))
80 (sort (copy-seq code->name) #'< :key #'cdr))
82 (sort (copy-seq name->code) #'< :key #'car))
84 `(defun !character-name-database-cold-init ()
86 (setq *unicode-character-name-database*
87 (cons ',code->name ',name->code)
88 *unicode-character-name-huffman-tree* ',tree))))))))))
90 #+sb-xc-host (!character-name-database-cold-init)
92 (defparameter *base-char-name-alist*
93 ;; Note: The *** markers here indicate character names which are
94 ;; required by the ANSI specification of #'CHAR-NAME. For the others,
95 ;; we prefer the ASCII standard name.
96 '((#x00 "Nul" "Null" "^@")
103 (#x07 "Bel" "Bell" "^g")
104 (#x08 "Backspace" "^h" "Bs") ; *** See Note above
105 (#x09 "Tab" "^i" "Ht") ; *** See Note above
106 (#x0A "Newline" "Linefeed" "^j" "Lf" "Nl") ; *** See Note above
108 (#x0C "Page" "^l" "Form" "Formfeed" "Ff" "Np") ; *** See Note above
109 (#x0D "Return" "^m" "Cr") ; *** See Note above
123 (#x1B "Esc" "Escape" "^[" "Altmode" "Alt")
128 (#x20 "Space" "Sp") ; *** See Note above
129 (#x7f "Rubout" "Delete" "Del")
132 (#x82 "Break-Permitted")
133 (#x83 "No-Break-Permitted")
136 (#x86 "Start-Selected-Area")
137 (#x87 "End-Selected-Area")
138 (#x88 "Character-Tabulation-Set")
139 (#x89 "Character-Tabulation-With-Justification")
140 (#x8A "Line-Tabulation-Set")
141 (#x8B "Partial-Line-Forward")
142 (#x8C "Partial-Line-Backward")
143 (#x8D "Reverse-Linefeed")
144 (#x8E "Single-Shift-Two")
145 (#x8F "Single-Shift-Three")
146 (#x90 "Device-Control-String")
147 (#x91 "Private-Use-One")
148 (#x92 "Private-Use-Two")
149 (#x93 "Set-Transmit-State")
150 (#x94 "Cancel-Character")
151 (#x95 "Message-Waiting")
152 (#x96 "Start-Guarded-Area")
153 (#x97 "End-Guarded-Area")
154 (#x98 "Start-String")
156 (#x9A "Single-Character-Introducer")
157 (#x9B "Control-Sequence-Introducer")
158 (#x9C "String-Terminator")
159 (#x9D "Operating-System-Command")
160 (#x9E "Privacy-Message")
161 (#x9F "Application-Program-Command"))) ; *** See Note above
163 ;;;; UCD accessor functions
165 ;;; The first (* 8 215) => 1720 entries in **CHARACTER-DATABASE**
166 ;;; contain entries for the distinct character attributes:
167 ;;; specifically, indexes into the GC kinds, Bidi kinds, CCC kinds,
168 ;;; the decimal digit property, the digit property and the
169 ;;; bidi-mirrored boolean property. (There are two spare bytes for
170 ;;; other information, should that become necessary)
172 ;;; the next (ash #x110000 -8) entries contain single-byte indexes
173 ;;; into a table of 256-element 4-byte-sized entries. These entries
174 ;;; follow directly on, and are of the form
175 ;;; {attribute-index[1B],transformed-code-point[3B]}x256, where the
176 ;;; attribute index is an index into the miscellaneous information
177 ;;; table, and the transformed code point is the code point of the
178 ;;; simple mapping of the character to its lowercase or uppercase
179 ;;; equivalent, as appropriate and if any.
181 ;;; I feel the opacity of the above suggests the need for a diagram:
183 ;;; C _______________________________________
186 ;;; [***************|=============================|--------...]
188 ;;; A \______________________/| B
190 ;;; To look up information about a character, take the high 13 bits of
191 ;;; its code point, and index the character database with that and a
192 ;;; base of 1720 (going past the miscellaneous information[*], so
193 ;;; treating (a) as the start of the array). This, labelled A, gives
194 ;;; us another index into the detailed pages[-], which we can use to
195 ;;; look up the details for the character in question: we add the low
196 ;;; 8 bits of the character, shifted twice (because we have four-byte
197 ;;; table entries) to 1024 times the `page' index, with a base of 6072
198 ;;; to skip over everything else. This gets us to point B. If we're
199 ;;; after a transformed code point (i.e. an upcase or downcase
200 ;;; operation), we can simply read it off now, beginning with an
201 ;;; offset of 1 byte from point B in some endianness; if we're looking
202 ;;; for miscellaneous information, we take the value at B, and index
203 ;;; the character database once more to get to the relevant
204 ;;; miscellaneous information.
206 ;;; The moral of all this? Next time, don't just say "FIXME: document
208 (defun ucd-index (char)
209 (let* ((cp (char-code char))
210 (cp-high (ash cp -8))
211 (page (aref **character-database** (+ 1720 cp-high))))
212 (+ 6072 (ash page 10) (ash (ldb (byte 8 0) cp) 2))))
214 (declaim (ftype (sfunction (t) (unsigned-byte 8)) ucd-value-0))
215 (defun ucd-value-0 (char)
216 (aref **character-database** (ucd-index char)))
218 (declaim (ftype (sfunction (t) (unsigned-byte 24)) ucd-value-1))
219 (defun ucd-value-1 (char)
220 (let ((index (ucd-index char))
221 (character-database **character-database**))
222 (dpb (aref character-database (+ index 3))
224 (dpb (aref character-database (+ index 2))
226 (aref character-database (1+ index))))))
228 (declaim (ftype (sfunction (t) (unsigned-byte 8)) ucd-general-category))
229 (defun ucd-general-category (char)
230 (aref **character-database** (* 8 (ucd-value-0 char))))
232 (defun ucd-decimal-digit (char)
233 (let ((decimal-digit (aref **character-database**
234 (+ 3 (* 8 (ucd-value-0 char))))))
235 (when (< decimal-digit 10)
238 (defun char-code (char)
240 "Return the integer code of CHAR."
243 (defun char-int (char)
245 "Return the integer code of CHAR. (In SBCL this is the same as CHAR-CODE, as
246 there are no character bits or fonts.)"
249 (defun code-char (code)
251 "Return the character with the code CODE."
254 (defun character (object)
256 "Coerce OBJECT into a CHARACTER if possible. Legal inputs are characters,
257 strings and symbols of length 1."
258 (flet ((do-error (control args)
259 (error 'simple-type-error
261 ;;?? how to express "symbol with name of length 1"?
262 :expected-type '(or character (string 1))
263 :format-control control
264 :format-arguments args)))
267 (string (if (= 1 (length (the string object)))
270 "String is not of length one: ~S" (list object))))
271 (symbol (if (= 1 (length (symbol-name object)))
272 (schar (symbol-name object) 0)
274 "Symbol name is not of length one: ~S" (list object))))
275 (t (do-error "~S cannot be coerced to a character." (list object))))))
277 (defun char-name (char)
279 "Return the name (a STRING) for a CHARACTER object."
280 (let ((char-code (char-code char)))
281 (or (second (assoc char-code *base-char-name-alist*))
283 (let ((h-code (cdr (binary-search char-code
284 (car *unicode-character-name-database*)
288 (huffman-decode h-code *unicode-character-name-huffman-tree*))
289 ((< char-code #x10000)
290 (format nil "U~4,'0X" char-code))
292 (format nil "U~8,'0X" char-code)))))))
294 (defun name-char (name)
296 "Given an argument acceptable to STRING, NAME-CHAR returns a character whose
297 name is that string, if one exists. Otherwise, NIL is returned."
298 (or (let ((char-code (car (rassoc-if (lambda (names)
299 (member name names :test #'string-equal))
300 *base-char-name-alist*))))
302 (code-char char-code)))
304 (let ((encoding (huffman-encode (string-upcase name)
305 *unicode-character-name-huffman-tree*)))
308 (car (binary-search encoding
309 (cdr *unicode-character-name-database*)
311 (name-string (string name))
312 (name-length (length name-string)))
315 (code-char char-code))
316 ((and (or (= name-length 9)
318 (char-equal (char name-string 0) #\U)
319 (loop for i from 1 below name-length
320 always (digit-char-p (char name-string i) 16)))
321 (code-char (parse-integer name-string :start 1 :radix 16)))
327 (defun standard-char-p (char)
329 "The argument must be a character object. STANDARD-CHAR-P returns T if the
330 argument is a standard character -- one of the 95 ASCII printing characters or
332 (and (typep char 'base-char)
333 (let ((n (char-code (the base-char char))))
337 (defun %standard-char-p (thing)
339 "Return T if and only if THING is a standard-char. Differs from
340 STANDARD-CHAR-P in that THING doesn't have to be a character."
341 (and (characterp thing) (standard-char-p thing)))
343 (defun graphic-char-p (char)
345 "The argument must be a character object. GRAPHIC-CHAR-P returns T if the
346 argument is a printing character (space through ~ in ASCII), otherwise returns
348 (let ((n (char-code char)))
352 (defun alpha-char-p (char)
354 "The argument must be a character object. ALPHA-CHAR-P returns T if the
355 argument is an alphabetic character, A-Z or a-z; otherwise NIL."
356 (< (ucd-general-category char) 5))
358 (defun upper-case-p (char)
360 "The argument must be a character object; UPPER-CASE-P returns T if the
361 argument is an upper-case character, NIL otherwise."
362 (= (ucd-value-0 char) 0))
364 (defun lower-case-p (char)
366 "The argument must be a character object; LOWER-CASE-P returns T if the
367 argument is a lower-case character, NIL otherwise."
368 (= (ucd-value-0 char) 1))
370 (defun both-case-p (char)
372 "The argument must be a character object. BOTH-CASE-P returns T if the
373 argument is an alphabetic character and if the character exists in both upper
374 and lower case. For ASCII, this is the same as ALPHA-CHAR-P."
375 (< (ucd-value-0 char) 2))
377 (defun digit-char-p (char &optional (radix 10.))
379 "If char is a digit in the specified radix, returns the fixnum for which
380 that digit stands, else returns NIL."
381 (let ((m (- (char-code char) 48)))
383 (cond ((<= radix 10.)
384 ;; Special-case decimal and smaller radices.
385 (if (and (>= m 0) (< m radix)) m nil))
386 ;; Digits 0 - 9 are used as is, since radix is larger.
387 ((and (>= m 0) (< m 10)) m)
388 ;; Check for upper case A - Z.
389 ((and (>= (setq m (- m 7)) 10) (< m radix)) m)
390 ;; Also check lower case a - z.
391 ((and (>= (setq m (- m 32)) 10) (< m radix)) m)
393 (t (let ((number (ucd-decimal-digit char)))
394 (when (and number (< number radix))
397 (defun alphanumericp (char)
399 "Given a character-object argument, ALPHANUMERICP returns T if the argument
400 is either numeric or alphabetic."
401 (let ((gc (ucd-general-category char)))
405 (defun char= (character &rest more-characters)
407 "Return T if all of the arguments are the same character."
408 (declare (truly-dynamic-extent more-characters))
409 (dolist (c more-characters t)
410 (declare (type character c))
411 (unless (eq c character) (return nil))))
413 (defun char/= (character &rest more-characters)
415 "Return T if no two of the arguments are the same character."
416 (declare (truly-dynamic-extent more-characters))
417 (do* ((head character (car list))
418 (list more-characters (cdr list)))
420 (declare (type character head))
422 (declare (type character c))
423 (when (eq head c) (return-from char/= nil)))))
425 (defun char< (character &rest more-characters)
427 "Return T if the arguments are in strictly increasing alphabetic order."
428 (declare (truly-dynamic-extent more-characters))
429 (do* ((c character (car list))
430 (list more-characters (cdr list)))
432 (unless (< (char-int c)
433 (char-int (car list)))
436 (defun char> (character &rest more-characters)
438 "Return T if the arguments are in strictly decreasing alphabetic order."
439 (declare (truly-dynamic-extent more-characters))
440 (do* ((c character (car list))
441 (list more-characters (cdr list)))
443 (unless (> (char-int c)
444 (char-int (car list)))
447 (defun char<= (character &rest more-characters)
449 "Return T if the arguments are in strictly non-decreasing alphabetic order."
450 (declare (truly-dynamic-extent more-characters))
451 (do* ((c character (car list))
452 (list more-characters (cdr list)))
454 (unless (<= (char-int c)
455 (char-int (car list)))
458 (defun char>= (character &rest more-characters)
460 "Return T if the arguments are in strictly non-increasing alphabetic order."
461 (declare (truly-dynamic-extent more-characters))
462 (do* ((c character (car list))
463 (list more-characters (cdr list)))
465 (unless (>= (char-int c)
466 (char-int (car list)))
469 ;;; EQUAL-CHAR-CODE is used by the following functions as a version of CHAR-INT
470 ;;; which loses font, bits, and case info.
472 (defmacro equal-char-code (character)
474 `(let ((,ch ,character))
475 (if (= (ucd-value-0 ,ch) 0)
479 (defun two-arg-char-equal (c1 c2)
480 (= (equal-char-code c1) (equal-char-code c2)))
482 (defun char-equal (character &rest more-characters)
484 "Return T if all of the arguments are the same character.
486 (declare (truly-dynamic-extent more-characters))
487 (do ((clist more-characters (cdr clist)))
489 (unless (two-arg-char-equal (car clist) character)
492 (defun two-arg-char-not-equal (c1 c2)
493 (/= (equal-char-code c1) (equal-char-code c2)))
495 (defun char-not-equal (character &rest more-characters)
497 "Return T if no two of the arguments are the same character.
499 (declare (truly-dynamic-extent more-characters))
500 (do* ((head character (car list))
501 (list more-characters (cdr list)))
503 (unless (do* ((l list (cdr l)))
505 (if (two-arg-char-equal head (car l))
509 (defun two-arg-char-lessp (c1 c2)
510 (< (equal-char-code c1) (equal-char-code c2)))
512 (defun char-lessp (character &rest more-characters)
514 "Return T if the arguments are in strictly increasing alphabetic order.
516 (declare (truly-dynamic-extent more-characters))
517 (do* ((c character (car list))
518 (list more-characters (cdr list)))
520 (unless (two-arg-char-lessp c (car list))
523 (defun two-arg-char-greaterp (c1 c2)
524 (> (equal-char-code c1) (equal-char-code c2)))
526 (defun char-greaterp (character &rest more-characters)
528 "Return T if the arguments are in strictly decreasing alphabetic order.
530 (declare (truly-dynamic-extent more-characters))
531 (do* ((c character (car list))
532 (list more-characters (cdr list)))
534 (unless (two-arg-char-greaterp c (car list))
537 (defun two-arg-char-not-greaterp (c1 c2)
538 (<= (equal-char-code c1) (equal-char-code c2)))
540 (defun char-not-greaterp (character &rest more-characters)
542 "Return T if the arguments are in strictly non-decreasing alphabetic order.
544 (declare (truly-dynamic-extent more-characters))
545 (do* ((c character (car list))
546 (list more-characters (cdr list)))
548 (unless (two-arg-char-not-greaterp c (car list))
551 (defun two-arg-char-not-lessp (c1 c2)
552 (>= (equal-char-code c1) (equal-char-code c2)))
554 (defun char-not-lessp (character &rest more-characters)
556 "Return T if the arguments are in strictly non-increasing alphabetic order.
558 (declare (truly-dynamic-extent more-characters))
559 (do* ((c character (car list))
560 (list more-characters (cdr list)))
562 (unless (two-arg-char-not-lessp c (car list))
565 ;;;; miscellaneous functions
567 (defun char-upcase (char)
569 "Return CHAR converted to upper-case if that is possible. Don't convert
570 lowercase eszet (U+DF)."
571 (if (= (ucd-value-0 char) 1)
572 (code-char (ucd-value-1 char))
575 (defun char-downcase (char)
577 "Return CHAR converted to lower-case if that is possible."
578 (if (= (ucd-value-0 char) 0)
579 (code-char (ucd-value-1 char))
582 (defun digit-char (weight &optional (radix 10))
584 "All arguments must be integers. Returns a character object that represents
585 a digit of the given weight in the specified radix. Returns NIL if no such
587 (and (typep weight 'fixnum)
588 (>= weight 0) (< weight radix) (< weight 36)
589 (code-char (if (< weight 10) (+ 48 weight) (+ 55 weight)))))