src/code/late-type.lisp

   1 ;;;; This file contains the definition of non-CLASS types (e.g.
   2 ;;;; subtypes of interesting BUILT-IN-CLASSes) and the interfaces to
   3 ;;;; the type system. Common Lisp type specifiers are parsed into a
   4 ;;;; somewhat canonical internal type representation that supports
   5 ;;;; type union, intersection, etc. (Except that ALIEN types have
   6 ;;;; moved out..)
   7
   8 ;;;; This software is part of the SBCL system. See the README file for
   9 ;;;; more information.
  10 ;;;;
  11 ;;;; This software is derived from the CMU CL system, which was
  12 ;;;; written at Carnegie Mellon University and released into the
  13 ;;;; public domain. The software is in the public domain and is
  14 ;;;; provided with absolutely no warranty. See the COPYING and CREDITS
  15 ;;;; files for more information.
  16
  17 (in-package "SB!KERNEL")
  18
  19 (/show0 "late-type.lisp 19")
  20
  21 (!begin-collecting-cold-init-forms)
  22
  23 ;;; ### Remaining incorrectnesses:
  24 ;;;
  25 ;;; There are all sorts of nasty problems with open bounds on FLOAT
  26 ;;; types (and probably FLOAT types in general.)
  27
  28 ;;; This condition is signalled whenever we make a UNKNOWN-TYPE so that
  29 ;;; compiler warnings can be emitted as appropriate.
  30 (define-condition parse-unknown-type (condition)
  31   ((specifier :reader parse-unknown-type-specifier :initarg :specifier)))
  32
  33 ;;; FIXME: This really should go away. Alas, it doesn't seem to be so
  34 ;;; simple to make it go away.. (See bug 123 in BUGS file.)
  35 (defvar *use-implementation-types* t ; actually initialized in cold init
  36   #!+sb-doc
  37   "*USE-IMPLEMENTATION-TYPES* is a semi-public flag which determines how
  38    restrictive we are in determining type membership. If two types are the
  39    same in the implementation, then we will consider them them the same when
  40    this switch is on. When it is off, we try to be as restrictive as the
  41    language allows, allowing us to detect more errors. Currently, this only
  42    affects array types.")
  43 (!cold-init-forms (setq *use-implementation-types* t))
  44
  45 ;;; These functions are used as method for types which need a complex
  46 ;;; subtypep method to handle some superclasses, but cover a subtree
  47 ;;; of the type graph (i.e. there is no simple way for any other type
  48 ;;; class to be a subtype.) There are always still complex ways,
  49 ;;; namely UNION and MEMBER types, so we must give TYPE1's method a
  50 ;;; chance to run, instead of immediately returning NIL, T.
  51 (defun delegate-complex-subtypep-arg2 (type1 type2)
  52   (let ((subtypep-arg1
  53          (type-class-complex-subtypep-arg1
  54           (type-class-info type1))))
  55     (if subtypep-arg1
  56         (funcall subtypep-arg1 type1 type2)
  57         (values nil t))))
  58 (defun delegate-complex-intersection2 (type1 type2)
  59   (let ((method (type-class-complex-intersection2 (type-class-info type1))))
  60     (if (and method (not (eq method #'delegate-complex-intersection2)))
  61         (funcall method type2 type1)
  62         (hierarchical-intersection2 type1 type2))))
  63
  64 ;;; This is used by !DEFINE-SUPERCLASSES to define the SUBTYPE-ARG1
  65 ;;; method. INFO is a list of conses
  66 ;;;   (SUPERCLASS-CLASS . {GUARD-TYPE-SPECIFIER | NIL}).
  67 (defun !has-superclasses-complex-subtypep-arg1 (type1 type2 info)
  68   ;; If TYPE2 might be concealing something related to our class
  69   ;; hierarchy
  70   (if (type-might-contain-other-types-p type2)
  71       ;; too confusing, gotta punt
  72       (values nil nil)
  73       ;; ordinary case expected by old CMU CL code, where the taxonomy
  74       ;; of TYPE2's representation accurately reflects the taxonomy of
  75       ;; the underlying set
  76       (values
  77        ;; FIXME: This old CMU CL code probably deserves a comment
  78        ;; explaining to us mere mortals how it works...
  79        (and (sb!xc:typep type2 'classoid)
  80             (dolist (x info nil)
  81               (when (or (not (cdr x))
  82                         (csubtypep type1 (specifier-type (cdr x))))
  83                 (return
  84                  (or (eq type2 (car x))
  85                      (let ((inherits (layout-inherits
  86                                       (classoid-layout (car x)))))
  87                        (dotimes (i (length inherits) nil)
  88                          (when (eq type2 (layout-classoid (svref inherits i)))
  89                            (return t)))))))))
  90        t)))
  91
  92 ;;; This function takes a list of specs, each of the form
  93 ;;;    (SUPERCLASS-NAME &OPTIONAL GUARD).
  94 ;;; Consider one spec (with no guard): any instance of the named
  95 ;;; TYPE-CLASS is also a subtype of the named superclass and of any of
  96 ;;; its superclasses. If there are multiple specs, then some will have
  97 ;;; guards. We choose the first spec whose guard is a supertype of
  98 ;;; TYPE1 and use its superclass. In effect, a sequence of guards
  99 ;;;    G0, G1, G2
 100 ;;; is actually
 101 ;;;    G0,(and G1 (not G0)), (and G2 (not (or G0 G1))).
 102 ;;;
 103 ;;; WHEN controls when the forms are executed.
 104 (defmacro !define-superclasses (type-class-name specs when)
 105   (with-unique-names (type-class info)
 106     `(,when
 107        (let ((,type-class (type-class-or-lose ',type-class-name))
 108              (,info (mapcar (lambda (spec)
 109                               (destructuring-bind
 110                                   (super &optional guard)
 111                                   spec
 112                                 (cons (find-classoid super) guard)))
 113                             ',specs)))
 114          (setf (type-class-complex-subtypep-arg1 ,type-class)
 115                (lambda (type1 type2)
 116                  (!has-superclasses-complex-subtypep-arg1 type1 type2 ,info)))
 117          (setf (type-class-complex-subtypep-arg2 ,type-class)
 118                #'delegate-complex-subtypep-arg2)
 119          (setf (type-class-complex-intersection2 ,type-class)
 120                #'delegate-complex-intersection2)))))
 121 \f
 122 ;;;; FUNCTION and VALUES types
 123 ;;;;
 124 ;;;; Pretty much all of the general type operations are illegal on
 125 ;;;; VALUES types, since we can't discriminate using them, do
 126 ;;;; SUBTYPEP, etc. FUNCTION types are acceptable to the normal type
 127 ;;;; operations, but are generally considered to be equivalent to
 128 ;;;; FUNCTION. These really aren't true types in any type theoretic
 129 ;;;; sense, but we still parse them into CTYPE structures for two
 130 ;;;; reasons:
 131
 132 ;;;; -- Parsing and unparsing work the same way, and indeed we can't
 133 ;;;;    tell whether a type is a function or values type without
 134 ;;;;    parsing it.
 135 ;;;; -- Many of the places that can be annotated with real types can
 136 ;;;;    also be annotated with function or values types.
 137
 138 ;;; the description of a &KEY argument
 139 (defstruct (key-info #-sb-xc-host (:pure t)
 140                      (:copier nil))
 141   ;; the key (not necessarily a keyword in ANSI Common Lisp)
 142   (name (missing-arg) :type symbol)
 143   ;; the type of the argument value
 144   (type (missing-arg) :type ctype))
 145
 146 (!define-type-method (values :simple-subtypep :complex-subtypep-arg1)
 147                      (type1 type2)
 148   (declare (ignore type2))
 149   ;; FIXME: should be TYPE-ERROR, here and in next method
 150   (error "SUBTYPEP is illegal on this type:~%  ~S" (type-specifier type1)))
 151
 152 (!define-type-method (values :complex-subtypep-arg2)
 153                      (type1 type2)
 154   (declare (ignore type1))
 155   (error "SUBTYPEP is illegal on this type:~%  ~S" (type-specifier type2)))
 156
 157 (!define-type-method (values :negate) (type)
 158   (error "NOT VALUES too confusing on ~S" (type-specifier type)))
 159
 160 (!define-type-method (values :unparse) (type)
 161   (cons 'values
 162         (let ((unparsed (unparse-args-types type)))
 163           (if (or (values-type-optional type)
 164                   (values-type-rest type)
 165                   (values-type-allowp type))
 166               unparsed
 167               (nconc unparsed '(&optional))))))
 168
 169 ;;; Return true if LIST1 and LIST2 have the same elements in the same
 170 ;;; positions according to TYPE=. We return NIL, NIL if there is an
 171 ;;; uncertain comparison.
 172 (defun type=-list (list1 list2)
 173   (declare (list list1 list2))
 174   (do ((types1 list1 (cdr types1))
 175        (types2 list2 (cdr types2)))
 176       ((or (null types1) (null types2))
 177        (if (or types1 types2)
 178            (values nil t)
 179            (values t t)))
 180     (multiple-value-bind (val win)
 181         (type= (first types1) (first types2))
 182       (unless win
 183         (return (values nil nil)))
 184       (unless val
 185         (return (values nil t))))))
 186
 187 (!define-type-method (values :simple-=) (type1 type2)
 188   (type=-args type1 type2))
 189
 190 (!define-type-class function)
 191
 192 ;;; a flag that we can bind to cause complex function types to be
 193 ;;; unparsed as FUNCTION. This is useful when we want a type that we
 194 ;;; can pass to TYPEP.
 195 (defvar *unparse-fun-type-simplify*)
 196 (!cold-init-forms (setq *unparse-fun-type-simplify* nil))
 197
 198 (!define-type-method (function :negate) (type)
 199   (error "NOT FUNCTION too confusing on ~S" (type-specifier type)))
 200
 201 (!define-type-method (function :unparse) (type)
 202   (if *unparse-fun-type-simplify*
 203       'function
 204       (list 'function
 205             (if (fun-type-wild-args type)
 206                 '*
 207                 (unparse-args-types type))
 208             (type-specifier
 209              (fun-type-returns type)))))
 210
 211 ;;; The meaning of this is a little confused. On the one hand, all
 212 ;;; function objects are represented the same way regardless of the
 213 ;;; arglists and return values, and apps don't get to ask things like
 214 ;;; (TYPEP #'FOO (FUNCTION (FIXNUM) *)) in any meaningful way. On the
 215 ;;; other hand, Python wants to reason about function types. So...
 216 (!define-type-method (function :simple-subtypep) (type1 type2)
 217  (flet ((fun-type-simple-p (type)
 218           (not (or (fun-type-rest type)
 219                    (fun-type-keyp type))))
 220         (every-csubtypep (types1 types2)
 221           (loop
 222              for a1 in types1
 223              for a2 in types2
 224              do (multiple-value-bind (res sure-p)
 225                     (csubtypep a1 a2)
 226                   (unless res (return (values res sure-p))))
 227              finally (return (values t t)))))
 228    (and/type (values-subtypep (fun-type-returns type1)
 229                               (fun-type-returns type2))
 230              (cond ((fun-type-wild-args type2) (values t t))
 231                    ((fun-type-wild-args type1)
 232                     (cond ((fun-type-keyp type2) (values nil nil))
 233                           ((not (fun-type-rest type2)) (values nil t))
 234                           ((not (null (fun-type-required type2)))
 235                            (values nil t))
 236                           (t (and/type (type= *universal-type*
 237                                               (fun-type-rest type2))
 238                                        (every/type #'type=
 239                                                    *universal-type*
 240                                                    (fun-type-optional
 241                                                     type2))))))
 242                    ((not (and (fun-type-simple-p type1)
 243                               (fun-type-simple-p type2)))
 244                     (values nil nil))
 245                    (t (multiple-value-bind (min1 max1) (fun-type-nargs type1)
 246                         (multiple-value-bind (min2 max2) (fun-type-nargs type2)
 247                           (cond ((or (> max1 max2) (< min1 min2))
 248                                  (values nil t))
 249                                 ((and (= min1 min2) (= max1 max2))
 250                                  (and/type (every-csubtypep
 251                                             (fun-type-required type1)
 252                                             (fun-type-required type2))
 253                                            (every-csubtypep
 254                                             (fun-type-optional type1)
 255                                             (fun-type-optional type2))))
 256                                 (t (every-csubtypep
 257                                     (concatenate 'list
 258                                                  (fun-type-required type1)
 259                                                  (fun-type-optional type1))
 260                                     (concatenate 'list
 261                                                  (fun-type-required type2)
 262                                                  (fun-type-optional type2))))))))))))
 263
 264 (!define-superclasses function ((function)) !cold-init-forms)
 265
 266 ;;; The union or intersection of two FUNCTION types is FUNCTION.
 267 (!define-type-method (function :simple-union2) (type1 type2)
 268   (declare (ignore type1 type2))
 269   (specifier-type 'function))
 270 (!define-type-method (function :simple-intersection2) (type1 type2)
 271   (let ((ftype (specifier-type 'function)))
 272     (cond ((eq type1 ftype) type2)
 273           ((eq type2 ftype) type1)
 274           (t (let ((rtype (values-type-intersection (fun-type-returns type1)
 275                                                     (fun-type-returns type2))))
 276                (flet ((change-returns (ftype rtype)
 277                         (declare (type fun-type ftype) (type ctype rtype))
 278                         (make-fun-type :required (fun-type-required ftype)
 279                                        :optional (fun-type-optional ftype)
 280                                        :keyp (fun-type-keyp ftype)
 281                                        :keywords (fun-type-keywords ftype)
 282                                        :allowp (fun-type-allowp ftype)
 283                                        :returns rtype)))
 284                (cond
 285                  ((fun-type-wild-args type1)
 286                   (if (fun-type-wild-args type2)
 287                       (make-fun-type :wild-args t
 288                                      :returns rtype)
 289                       (change-returns type2 rtype)))
 290                  ((fun-type-wild-args type2)
 291                   (change-returns type1 rtype))
 292                  (t (multiple-value-bind (req opt rest)
 293                         (args-type-op type1 type2 #'type-intersection #'max)
 294                       (make-fun-type :required req
 295                                      :optional opt
 296                                      :rest rest
 297                                      ;; FIXME: :keys
 298                                      :allowp (and (fun-type-allowp type1)
 299                                                   (fun-type-allowp type2))
 300                                      :returns rtype))))))))))
 301
 302 ;;; The union or intersection of a subclass of FUNCTION with a
 303 ;;; FUNCTION type is somewhat complicated.
 304 (!define-type-method (function :complex-intersection2) (type1 type2)
 305   (cond
 306     ((type= type1 (specifier-type 'function)) type2)
 307     ((csubtypep type1 (specifier-type 'function)) nil)
 308     (t :call-other-method)))
 309 (!define-type-method (function :complex-union2) (type1 type2)
 310   (declare (ignore type2))
 311   ;; TYPE2 is a FUNCTION type.  If TYPE1 is a classoid type naming
 312   ;; FUNCTION, then it is the union of the two; otherwise, there is no
 313   ;; special union.
 314   (cond
 315     ((type= type1 (specifier-type 'function)) type1)
 316     (t nil)))
 317
 318 (!define-type-method (function :simple-=) (type1 type2)
 319   (macrolet ((compare (comparator field)
 320                (let ((reader (symbolicate '#:fun-type- field)))
 321                  `(,comparator (,reader type1) (,reader type2)))))
 322     (and/type (compare type= returns)
 323               (cond ((neq (fun-type-wild-args type1) (fun-type-wild-args type2))
 324                      (values nil t))
 325                     ((eq (fun-type-wild-args type1) t)
 326                      (values t t))
 327                     (t (type=-args type1 type2))))))
 328
 329 (!define-type-class constant :inherits values)
 330
 331 (!define-type-method (constant :negate) (type)
 332   (error "NOT CONSTANT too confusing on ~S" (type-specifier type)))
 333
 334 (!define-type-method (constant :unparse) (type)
 335   `(constant-arg ,(type-specifier (constant-type-type type))))
 336
 337 (!define-type-method (constant :simple-=) (type1 type2)
 338   (type= (constant-type-type type1) (constant-type-type type2)))
 339
 340 (!def-type-translator constant-arg (type)
 341   (make-constant-type :type (single-value-specifier-type type)))
 342
 343 ;;; Return the lambda-list-like type specification corresponding
 344 ;;; to an ARGS-TYPE.
 345 (declaim (ftype (function (args-type) list) unparse-args-types))
 346 (defun unparse-args-types (type)
 347   (collect ((result))
 348
 349     (dolist (arg (args-type-required type))
 350       (result (type-specifier arg)))
 351
 352     (when (args-type-optional type)
 353       (result '&optional)
 354       (dolist (arg (args-type-optional type))
 355         (result (type-specifier arg))))
 356
 357     (when (args-type-rest type)
 358       (result '&rest)
 359       (result (type-specifier (args-type-rest type))))
 360
 361     (when (args-type-keyp type)
 362       (result '&key)
 363       (dolist (key (args-type-keywords type))
 364         (result (list (key-info-name key)
 365                       (type-specifier (key-info-type key))))))
 366
 367     (when (args-type-allowp type)
 368       (result '&allow-other-keys))
 369
 370     (result)))
 371
 372 (!def-type-translator function (&optional (args '*) (result '*))
 373   (make-fun-type :args args
 374                  :returns (coerce-to-values (values-specifier-type result))))
 375
 376 (!def-type-translator values (&rest values)
 377   (make-values-type :args values))
 378 \f
 379 ;;;; VALUES types interfaces
 380 ;;;;
 381 ;;;; We provide a few special operations that can be meaningfully used
 382 ;;;; on VALUES types (as well as on any other type).
 383
 384 (defun type-single-value-p (type)
 385   (and (values-type-p type)
 386        (not (values-type-rest type))
 387        (null (values-type-optional type))
 388        (singleton-p (values-type-required type))))
 389
 390 ;;; Return the type of the first value indicated by TYPE. This is used
 391 ;;; by people who don't want to have to deal with VALUES types.
 392 #!-sb-fluid (declaim (freeze-type values-type))
 393 ; (inline single-value-type))
 394 (defun single-value-type (type)
 395   (declare (type ctype type))
 396   (cond ((eq type *wild-type*)
 397          *universal-type*)
 398         ((eq type *empty-type*)
 399          *empty-type*)
 400         ((not (values-type-p type))
 401          type)
 402         (t (or (car (args-type-required type))
 403                (car (args-type-optional type))
 404                (args-type-rest type)
 405                (specifier-type 'null)))))
 406
 407 ;;; Return the minimum number of arguments that a function can be
 408 ;;; called with, and the maximum number or NIL. If not a function
 409 ;;; type, return NIL, NIL.
 410 (defun fun-type-nargs (type)
 411   (declare (type ctype type))
 412   (if (and (fun-type-p type) (not (fun-type-wild-args type)))
 413       (let ((fixed (length (args-type-required type))))
 414         (if (or (args-type-rest type)
 415                 (args-type-keyp type)
 416                 (args-type-allowp type))
 417             (values fixed nil)
 418             (values fixed (+ fixed (length (args-type-optional type))))))
 419       (values nil nil)))
 420
 421 ;;; Determine whether TYPE corresponds to a definite number of values.
 422 ;;; The first value is a list of the types for each value, and the
 423 ;;; second value is the number of values. If the number of values is
 424 ;;; not fixed, then return NIL and :UNKNOWN.
 425 (defun values-types (type)
 426   (declare (type ctype type))
 427   (cond ((or (eq type *wild-type*) (eq type *empty-type*))
 428          (values nil :unknown))
 429         ((or (args-type-optional type)
 430              (args-type-rest type))
 431          (values nil :unknown))
 432         (t
 433          (let ((req (args-type-required type)))
 434            (values req (length req))))))
 435
 436 ;;; Return two values:
 437 ;;; 1. A list of all the positional (fixed and optional) types.
 438 ;;; 2. The &REST type (if any). If no &REST, then the DEFAULT-TYPE.
 439 (defun values-type-types (type &optional (default-type *empty-type*))
 440   (declare (type ctype type))
 441   (if (eq type *wild-type*)
 442       (values nil *universal-type*)
 443       (values (append (args-type-required type)
 444                       (args-type-optional type))
 445               (cond ((args-type-rest type))
 446                     (t default-type)))))
 447
 448 ;;; types of values in (the <type> (values o_1 ... o_n))
 449 (defun values-type-out (type count)
 450   (declare (type ctype type) (type unsigned-byte count))
 451   (if (eq type *wild-type*)
 452       (make-list count :initial-element *universal-type*)
 453       (collect ((res))
 454         (flet ((process-types (types)
 455                  (loop for type in types
 456                        while (plusp count)
 457                        do (decf count)
 458                        do (res type))))
 459           (process-types (values-type-required type))
 460           (process-types (values-type-optional type))
 461           (when (plusp count)
 462             (loop with rest = (the ctype (values-type-rest type))
 463                   repeat count
 464                   do (res rest))))
 465         (res))))
 466
 467 ;;; types of variable in (m-v-bind (v_1 ... v_n) (the <type> ...
 468 (defun values-type-in (type count)
 469   (declare (type ctype type) (type unsigned-byte count))
 470   (if (eq type *wild-type*)
 471       (make-list count :initial-element *universal-type*)
 472       (collect ((res))
 473         (let ((null-type (specifier-type 'null)))
 474           (loop for type in (values-type-required type)
 475              while (plusp count)
 476              do (decf count)
 477              do (res type))
 478           (loop for type in (values-type-optional type)
 479              while (plusp count)
 480              do (decf count)
 481              do (res (type-union type null-type)))
 482           (when (plusp count)
 483             (loop with rest = (acond ((values-type-rest type)
 484                                       (type-union it null-type))
 485                                      (t null-type))
 486                repeat count
 487                do (res rest))))
 488         (res))))
 489
 490 ;;; Return a list of OPERATION applied to the types in TYPES1 and
 491 ;;; TYPES2, padding with REST2 as needed. TYPES1 must not be shorter
 492 ;;; than TYPES2. The second value is T if OPERATION always returned a
 493 ;;; true second value.
 494 (defun fixed-values-op (types1 types2 rest2 operation)
 495   (declare (list types1 types2) (type ctype rest2) (type function operation))
 496   (let ((exact t))
 497     (values (mapcar (lambda (t1 t2)
 498                       (multiple-value-bind (res win)
 499                           (funcall operation t1 t2)
 500                         (unless win
 501                           (setq exact nil))
 502                         res))
 503                     types1
 504                     (append types2
 505                             (make-list (- (length types1) (length types2))
 506                                        :initial-element rest2)))
 507             exact)))
 508
 509 ;;; If TYPE isn't a values type, then make it into one.
 510 (defun-cached (%coerce-to-values
 511                :hash-bits 8
 512                :hash-function (lambda (type)
 513                                 (logand (type-hash-value type)
 514                                         #xff)))
 515     ((type eq))
 516   (cond ((multiple-value-bind (res sure)
 517              (csubtypep (specifier-type 'null) type)
 518            (and (not res) sure))
 519          ;; FIXME: What should we do with (NOT SURE)?
 520          (make-values-type :required (list type) :rest *universal-type*))
 521         (t
 522          (make-values-type :optional (list type) :rest *universal-type*))))
 523
 524 (defun coerce-to-values (type)
 525   (declare (type ctype type))
 526   (cond ((or (eq type *universal-type*)
 527              (eq type *wild-type*))
 528          *wild-type*)
 529         ((values-type-p type)
 530          type)
 531         (t (%coerce-to-values type))))
 532
 533 ;;; Return type, corresponding to ANSI short form of VALUES type
 534 ;;; specifier.
 535 (defun make-short-values-type (types)
 536   (declare (list types))
 537   (let ((last-required (position-if
 538                         (lambda (type)
 539                           (not/type (csubtypep (specifier-type 'null) type)))
 540                         types
 541                         :from-end t)))
 542     (if last-required
 543         (make-values-type :required (subseq types 0 (1+ last-required))
 544                           :optional (subseq types (1+ last-required))
 545                           :rest *universal-type*)
 546         (make-values-type :optional types :rest *universal-type*))))
 547
 548 (defun make-single-value-type (type)
 549   (make-values-type :required (list type)))
 550
 551 ;;; Do the specified OPERATION on TYPE1 and TYPE2, which may be any
 552 ;;; type, including VALUES types. With VALUES types such as:
 553 ;;;    (VALUES a0 a1)
 554 ;;;    (VALUES b0 b1)
 555 ;;; we compute the more useful result
 556 ;;;    (VALUES (<operation> a0 b0) (<operation> a1 b1))
 557 ;;; rather than the precise result
 558 ;;;    (<operation> (values a0 a1) (values b0 b1))
 559 ;;; This has the virtue of always keeping the VALUES type specifier
 560 ;;; outermost, and retains all of the information that is really
 561 ;;; useful for static type analysis. We want to know what is always
 562 ;;; true of each value independently. It is worthless to know that if
 563 ;;; the first value is B0 then the second will be B1.
 564 ;;;
 565 ;;; If the VALUES count signatures differ, then we produce a result with
 566 ;;; the required VALUE count chosen by NREQ when applied to the number
 567 ;;; of required values in TYPE1 and TYPE2. Any &KEY values become
 568 ;;; &REST T (anyone who uses keyword values deserves to lose.)
 569 ;;;
 570 ;;; The second value is true if the result is definitely empty or if
 571 ;;; OPERATION returned true as its second value each time we called
 572 ;;; it. Since we approximate the intersection of VALUES types, the
 573 ;;; second value being true doesn't mean the result is exact.
 574 (defun args-type-op (type1 type2 operation nreq)
 575   (declare (type ctype type1 type2)
 576            (type function operation nreq))
 577   (when (eq type1 type2)
 578     (values type1 t))
 579   (multiple-value-bind (types1 rest1)
 580       (values-type-types type1)
 581     (multiple-value-bind (types2 rest2)
 582         (values-type-types type2)
 583       (multiple-value-bind (rest rest-exact)
 584           (funcall operation rest1 rest2)
 585         (multiple-value-bind (res res-exact)
 586             (if (< (length types1) (length types2))
 587                 (fixed-values-op types2 types1 rest1 operation)
 588                 (fixed-values-op types1 types2 rest2 operation))
 589           (let* ((req (funcall nreq
 590                                (length (args-type-required type1))
 591                                (length (args-type-required type2))))
 592                  (required (subseq res 0 req))
 593                  (opt (subseq res req)))
 594             (values required opt rest
 595                     (and rest-exact res-exact))))))))
 596
 597 (defun values-type-op (type1 type2 operation nreq)
 598   (multiple-value-bind (required optional rest exactp)
 599       (args-type-op type1 type2 operation nreq)
 600     (values (make-values-type :required required
 601                               :optional optional
 602                               :rest rest)
 603             exactp)))
 604
 605 (defun type=-args (type1 type2)
 606   (macrolet ((compare (comparator field)
 607                (let ((reader (symbolicate '#:args-type- field)))
 608                  `(,comparator (,reader type1) (,reader type2)))))
 609     (and/type
 610      (cond ((null (args-type-rest type1))
 611             (values (null (args-type-rest type2)) t))
 612            ((null (args-type-rest type2))
 613             (values nil t))
 614            (t
 615             (compare type= rest)))
 616      (and/type (and/type (compare type=-list required)
 617                          (compare type=-list optional))
 618                (if (or (args-type-keyp type1) (args-type-keyp type2))
 619                    (values nil nil)
 620                    (values t t))))))
 621
 622 ;;; Do a union or intersection operation on types that might be values
 623 ;;; types. The result is optimized for utility rather than exactness,
 624 ;;; but it is guaranteed that it will be no smaller (more restrictive)
 625 ;;; than the precise result.
 626 ;;;
 627 ;;; The return convention seems to be analogous to
 628 ;;; TYPES-EQUAL-OR-INTERSECT. -- WHN 19990910.
 629 (defun-cached (values-type-union :hash-function type-cache-hash
 630                                  :hash-bits 8
 631                                  :default nil
 632                                  :init-wrapper !cold-init-forms)
 633     ((type1 eq) (type2 eq))
 634   (declare (type ctype type1 type2))
 635   (cond ((or (eq type1 *wild-type*) (eq type2 *wild-type*)) *wild-type*)
 636         ((eq type1 *empty-type*) type2)
 637         ((eq type2 *empty-type*) type1)
 638         (t
 639          (values (values-type-op type1 type2 #'type-union #'min)))))
 640
 641 (defun-cached (values-type-intersection :hash-function type-cache-hash
 642                                         :hash-bits 8
 643                                         :default (values nil)
 644                                         :init-wrapper !cold-init-forms)
 645     ((type1 eq) (type2 eq))
 646   (declare (type ctype type1 type2))
 647   (cond ((eq type1 *wild-type*)
 648          (coerce-to-values type2))
 649         ((or (eq type2 *wild-type*) (eq type2 *universal-type*))
 650          type1)
 651         ((or (eq type1 *empty-type*) (eq type2 *empty-type*))
 652          *empty-type*)
 653         ((and (not (values-type-p type2))
 654               (values-type-required type1))
 655          (let ((req1 (values-type-required type1)))
 656            (make-values-type :required (cons (type-intersection (first req1) type2)
 657                                              (rest req1))
 658                              :optional (values-type-optional type1)
 659                              :rest (values-type-rest type1)
 660                              :allowp (values-type-allowp type1))))
 661         (t
 662          (values (values-type-op type1 (coerce-to-values type2)
 663                                  #'type-intersection
 664                                  #'max)))))
 665
 666 ;;; This is like TYPES-EQUAL-OR-INTERSECT, except that it sort of
 667 ;;; works on VALUES types. Note that due to the semantics of
 668 ;;; VALUES-TYPE-INTERSECTION, this might return (VALUES T T) when
 669 ;;; there isn't really any intersection.
 670 (defun values-types-equal-or-intersect (type1 type2)
 671   (cond ((or (eq type1 *empty-type*) (eq type2 *empty-type*))
 672          (values t t))
 673         ((or (eq type1 *wild-type*) (eq type2 *wild-type*))
 674          (values t t))
 675         (t
 676          (let ((res (values-type-intersection type1 type2)))
 677            (values (not (eq res *empty-type*))
 678                    t)))))
 679
 680 ;;; a SUBTYPEP-like operation that can be used on any types, including
 681 ;;; VALUES types
 682 (defun-cached (values-subtypep :hash-function type-cache-hash
 683                                :hash-bits 8
 684                                :values 2
 685                                :default (values nil :empty)
 686                                :init-wrapper !cold-init-forms)
 687     ((type1 eq) (type2 eq))
 688   (declare (type ctype type1 type2))
 689   (cond ((or (eq type2 *wild-type*) (eq type2 *universal-type*)
 690              (eq type1 *empty-type*))
 691          (values t t))
 692         ((eq type1 *wild-type*)
 693          (values (eq type2 *wild-type*) t))
 694         ((or (eq type2 *empty-type*)
 695              (not (values-types-equal-or-intersect type1 type2)))
 696          (values nil t))
 697         ((and (not (values-type-p type2))
 698               (values-type-required type1))
 699          (csubtypep (first (values-type-required type1))
 700                     type2))
 701         (t (setq type2 (coerce-to-values type2))
 702            (multiple-value-bind (types1 rest1) (values-type-types type1)
 703              (multiple-value-bind (types2 rest2) (values-type-types type2)
 704                (cond ((< (length (values-type-required type1))
 705                          (length (values-type-required type2)))
 706                       (values nil t))
 707                      ((< (length types1) (length types2))
 708                       (values nil nil))
 709                      (t
 710                       (do ((t1 types1 (rest t1))
 711                            (t2 types2 (rest t2)))
 712                           ((null t2)
 713                            (csubtypep rest1 rest2))
 714                         (multiple-value-bind (res win-p)
 715                             (csubtypep (first t1) (first t2))
 716                           (unless win-p
 717                             (return (values nil nil)))
 718                           (unless res
 719                             (return (values nil t))))))))))))
 720 \f
 721 ;;;; type method interfaces
 722
 723 ;;; like SUBTYPEP, only works on CTYPE structures
 724 (defun-cached (csubtypep :hash-function type-cache-hash
 725                          :hash-bits 8
 726                          :values 2
 727                          :default (values nil :empty)
 728                          :init-wrapper !cold-init-forms)
 729               ((type1 eq) (type2 eq))
 730   (declare (type ctype type1 type2))
 731   (cond ((or (eq type1 type2)
 732              (eq type1 *empty-type*)
 733              (eq type2 *universal-type*))
 734          (values t t))
 735         #+nil
 736         ((eq type1 *universal-type*)
 737          (values nil t))
 738         (t
 739          (!invoke-type-method :simple-subtypep :complex-subtypep-arg2
 740                               type1 type2
 741                               :complex-arg1 :complex-subtypep-arg1))))
 742
 743 ;;; Just parse the type specifiers and call CSUBTYPE.
 744 (defun sb!xc:subtypep (type1 type2 &optional environment)
 745   #!+sb-doc
 746   "Return two values indicating the relationship between type1 and type2.
 747   If values are T and T, type1 definitely is a subtype of type2.
 748   If values are NIL and T, type1 definitely is not a subtype of type2.
 749   If values are NIL and NIL, it couldn't be determined."
 750   (declare (ignore environment))
 751   (csubtypep (specifier-type type1) (specifier-type type2)))
 752
 753 ;;; If two types are definitely equivalent, return true. The second
 754 ;;; value indicates whether the first value is definitely correct.
 755 ;;; This should only fail in the presence of HAIRY types.
 756 (defun-cached (type= :hash-function type-cache-hash
 757                      :hash-bits 8
 758                      :values 2
 759                      :default (values nil :empty)
 760                      :init-wrapper !cold-init-forms)
 761               ((type1 eq) (type2 eq))
 762   (declare (type ctype type1 type2))
 763   (if (eq type1 type2)
 764       (values t t)
 765       (!invoke-type-method :simple-= :complex-= type1 type2)))
 766
 767 ;;; Not exactly the negation of TYPE=, since when the relationship is
 768 ;;; uncertain, we still return NIL, NIL. This is useful in cases where
 769 ;;; the conservative assumption is =.
 770 (defun type/= (type1 type2)
 771   (declare (type ctype type1 type2))
 772   (multiple-value-bind (res win) (type= type1 type2)
 773     (if win
 774         (values (not res) t)
 775         (values nil nil))))
 776
 777 ;;; the type method dispatch case of TYPE-UNION2
 778 (defun %type-union2 (type1 type2)
 779   ;; As in %TYPE-INTERSECTION2, it seems to be a good idea to give
 780   ;; both argument orders a chance at COMPLEX-INTERSECTION2. Unlike
 781   ;; %TYPE-INTERSECTION2, though, I don't have a specific case which
 782   ;; demonstrates this is actually necessary. Also unlike
 783   ;; %TYPE-INTERSECTION2, there seems to be no need to distinguish
 784   ;; between not finding a method and having a method return NIL.
 785   (flet ((1way (x y)
 786            (!invoke-type-method :simple-union2 :complex-union2
 787                                 x y
 788                                 :default nil)))
 789     (declare (inline 1way))
 790     (or (1way type1 type2)
 791         (1way type2 type1))))
 792
 793 ;;; Find a type which includes both types. Any inexactness is
 794 ;;; represented by the fuzzy element types; we return a single value
 795 ;;; that is precise to the best of our knowledge. This result is
 796 ;;; simplified into the canonical form, thus is not a UNION-TYPE
 797 ;;; unless we find no other way to represent the result.
 798 (defun-cached (type-union2 :hash-function type-cache-hash
 799                            :hash-bits 8
 800                            :init-wrapper !cold-init-forms)
 801               ((type1 eq) (type2 eq))
 802   ;; KLUDGE: This was generated from TYPE-INTERSECTION2 by Ye Olde Cut And
 803   ;; Paste technique of programming. If it stays around (as opposed to
 804   ;; e.g. fading away in favor of some CLOS solution) the shared logic
 805   ;; should probably become shared code. -- WHN 2001-03-16
 806   (declare (type ctype type1 type2))
 807   (cond ((eq type1 type2)
 808          type1)
 809         ((csubtypep type1 type2) type2)
 810         ((csubtypep type2 type1) type1)
 811         ((or (union-type-p type1)
 812              (union-type-p type2))
 813          ;; Unions of UNION-TYPE should have the UNION-TYPE-TYPES
 814          ;; values broken out and united separately. The full TYPE-UNION
 815          ;; function knows how to do this, so let it handle it.
 816          (type-union type1 type2))
 817         (t
 818          ;; the ordinary case: we dispatch to type methods
 819          (%type-union2 type1 type2))))
 820
 821 ;;; the type method dispatch case of TYPE-INTERSECTION2
 822 (defun %type-intersection2 (type1 type2)
 823   ;; We want to give both argument orders a chance at
 824   ;; COMPLEX-INTERSECTION2. Without that, the old CMU CL type
 825   ;; methods could give noncommutative results, e.g.
 826   ;;   (TYPE-INTERSECTION2 *EMPTY-TYPE* SOME-HAIRY-TYPE)
 827   ;;     => NIL, NIL
 828   ;;   (TYPE-INTERSECTION2 SOME-HAIRY-TYPE *EMPTY-TYPE*)
 829   ;;     => #<NAMED-TYPE NIL>, T
 830   ;; We also need to distinguish between the case where we found a
 831   ;; type method, and it returned NIL, and the case where we fell
 832   ;; through without finding any type method. An example of the first
 833   ;; case is the intersection of a HAIRY-TYPE with some ordinary type.
 834   ;; An example of the second case is the intersection of two
 835   ;; completely-unrelated types, e.g. CONS and NUMBER, or SYMBOL and
 836   ;; ARRAY.
 837   ;;
 838   ;; (Why yes, CLOS probably *would* be nicer..)
 839   (flet ((1way (x y)
 840            (!invoke-type-method :simple-intersection2 :complex-intersection2
 841                                 x y
 842                                 :default :call-other-method)))
 843     (declare (inline 1way))
 844     (let ((xy (1way type1 type2)))
 845       (or (and (not (eql xy :call-other-method)) xy)
 846           (let ((yx (1way type2 type1)))
 847             (or (and (not (eql yx :call-other-method)) yx)
 848                 (cond ((and (eql xy :call-other-method)
 849                             (eql yx :call-other-method))
 850                        *empty-type*)
 851                       (t
 852                        (aver (and (not xy) (not yx))) ; else handled above
 853                        nil))))))))
 854
 855 (defun-cached (type-intersection2 :hash-function type-cache-hash
 856                                   :hash-bits 8
 857                                   :values 1
 858                                   :default nil
 859                                   :init-wrapper !cold-init-forms)
 860               ((type1 eq) (type2 eq))
 861   (declare (type ctype type1 type2))
 862   (cond ((eq type1 type2)
 863          ;; FIXME: For some reason, this doesn't catch e.g. type1 =
 864          ;; type2 = (SPECIFIER-TYPE
 865          ;; 'SOME-UNKNOWN-TYPE). Investigate. - CSR, 2002-04-10
 866          type1)
 867         ((or (intersection-type-p type1)
 868              (intersection-type-p type2))
 869          ;; Intersections of INTERSECTION-TYPE should have the
 870          ;; INTERSECTION-TYPE-TYPES values broken out and intersected
 871          ;; separately. The full TYPE-INTERSECTION function knows how
 872          ;; to do that, so let it handle it.
 873          (type-intersection type1 type2))
 874         (t
 875          ;; the ordinary case: we dispatch to type methods
 876          (%type-intersection2 type1 type2))))
 877
 878 ;;; Return as restrictive and simple a type as we can discover that is
 879 ;;; no more restrictive than the intersection of TYPE1 and TYPE2. At
 880 ;;; worst, we arbitrarily return one of the arguments as the first
 881 ;;; value (trying not to return a hairy type).
 882 (defun type-approx-intersection2 (type1 type2)
 883   (cond ((type-intersection2 type1 type2))
 884         ((hairy-type-p type1) type2)
 885         (t type1)))
 886
 887 ;;; a test useful for checking whether a derived type matches a
 888 ;;; declared type
 889 ;;;
 890 ;;; The first value is true unless the types don't intersect and
 891 ;;; aren't equal. The second value is true if the first value is
 892 ;;; definitely correct. NIL is considered to intersect with any type.
 893 ;;; If T is a subtype of either type, then we also return T, T. This
 894 ;;; way we recognize that hairy types might intersect with T.
 895 (defun types-equal-or-intersect (type1 type2)
 896   (declare (type ctype type1 type2))
 897   (if (or (eq type1 *empty-type*) (eq type2 *empty-type*))
 898       (values t t)
 899       (let ((intersection2 (type-intersection2 type1 type2)))
 900         (cond ((not intersection2)
 901                (if (or (csubtypep *universal-type* type1)
 902                        (csubtypep *universal-type* type2))
 903                    (values t t)
 904                    (values t nil)))
 905               ((eq intersection2 *empty-type*) (values nil t))
 906               (t (values t t))))))
 907
 908 ;;; Return a Common Lisp type specifier corresponding to the TYPE
 909 ;;; object.
 910 (defun type-specifier (type)
 911   (declare (type ctype type))
 912   (funcall (type-class-unparse (type-class-info type)) type))
 913
 914 (defun-cached (type-negation :hash-function (lambda (type)
 915                                               (logand (type-hash-value type)
 916                                                       #xff))
 917                              :hash-bits 8
 918                              :values 1
 919                              :default nil
 920                              :init-wrapper !cold-init-forms)
 921               ((type eq))
 922   (declare (type ctype type))
 923   (funcall (type-class-negate (type-class-info type)) type))
 924
 925 ;;; (VALUES-SPECIFIER-TYPE and SPECIFIER-TYPE moved from here to
 926 ;;; early-type.lisp by WHN ca. 19990201.)
 927
 928 ;;; Take a list of type specifiers, computing the translation of each
 929 ;;; specifier and defining it as a builtin type.
 930 (declaim (ftype (function (list) (values)) precompute-types))
 931 (defun precompute-types (specs)
 932   (dolist (spec specs)
 933     (let ((res (specifier-type spec)))
 934       (unless (unknown-type-p res)
 935         (setf (info :type :builtin spec) res)
 936         ;; KLUDGE: the three copies of this idiom in this file (and
 937         ;; the one in class.lisp as at sbcl-0.7.4.1x) should be
 938         ;; coalesced, or perhaps the error-detecting code that
 939         ;; disallows redefinition of :PRIMITIVE types should be
 940         ;; rewritten to use *TYPE-SYSTEM-FINALIZED* (rather than
 941         ;; *TYPE-SYSTEM-INITIALIZED*). The effect of this is not to
 942         ;; cause redefinition errors when precompute-types is called
 943         ;; for a second time while building the target compiler using
 944         ;; the cross-compiler. -- CSR, trying to explain why this
 945         ;; isn't completely wrong, 2002-06-07
 946         (setf (info :type :kind spec) #+sb-xc-host :defined #-sb-xc-host :primitive))))
 947   (values))
 948 \f
 949 ;;;; general TYPE-UNION and TYPE-INTERSECTION operations
 950 ;;;;
 951 ;;;; These are fully general operations on CTYPEs: they'll always
 952 ;;;; return a CTYPE representing the result.
 953
 954 ;;; shared logic for unions and intersections: Return a list of
 955 ;;; types representing the same types as INPUT-TYPES, but with
 956 ;;; COMPOUND-TYPEs satisfying %COMPOUND-TYPE-P broken up into their
 957 ;;; component types, and with any SIMPLY2 simplifications applied.
 958 (macrolet
 959     ((def (name compound-type-p simplify2)
 960          `(defun ,name (types)
 961             (when types
 962               (multiple-value-bind (first rest)
 963                   (if (,compound-type-p (car types))
 964                       (values (car (compound-type-types (car types)))
 965                               (append (cdr (compound-type-types (car types)))
 966                                       (cdr types)))
 967                       (values (car types) (cdr types)))
 968                 (let ((rest (,name rest)) u)
 969                   (dolist (r rest (cons first rest))
 970                     (when (setq u (,simplify2 first r))
 971                       (return (,name (nsubstitute u r rest)))))))))))
 972   (def simplify-intersections intersection-type-p type-intersection2)
 973   (def simplify-unions union-type-p type-union2))
 974
 975 (defun maybe-distribute-one-union (union-type types)
 976   (let* ((intersection (apply #'type-intersection types))
 977          (union (mapcar (lambda (x) (type-intersection x intersection))
 978                         (union-type-types union-type))))
 979     (if (notany (lambda (x) (or (hairy-type-p x)
 980                                 (intersection-type-p x)))
 981                 union)
 982         union
 983         nil)))
 984
 985 (defun type-intersection (&rest input-types)
 986   (%type-intersection input-types))
 987 (defun-cached (%type-intersection :hash-bits 8
 988                                   :hash-function (lambda (x)
 989                                                    (logand (sxhash x) #xff)))
 990     ((input-types equal))
 991   (let ((simplified-types (simplify-intersections input-types)))
 992     (declare (type list simplified-types))
 993     ;; We want to have a canonical representation of types (or failing
 994     ;; that, punt to HAIRY-TYPE). Canonical representation would have
 995     ;; intersections inside unions but not vice versa, since you can
 996     ;; always achieve that by the distributive rule. But we don't want
 997     ;; to just apply the distributive rule, since it would be too easy
 998     ;; to end up with unreasonably huge type expressions. So instead
 999     ;; we try to generate a simple type by distributing the union; if
1000     ;; the type can't be made simple, we punt to HAIRY-TYPE.
1001     (if (and (cdr simplified-types) (some #'union-type-p simplified-types))
1002         (let* ((first-union (find-if #'union-type-p simplified-types))
1003                (other-types (coerce (remove first-union simplified-types)
1004                                     'list))
1005                (distributed (maybe-distribute-one-union first-union
1006                                                         other-types)))
1007           (if distributed
1008               (apply #'type-union distributed)
1009               (make-hairy-type
1010                :specifier `(and ,@(map 'list
1011                                        #'type-specifier
1012                                        simplified-types)))))
1013         (cond
1014           ((null simplified-types) *universal-type*)
1015           ((null (cdr simplified-types)) (car simplified-types))
1016           (t (%make-intersection-type
1017               (some #'type-enumerable simplified-types)
1018               simplified-types))))))
1019
1020 (defun type-union (&rest input-types)
1021   (%type-union input-types))
1022 (defun-cached (%type-union :hash-bits 8
1023                            :hash-function (lambda (x)
1024                                             (logand (sxhash x) #xff)))
1025     ((input-types equal))
1026   (let ((simplified-types (simplify-unions input-types)))
1027     (cond
1028       ((null simplified-types) *empty-type*)
1029       ((null (cdr simplified-types)) (car simplified-types))
1030       (t (make-union-type
1031           (every #'type-enumerable simplified-types)
1032           simplified-types)))))
1033 \f
1034 ;;;; built-in types
1035
1036 (!define-type-class named)
1037
1038 (!cold-init-forms
1039  (macrolet ((frob (name var)
1040               `(progn
1041                  (setq ,var (make-named-type :name ',name))
1042                  (setf (info :type :kind ',name)
1043                        #+sb-xc-host :defined #-sb-xc-host :primitive)
1044                  (setf (info :type :builtin ',name) ,var))))
1045    ;; KLUDGE: In ANSI, * isn't really the name of a type, it's just a
1046    ;; special symbol which can be stuck in some places where an
1047    ;; ordinary type can go, e.g. (ARRAY * 1) instead of (ARRAY T 1).
1048    ;; In SBCL it also used to denote universal VALUES type.
1049    (frob * *wild-type*)
1050    (frob nil *empty-type*)
1051    (frob t *universal-type*))
1052  (setf *universal-fun-type*
1053        (make-fun-type :wild-args t
1054                       :returns *wild-type*)))
1055
1056 (!define-type-method (named :simple-=) (type1 type2)
1057   ;;(aver (not (eq type1 *wild-type*))) ; * isn't really a type.
1058   (values (eq type1 type2) t))
1059
1060 (!define-type-method (named :complex-=) (type1 type2)
1061   (cond
1062     ((and (eq type2 *empty-type*)
1063           (intersection-type-p type1)
1064           ;; not allowed to be unsure on these... FIXME: keep the list
1065           ;; of CL types that are intersection types once and only
1066           ;; once.
1067           (not (or (type= type1 (specifier-type 'ratio))
1068                    (type= type1 (specifier-type 'keyword)))))
1069      ;; things like (AND (EQL 0) (SATISFIES ODDP)) or (AND FUNCTION
1070      ;; STREAM) can get here.  In general, we can't really tell
1071      ;; whether these are equal to NIL or not, so
1072      (values nil nil))
1073     ((type-might-contain-other-types-p type1)
1074      (invoke-complex-=-other-method type1 type2))
1075     (t (values nil t))))
1076
1077 (!define-type-method (named :simple-subtypep) (type1 type2)
1078   (aver (not (eq type1 *wild-type*))) ; * isn't really a type.
1079   (values (or (eq type1 *empty-type*) (eq type2 *wild-type*)) t))
1080
1081 (!define-type-method (named :complex-subtypep-arg1) (type1 type2)
1082   ;; This AVER causes problems if we write accurate methods for the
1083   ;; union (and possibly intersection) types which then delegate to
1084   ;; us; while a user shouldn't get here, because of the odd status of
1085   ;; *wild-type* a type-intersection executed by the compiler can. -
1086   ;; CSR, 2002-04-10
1087   ;;
1088   ;; (aver (not (eq type1 *wild-type*))) ; * isn't really a type.
1089   (cond ((eq type1 *empty-type*)
1090          t)
1091         (;; When TYPE2 might be the universal type in disguise
1092          (type-might-contain-other-types-p type2)
1093          ;; Now that the UNION and HAIRY COMPLEX-SUBTYPEP-ARG2 methods
1094          ;; can delegate to us (more or less as CALL-NEXT-METHOD) when
1095          ;; they're uncertain, we can't just barf on COMPOUND-TYPE and
1096          ;; HAIRY-TYPEs as we used to. Instead we deal with the
1097          ;; problem (where at least part of the problem is cases like
1098          ;;   (SUBTYPEP T '(SATISFIES FOO))
1099          ;; or
1100          ;;   (SUBTYPEP T '(AND (SATISFIES FOO) (SATISFIES BAR)))
1101          ;; where the second type is a hairy type like SATISFIES, or
1102          ;; is a compound type which might contain a hairy type) by
1103          ;; returning uncertainty.
1104          (values nil nil))
1105         (t
1106          ;; By elimination, TYPE1 is the universal type.
1107          (aver (eq type1 *universal-type*))
1108          ;; This case would have been picked off by the SIMPLE-SUBTYPEP
1109          ;; method, and so shouldn't appear here.
1110          (aver (not (eq type2 *universal-type*)))
1111          ;; Since TYPE2 is not EQ *UNIVERSAL-TYPE* and is not the
1112          ;; universal type in disguise, TYPE2 is not a superset of TYPE1.
1113          (values nil t))))
1114
1115 (!define-type-method (named :complex-subtypep-arg2) (type1 type2)
1116   (aver (not (eq type2 *wild-type*))) ; * isn't really a type.
1117   (cond ((eq type2 *universal-type*)
1118          (values t t))
1119         ((type-might-contain-other-types-p type1)
1120          ;; those types can be *EMPTY-TYPE* or *UNIVERSAL-TYPE* in
1121          ;; disguise.  So we'd better delegate.
1122          (invoke-complex-subtypep-arg1-method type1 type2))
1123         (t
1124          ;; FIXME: This seems to rely on there only being 2 or 3
1125          ;; NAMED-TYPE values, and the exclusion of various
1126          ;; possibilities above. It would be good to explain it and/or
1127          ;; rewrite it so that it's clearer.
1128          (values (not (eq type2 *empty-type*)) t))))
1129
1130 (!define-type-method (named :complex-intersection2) (type1 type2)
1131   ;; FIXME: This assertion failed when I added it in sbcl-0.6.11.13.
1132   ;; Perhaps when bug 85 is fixed it can be reenabled.
1133   ;;(aver (not (eq type2 *wild-type*))) ; * isn't really a type.
1134   (hierarchical-intersection2 type1 type2))
1135
1136 (!define-type-method (named :complex-union2) (type1 type2)
1137   ;; Perhaps when bug 85 is fixed this can be reenabled.
1138   ;;(aver (not (eq type2 *wild-type*))) ; * isn't really a type.
1139   (hierarchical-union2 type1 type2))
1140
1141 (!define-type-method (named :negate) (x)
1142   (aver (not (eq x *wild-type*)))
1143   (cond
1144     ((eq x *universal-type*) *empty-type*)
1145     ((eq x *empty-type*) *universal-type*)
1146     (t (bug "NAMED type not universal, wild or empty: ~S" x))))
1147
1148 (!define-type-method (named :unparse) (x)
1149   (named-type-name x))
1150 \f
1151 ;;;; hairy and unknown types
1152
1153 (!define-type-method (hairy :negate) (x)
1154   (make-negation-type :type x))
1155
1156 (!define-type-method (hairy :unparse) (x)
1157   (hairy-type-specifier x))
1158
1159 (!define-type-method (hairy :simple-subtypep) (type1 type2)
1160   (let ((hairy-spec1 (hairy-type-specifier type1))
1161         (hairy-spec2 (hairy-type-specifier type2)))
1162     (cond ((equal-but-no-car-recursion hairy-spec1 hairy-spec2)
1163            (values t t))
1164           (t
1165            (values nil nil)))))
1166
1167 (!define-type-method (hairy :complex-subtypep-arg2) (type1 type2)
1168   (invoke-complex-subtypep-arg1-method type1 type2))
1169
1170 (!define-type-method (hairy :complex-subtypep-arg1) (type1 type2)
1171   (declare (ignore type1 type2))
1172   (values nil nil))
1173
1174 (!define-type-method (hairy :complex-=) (type1 type2)
1175   (if (and (unknown-type-p type2)
1176            (let* ((specifier2 (unknown-type-specifier type2))
1177                   (name2 (if (consp specifier2)
1178                              (car specifier2)
1179                              specifier2)))
1180              (info :type :kind name2)))
1181       (let ((type2 (specifier-type (unknown-type-specifier type2))))
1182         (if (unknown-type-p type2)
1183             (values nil nil)
1184             (type= type1 type2)))
1185   (values nil nil)))
1186
1187 (!define-type-method (hairy :simple-intersection2 :complex-intersection2)
1188                      (type1 type2)
1189   (if (type= type1 type2)
1190       type1
1191       nil))
1192
1193 (!define-type-method (hairy :simple-union2)
1194                      (type1 type2)
1195   (if (type= type1 type2)
1196       type1
1197       nil))
1198
1199 (!define-type-method (hairy :simple-=) (type1 type2)
1200   (if (equal-but-no-car-recursion (hairy-type-specifier type1)
1201                                   (hairy-type-specifier type2))
1202       (values t t)
1203       (values nil nil)))
1204
1205 (!def-type-translator satisfies (&whole whole fun)
1206   (declare (ignore fun))
1207   ;; Check legality of arguments.
1208   (destructuring-bind (satisfies predicate-name) whole
1209     (declare (ignore satisfies))
1210     (unless (symbolp predicate-name)
1211       (error 'simple-type-error
1212              :datum predicate-name
1213              :expected-type 'symbol
1214              :format-control "The SATISFIES predicate name is not a symbol: ~S"
1215              :format-arguments (list predicate-name))))
1216   ;; Create object.
1217   (make-hairy-type :specifier whole))
1218 \f
1219 ;;;; negation types
1220
1221 (!define-type-method (negation :negate) (x)
1222   (negation-type-type x))
1223
1224 (!define-type-method (negation :unparse) (x)
1225   (if (type= (negation-type-type x) (specifier-type 'cons))
1226       'atom
1227       `(not ,(type-specifier (negation-type-type x)))))
1228
1229 (!define-type-method (negation :simple-subtypep) (type1 type2)
1230   (csubtypep (negation-type-type type2) (negation-type-type type1)))
1231
1232 (!define-type-method (negation :complex-subtypep-arg2) (type1 type2)
1233   (let* ((complement-type2 (negation-type-type type2))
1234          (intersection2 (type-intersection2 type1
1235                                             complement-type2)))
1236     (if intersection2
1237         ;; FIXME: if uncertain, maybe try arg1?
1238         (type= intersection2 *empty-type*)
1239         (invoke-complex-subtypep-arg1-method type1 type2))))
1240
1241 (!define-type-method (negation :complex-subtypep-arg1) (type1 type2)
1242   ;; "Incrementally extended heuristic algorithms tend inexorably toward the
1243   ;; incomprehensible." -- http://www.unlambda.com/~james/lambda/lambda.txt
1244   ;;
1245   ;; You may not believe this. I couldn't either. But then I sat down
1246   ;; and drew lots of Venn diagrams. Comments involving a and b refer
1247   ;; to the call (subtypep '(not a) 'b) -- CSR, 2002-02-27.
1248   (block nil
1249     ;; (Several logical truths in this block are true as long as
1250     ;; b/=T. As of sbcl-0.7.1.28, it seems impossible to construct a
1251     ;; case with b=T where we actually reach this type method, but
1252     ;; we'll test for and exclude this case anyway, since future
1253     ;; maintenance might make it possible for it to end up in this
1254     ;; code.)
1255     (multiple-value-bind (equal certain)
1256         (type= type2 *universal-type*)
1257       (unless certain
1258         (return (values nil nil)))
1259       (when equal
1260         (return (values t t))))
1261     (let ((complement-type1 (negation-type-type type1)))
1262       ;; Do the special cases first, in order to give us a chance if
1263       ;; subtype/supertype relationships are hairy.
1264       (multiple-value-bind (equal certain)
1265           (type= complement-type1 type2)
1266         ;; If a = b, ~a is not a subtype of b (unless b=T, which was
1267         ;; excluded above).
1268         (unless certain
1269           (return (values nil nil)))
1270         (when equal
1271           (return (values nil t))))
1272       ;; KLUDGE: ANSI requires that the SUBTYPEP result between any
1273       ;; two built-in atomic type specifiers never be uncertain. This
1274       ;; is hard to do cleanly for the built-in types whose
1275       ;; definitions include (NOT FOO), i.e. CONS and RATIO. However,
1276       ;; we can do it with this hack, which uses our global knowledge
1277       ;; that our implementation of the type system uses disjoint
1278       ;; implementation types to represent disjoint sets (except when
1279       ;; types are contained in other types).  (This is a KLUDGE
1280       ;; because it's fragile. Various changes in internal
1281       ;; representation in the type system could make it start
1282       ;; confidently returning incorrect results.) -- WHN 2002-03-08
1283       (unless (or (type-might-contain-other-types-p complement-type1)
1284                   (type-might-contain-other-types-p type2))
1285         ;; Because of the way our types which don't contain other
1286         ;; types are disjoint subsets of the space of possible values,
1287         ;; (SUBTYPEP '(NOT AA) 'B)=NIL when AA and B are simple (and B
1288         ;; is not T, as checked above).
1289         (return (values nil t)))
1290       ;; The old (TYPE= TYPE1 TYPE2) branch would never be taken, as
1291       ;; TYPE1 and TYPE2 will only be equal if they're both NOT types,
1292       ;; and then the :SIMPLE-SUBTYPEP method would be used instead.
1293       ;; But a CSUBTYPEP relationship might still hold:
1294       (multiple-value-bind (equal certain)
1295           (csubtypep complement-type1 type2)
1296         ;; If a is a subtype of b, ~a is not a subtype of b (unless
1297         ;; b=T, which was excluded above).
1298         (unless certain
1299           (return (values nil nil)))
1300         (when equal
1301           (return (values nil t))))
1302       (multiple-value-bind (equal certain)
1303           (csubtypep type2 complement-type1)
1304         ;; If b is a subtype of a, ~a is not a subtype of b.  (FIXME:
1305         ;; That's not true if a=T. Do we know at this point that a is
1306         ;; not T?)
1307         (unless certain
1308           (return (values nil nil)))
1309         (when equal
1310           (return (values nil t))))
1311       ;; old CSR comment ca. 0.7.2, now obsoleted by the SIMPLE-CTYPE?
1312       ;; KLUDGE case above: Other cases here would rely on being able
1313       ;; to catch all possible cases, which the fragility of this type
1314       ;; system doesn't inspire me; for instance, if a is type= to ~b,
1315       ;; then we want T, T; if this is not the case and the types are
1316       ;; disjoint (have an intersection of *empty-type*) then we want
1317       ;; NIL, T; else if the union of a and b is the *universal-type*
1318       ;; then we want T, T. So currently we still claim to be unsure
1319       ;; about e.g. (subtypep '(not fixnum) 'single-float).
1320       ;;
1321       ;; OTOH we might still get here:
1322       (values nil nil))))
1323
1324 (!define-type-method (negation :complex-=) (type1 type2)
1325   ;; (NOT FOO) isn't equivalent to anything that's not a negation
1326   ;; type, except possibly a type that might contain it in disguise.
1327   (declare (ignore type2))
1328   (if (type-might-contain-other-types-p type1)
1329       (values nil nil)
1330       (values nil t)))
1331
1332 (!define-type-method (negation :simple-intersection2) (type1 type2)
1333   (let ((not1 (negation-type-type type1))
1334         (not2 (negation-type-type type2)))
1335     (cond
1336       ((csubtypep not1 not2) type2)
1337       ((csubtypep not2 not1) type1)
1338       ;; Why no analagous clause to the disjoint in the SIMPLE-UNION2
1339       ;; method, below?  The clause would read
1340       ;;
1341       ;; ((EQ (TYPE-UNION NOT1 NOT2) *UNIVERSAL-TYPE*) *EMPTY-TYPE*)
1342       ;;
1343       ;; but with proper canonicalization of negation types, there's
1344       ;; no way of constructing two negation types with union of their
1345       ;; negations being the universal type.
1346       (t
1347        (aver (not (eq (type-union not1 not2) *universal-type*)))
1348        nil))))
1349
1350 (!define-type-method (negation :complex-intersection2) (type1 type2)
1351   (cond
1352     ((csubtypep type1 (negation-type-type type2)) *empty-type*)
1353     ((eq (type-intersection type1 (negation-type-type type2)) *empty-type*)
1354      type1)
1355     (t nil)))
1356
1357 (!define-type-method (negation :simple-union2) (type1 type2)
1358   (let ((not1 (negation-type-type type1))
1359         (not2 (negation-type-type type2)))
1360     (cond
1361       ((csubtypep not1 not2) type1)
1362       ((csubtypep not2 not1) type2)
1363       ((eq (type-intersection not1 not2) *empty-type*)
1364        *universal-type*)
1365       (t nil))))
1366
1367 (!define-type-method (negation :complex-union2) (type1 type2)
1368   (cond
1369     ((csubtypep (negation-type-type type2) type1) *universal-type*)
1370     ((eq (type-intersection type1 (negation-type-type type2)) *empty-type*)
1371      type2)
1372     (t nil)))
1373
1374 (!define-type-method (negation :simple-=) (type1 type2)
1375   (type= (negation-type-type type1) (negation-type-type type2)))
1376
1377 (!def-type-translator not (typespec)
1378   (type-negation (specifier-type typespec)))
1379 \f
1380 ;;;; numeric types
1381
1382 (!define-type-class number)
1383
1384 (declaim (inline numeric-type-equal))
1385 (defun numeric-type-equal (type1 type2)
1386   (and (eq (numeric-type-class type1) (numeric-type-class type2))
1387        (eq (numeric-type-format type1) (numeric-type-format type2))
1388        (eq (numeric-type-complexp type1) (numeric-type-complexp type2))))
1389
1390 (!define-type-method (number :simple-=) (type1 type2)
1391   (values
1392    (and (numeric-type-equal type1 type2)
1393         (equalp (numeric-type-low type1) (numeric-type-low type2))
1394         (equalp (numeric-type-high type1) (numeric-type-high type2)))
1395    t))
1396
1397 (!define-type-method (number :negate) (type)
1398   (if (and (null (numeric-type-low type)) (null (numeric-type-high type)))
1399       (make-negation-type :type type)
1400       (type-union
1401        (make-negation-type
1402         :type (modified-numeric-type type :low nil :high nil))
1403        (cond
1404          ((null (numeric-type-low type))
1405           (modified-numeric-type
1406            type
1407            :low (let ((h (numeric-type-high type)))
1408                   (if (consp h) (car h) (list h)))
1409            :high nil))
1410          ((null (numeric-type-high type))
1411           (modified-numeric-type
1412            type
1413            :low nil
1414            :high (let ((l (numeric-type-low type)))
1415                    (if (consp l) (car l) (list l)))))
1416          (t (type-union
1417              (modified-numeric-type
1418               type
1419               :low nil
1420               :high (let ((l (numeric-type-low type)))
1421                       (if (consp l) (car l) (list l))))
1422              (modified-numeric-type
1423               type
1424               :low (let ((h (numeric-type-high type)))
1425                      (if (consp h) (car h) (list h)))
1426               :high nil)))))))
1427
1428 (!define-type-method (number :unparse) (type)
1429   (let* ((complexp (numeric-type-complexp type))
1430          (low (numeric-type-low type))
1431          (high (numeric-type-high type))
1432          (base (case (numeric-type-class type)
1433                  (integer 'integer)
1434                  (rational 'rational)
1435                  (float (or (numeric-type-format type) 'float))
1436                  (t 'real))))
1437     (let ((base+bounds
1438            (cond ((and (eq base 'integer) high low)
1439                   (let ((high-count (logcount high))
1440                         (high-length (integer-length high)))
1441                     (cond ((= low 0)
1442                            (cond ((= high 0) '(integer 0 0))
1443                                  ((= high 1) 'bit)
1444                                  ((and (= high-count high-length)
1445                                        (plusp high-length))
1446                                   `(unsigned-byte ,high-length))
1447                                  (t
1448                                   `(mod ,(1+ high)))))
1449                           ((and (= low sb!xc:most-negative-fixnum)
1450                                 (= high sb!xc:most-positive-fixnum))
1451                            'fixnum)
1452                           ((and (= low (lognot high))
1453                                 (= high-count high-length)
1454                                 (> high-count 0))
1455                            `(signed-byte ,(1+ high-length)))
1456                           (t
1457                            `(integer ,low ,high)))))
1458                  (high `(,base ,(or low '*) ,high))
1459                  (low
1460                   (if (and (eq base 'integer) (= low 0))
1461                       'unsigned-byte
1462                       `(,base ,low)))
1463                  (t base))))
1464       (ecase complexp
1465         (:real
1466          base+bounds)
1467         (:complex
1468          (aver (neq base+bounds 'real))
1469          `(complex ,base+bounds))
1470         ((nil)
1471          (aver (eq base+bounds 'real))
1472          'number)))))
1473
1474 ;;; Return true if X is "less than or equal" to Y, taking open bounds
1475 ;;; into consideration. CLOSED is the predicate used to test the bound
1476 ;;; on a closed interval (e.g. <=), and OPEN is the predicate used on
1477 ;;; open bounds (e.g. <). Y is considered to be the outside bound, in
1478 ;;; the sense that if it is infinite (NIL), then the test succeeds,
1479 ;;; whereas if X is infinite, then the test fails (unless Y is also
1480 ;;; infinite).
1481 ;;;
1482 ;;; This is for comparing bounds of the same kind, e.g. upper and
1483 ;;; upper. Use NUMERIC-BOUND-TEST* for different kinds of bounds.
1484 (defmacro numeric-bound-test (x y closed open)
1485   `(cond ((not ,y) t)
1486          ((not ,x) nil)
1487          ((consp ,x)
1488           (if (consp ,y)
1489               (,closed (car ,x) (car ,y))
1490               (,closed (car ,x) ,y)))
1491          (t
1492           (if (consp ,y)
1493               (,open ,x (car ,y))
1494               (,closed ,x ,y)))))
1495
1496 ;;; This is used to compare upper and lower bounds. This is different
1497 ;;; from the same-bound case:
1498 ;;; -- Since X = NIL is -infinity, whereas y = NIL is +infinity, we
1499 ;;;    return true if *either* arg is NIL.
1500 ;;; -- an open inner bound is "greater" and also squeezes the interval,
1501 ;;;    causing us to use the OPEN test for those cases as well.
1502 (defmacro numeric-bound-test* (x y closed open)
1503   `(cond ((not ,y) t)
1504          ((not ,x) t)
1505          ((consp ,x)
1506           (if (consp ,y)
1507               (,open (car ,x) (car ,y))
1508               (,open (car ,x) ,y)))
1509          (t
1510           (if (consp ,y)
1511               (,open ,x (car ,y))
1512               (,closed ,x ,y)))))
1513
1514 ;;; Return whichever of the numeric bounds X and Y is "maximal"
1515 ;;; according to the predicates CLOSED (e.g. >=) and OPEN (e.g. >).
1516 ;;; This is only meaningful for maximizing like bounds, i.e. upper and
1517 ;;; upper. If MAX-P is true, then we return NIL if X or Y is NIL,
1518 ;;; otherwise we return the other arg.
1519 (defmacro numeric-bound-max (x y closed open max-p)
1520   (once-only ((n-x x)
1521               (n-y y))
1522     `(cond ((not ,n-x) ,(if max-p nil n-y))
1523            ((not ,n-y) ,(if max-p nil n-x))
1524            ((consp ,n-x)
1525             (if (consp ,n-y)
1526                 (if (,closed (car ,n-x) (car ,n-y)) ,n-x ,n-y)
1527                 (if (,open (car ,n-x) ,n-y) ,n-x ,n-y)))
1528            (t
1529             (if (consp ,n-y)
1530                 (if (,open (car ,n-y) ,n-x) ,n-y ,n-x)
1531                 (if (,closed ,n-y ,n-x) ,n-y ,n-x))))))
1532
1533 (!define-type-method (number :simple-subtypep) (type1 type2)
1534   (let ((class1 (numeric-type-class type1))
1535         (class2 (numeric-type-class type2))
1536         (complexp2 (numeric-type-complexp type2))
1537         (format2 (numeric-type-format type2))
1538         (low1 (numeric-type-low type1))
1539         (high1 (numeric-type-high type1))
1540         (low2 (numeric-type-low type2))
1541         (high2 (numeric-type-high type2)))
1542     ;; If one is complex and the other isn't, they are disjoint.
1543     (cond ((not (or (eq (numeric-type-complexp type1) complexp2)
1544                     (null complexp2)))
1545            (values nil t))
1546           ;; If the classes are specified and different, the types are
1547           ;; disjoint unless type2 is RATIONAL and type1 is INTEGER.
1548           ;; [ or type1 is INTEGER and type2 is of the form (RATIONAL
1549           ;; X X) for integral X, but this is dealt with in the
1550           ;; canonicalization inside MAKE-NUMERIC-TYPE ]
1551           ((not (or (eq class1 class2)
1552                     (null class2)
1553                     (and (eq class1 'integer) (eq class2 'rational))))
1554            (values nil t))
1555           ;; If the float formats are specified and different, the types
1556           ;; are disjoint.
1557           ((not (or (eq (numeric-type-format type1) format2)
1558                     (null format2)))
1559            (values nil t))
1560           ;; Check the bounds.
1561           ((and (numeric-bound-test low1 low2 >= >)
1562                 (numeric-bound-test high1 high2 <= <))
1563            (values t t))
1564           (t
1565            (values nil t)))))
1566
1567 (!define-superclasses number ((number)) !cold-init-forms)
1568
1569 ;;; If the high bound of LOW is adjacent to the low bound of HIGH,
1570 ;;; then return true, otherwise NIL.
1571 (defun numeric-types-adjacent (low high)
1572   (let ((low-bound (numeric-type-high low))
1573         (high-bound (numeric-type-low high)))
1574     (cond ((not (and low-bound high-bound)) nil)
1575           ((and (consp low-bound) (consp high-bound)) nil)
1576           ((consp low-bound)
1577            (let ((low-value (car low-bound)))
1578              (or (eql low-value high-bound)
1579                  (and (eql low-value
1580                            (load-time-value (make-unportable-float
1581                                              :single-float-negative-zero)))
1582                       (eql high-bound 0f0))
1583                  (and (eql low-value 0f0)
1584                       (eql high-bound
1585                            (load-time-value (make-unportable-float
1586                                              :single-float-negative-zero))))
1587                  (and (eql low-value
1588                            (load-time-value (make-unportable-float
1589                                              :double-float-negative-zero)))
1590                       (eql high-bound 0d0))
1591                  (and (eql low-value 0d0)
1592                       (eql high-bound
1593                            (load-time-value (make-unportable-float
1594                                              :double-float-negative-zero)))))))
1595           ((consp high-bound)
1596            (let ((high-value (car high-bound)))
1597              (or (eql high-value low-bound)
1598                  (and (eql high-value
1599                            (load-time-value (make-unportable-float
1600                                              :single-float-negative-zero)))
1601                       (eql low-bound 0f0))
1602                  (and (eql high-value 0f0)
1603                       (eql low-bound
1604                            (load-time-value (make-unportable-float
1605                                              :single-float-negative-zero))))
1606                  (and (eql high-value
1607                            (load-time-value (make-unportable-float
1608                                              :double-float-negative-zero)))
1609                       (eql low-bound 0d0))
1610                  (and (eql high-value 0d0)
1611                       (eql low-bound
1612                            (load-time-value (make-unportable-float
1613                                              :double-float-negative-zero)))))))
1614           ((and (eq (numeric-type-class low) 'integer)
1615                 (eq (numeric-type-class high) 'integer))
1616            (eql (1+ low-bound) high-bound))
1617           (t
1618            nil))))
1619
1620 ;;; Return a numeric type that is a supertype for both TYPE1 and TYPE2.
1621 ;;;
1622 ;;; Old comment, probably no longer applicable:
1623 ;;;
1624 ;;;   ### Note: we give up early to keep from dropping lots of
1625 ;;;   information on the floor by returning overly general types.
1626 (!define-type-method (number :simple-union2) (type1 type2)
1627   (declare (type numeric-type type1 type2))
1628   (cond ((csubtypep type1 type2) type2)
1629         ((csubtypep type2 type1) type1)
1630         (t
1631          (let ((class1 (numeric-type-class type1))
1632                (format1 (numeric-type-format type1))
1633                (complexp1 (numeric-type-complexp type1))
1634                (class2 (numeric-type-class type2))
1635                (format2 (numeric-type-format type2))
1636                (complexp2 (numeric-type-complexp type2)))
1637            (cond
1638              ((and (eq class1 class2)
1639                    (eq format1 format2)
1640                    (eq complexp1 complexp2)
1641                    (or (numeric-types-intersect type1 type2)
1642                        (numeric-types-adjacent type1 type2)
1643                        (numeric-types-adjacent type2 type1)))
1644               (make-numeric-type
1645                :class class1
1646                :format format1
1647                :complexp complexp1
1648                :low (numeric-bound-max (numeric-type-low type1)
1649                                        (numeric-type-low type2)
1650                                        <= < t)
1651                :high (numeric-bound-max (numeric-type-high type1)
1652                                         (numeric-type-high type2)
1653                                         >= > t)))
1654              ;; FIXME: These two clauses are almost identical, and the
1655              ;; consequents are in fact identical in every respect.
1656              ((and (eq class1 'rational)
1657                    (eq class2 'integer)
1658                    (eq format1 format2)
1659                    (eq complexp1 complexp2)
1660                    (integerp (numeric-type-low type2))
1661                    (integerp (numeric-type-high type2))
1662                    (= (numeric-type-low type2) (numeric-type-high type2))
1663                    (or (numeric-types-adjacent type1 type2)
1664                        (numeric-types-adjacent type2 type1)))
1665               (make-numeric-type
1666                :class 'rational
1667                :format format1
1668                :complexp complexp1
1669                :low (numeric-bound-max (numeric-type-low type1)
1670                                        (numeric-type-low type2)
1671                                        <= < t)
1672                :high (numeric-bound-max (numeric-type-high type1)
1673                                         (numeric-type-high type2)
1674                                         >= > t)))
1675              ((and (eq class1 'integer)
1676                    (eq class2 'rational)
1677                    (eq format1 format2)
1678                    (eq complexp1 complexp2)
1679                    (integerp (numeric-type-low type1))
1680                    (integerp (numeric-type-high type1))
1681                    (= (numeric-type-low type1) (numeric-type-high type1))
1682                    (or (numeric-types-adjacent type1 type2)
1683                        (numeric-types-adjacent type2 type1)))
1684               (make-numeric-type
1685                :class 'rational
1686                :format format1
1687                :complexp complexp1
1688                :low (numeric-bound-max (numeric-type-low type1)
1689                                        (numeric-type-low type2)
1690                                        <= < t)
1691                :high (numeric-bound-max (numeric-type-high type1)
1692                                         (numeric-type-high type2)
1693                                         >= > t)))
1694              (t nil))))))
1695
1696
1697 (!cold-init-forms
1698   (setf (info :type :kind 'number)
1699         #+sb-xc-host :defined #-sb-xc-host :primitive)
1700   (setf (info :type :builtin 'number)
1701         (make-numeric-type :complexp nil)))
1702
1703 (!def-type-translator complex (&optional (typespec '*))
1704   (if (eq typespec '*)
1705       (specifier-type '(complex real))
1706       (labels ((not-numeric ()
1707                  (error "The component type for COMPLEX is not numeric: ~S"
1708                         typespec))
1709                (not-real ()
1710                  (error "The component type for COMPLEX is not a subtype of REAL: ~S"
1711                         typespec))
1712                (complex1 (component-type)
1713                  (unless (numeric-type-p component-type)
1714                    (not-numeric))
1715                  (when (eq (numeric-type-complexp component-type) :complex)
1716                    (not-real))
1717                  (if (csubtypep component-type (specifier-type '(eql 0)))
1718                      *empty-type*
1719                      (modified-numeric-type component-type
1720                                             :complexp :complex))))
1721         (let ((ctype (specifier-type typespec)))
1722           (cond
1723             ((eq ctype *empty-type*) *empty-type*)
1724             ((eq ctype *universal-type*) (not-real))
1725             ((typep ctype 'numeric-type) (complex1 ctype))
1726             ((typep ctype 'union-type)
1727              (apply #'type-union
1728                     ;; FIXME: This code could suffer from (admittedly
1729                     ;; very obscure) cases of bug 145 e.g. when TYPE
1730                     ;; is
1731                     ;;   (OR (AND INTEGER (SATISFIES ODDP))
1732                     ;;       (AND FLOAT (SATISFIES FOO))
1733                     ;; and not even report the problem very well.
1734                     (mapcar #'complex1 (union-type-types ctype))))
1735             ((typep ctype 'member-type)
1736              (apply #'type-union
1737                     (mapcar (lambda (x) (complex1 (ctype-of x)))
1738                             (member-type-members ctype))))
1739             ((and (typep ctype 'intersection-type)
1740                   ;; FIXME: This is very much a
1741                   ;; not-quite-worst-effort, but we are required to do
1742                   ;; something here because of our representation of
1743                   ;; RATIO as (AND RATIONAL (NOT INTEGER)): we must
1744                   ;; allow users to ask about (COMPLEX RATIO).  This
1745                   ;; will of course fail to work right on such types
1746                   ;; as (AND INTEGER (SATISFIES ZEROP))...
1747                   (let ((numbers (remove-if-not
1748                                   #'numeric-type-p
1749                                   (intersection-type-types ctype))))
1750                     (and (car numbers)
1751                          (null (cdr numbers))
1752                          (eq (numeric-type-complexp (car numbers)) :real)
1753                          (complex1 (car numbers))))))
1754             (t
1755              (multiple-value-bind (subtypep certainly)
1756                  (csubtypep ctype (specifier-type 'real))
1757                (if (and (not subtypep) certainly)
1758                    (not-real)
1759                    ;; ANSI just says that TYPESPEC is any subtype of
1760                    ;; type REAL, not necessarily a NUMERIC-TYPE. In
1761                    ;; particular, at this point TYPESPEC could legally
1762                    ;; be a hairy type like (AND NUMBER (SATISFIES
1763                    ;; REALP) (SATISFIES ZEROP)), in which case we fall
1764                    ;; through the logic above and end up here,
1765                    ;; stumped.
1766                    (bug "~@<(known bug #145): The type ~S is too hairy to be ~
1767                          used for a COMPLEX component.~:@>"
1768                         typespec)))))))))
1769
1770 ;;; If X is *, return NIL, otherwise return the bound, which must be a
1771 ;;; member of TYPE or a one-element list of a member of TYPE.
1772 #!-sb-fluid (declaim (inline canonicalized-bound))
1773 (defun canonicalized-bound (bound type)
1774   (cond ((eq bound '*) nil)
1775         ((or (sb!xc:typep bound type)
1776              (and (consp bound)
1777                   (sb!xc:typep (car bound) type)
1778                   (null (cdr bound))))
1779           bound)
1780         (t
1781          (error "Bound is not ~S, a ~S or a list of a ~S: ~S"
1782                 '*
1783                 type
1784                 type
1785                 bound))))
1786
1787 (!def-type-translator integer (&optional (low '*) (high '*))
1788   (let* ((l (canonicalized-bound low 'integer))
1789          (lb (if (consp l) (1+ (car l)) l))
1790          (h (canonicalized-bound high 'integer))
1791          (hb (if (consp h) (1- (car h)) h)))
1792     (if (and hb lb (< hb lb))
1793         *empty-type*
1794       (make-numeric-type :class 'integer
1795                          :complexp :real
1796                          :enumerable (not (null (and l h)))
1797                          :low lb
1798                          :high hb))))
1799
1800 (defmacro !def-bounded-type (type class format)
1801   `(!def-type-translator ,type (&optional (low '*) (high '*))
1802      (let ((lb (canonicalized-bound low ',type))
1803            (hb (canonicalized-bound high ',type)))
1804        (if (not (numeric-bound-test* lb hb <= <))
1805            *empty-type*
1806          (make-numeric-type :class ',class
1807                             :format ',format
1808                             :low lb
1809                             :high hb)))))
1810
1811 (!def-bounded-type rational rational nil)
1812
1813 ;;; Unlike CMU CL, we represent the types FLOAT and REAL as
1814 ;;; UNION-TYPEs of more primitive types, in order to make
1815 ;;; type representation more unique, avoiding problems in the
1816 ;;; simplification of things like
1817 ;;;   (subtypep '(or (single-float -1.0 1.0) (single-float 0.1))
1818 ;;;             '(or (real -1 7) (single-float 0.1) (single-float -1.0 1.0)))
1819 ;;; When we allowed REAL to remain as a separate NUMERIC-TYPE,
1820 ;;; it was too easy for the first argument to be simplified to
1821 ;;; '(SINGLE-FLOAT -1.0), and for the second argument to be simplified
1822 ;;; to '(OR (REAL -1 7) (SINGLE-FLOAT 0.1)) and then for the
1823 ;;; SUBTYPEP to fail (returning NIL,T instead of T,T) because
1824 ;;; the first argument can't be seen to be a subtype of any of the
1825 ;;; terms in the second argument.
1826 ;;;
1827 ;;; The old CMU CL way was:
1828 ;;;   (!def-bounded-type float float nil)
1829 ;;;   (!def-bounded-type real nil nil)
1830 ;;;
1831 ;;; FIXME: If this new way works for a while with no weird new
1832 ;;; problems, we can go back and rip out support for separate FLOAT
1833 ;;; and REAL flavors of NUMERIC-TYPE. The new way was added in
1834 ;;; sbcl-0.6.11.22, 2001-03-21.
1835 ;;;
1836 ;;; FIXME: It's probably necessary to do something to fix the
1837 ;;; analogous problem with INTEGER and RATIONAL types. Perhaps
1838 ;;; bounded RATIONAL types should be represented as (OR RATIO INTEGER).
1839 (defun coerce-bound (bound type upperp inner-coerce-bound-fun)
1840   (declare (type function inner-coerce-bound-fun))
1841   (if (eql bound '*)
1842       bound
1843       (funcall inner-coerce-bound-fun bound type upperp)))
1844 (defun inner-coerce-real-bound (bound type upperp)
1845   #+sb-xc-host (declare (ignore upperp))
1846   (let #+sb-xc-host ()
1847        #-sb-xc-host
1848        ((nl (load-time-value (symbol-value 'sb!xc:most-negative-long-float)))
1849         (pl (load-time-value (symbol-value 'sb!xc:most-positive-long-float))))
1850     (let ((nbound (if (consp bound) (car bound) bound))
1851           (consp (consp bound)))
1852       (ecase type
1853         (rational
1854          (if consp
1855              (list (rational nbound))
1856              (rational nbound)))
1857         (float
1858          (cond
1859            ((floatp nbound) bound)
1860            (t
1861             ;; Coerce to the widest float format available, to avoid
1862             ;; unnecessary loss of precision, but don't coerce
1863             ;; unrepresentable numbers, except on the host where we
1864             ;; shouldn't be making these types (but KLUDGE: can't even
1865             ;; assert portably that we're not).
1866             #-sb-xc-host
1867             (ecase upperp
1868               ((nil)
1869                (when (< nbound nl) (return-from inner-coerce-real-bound nl)))
1870               ((t)
1871                (when (> nbound pl) (return-from inner-coerce-real-bound pl))))
1872             (let ((result (coerce nbound 'long-float)))
1873               (if consp (list result) result)))))))))
1874 (defun inner-coerce-float-bound (bound type upperp)
1875   #+sb-xc-host (declare (ignore upperp))
1876   (let #+sb-xc-host ()
1877        #-sb-xc-host
1878        ((nd (load-time-value (symbol-value 'sb!xc:most-negative-double-float)))
1879         (pd (load-time-value (symbol-value 'sb!xc:most-positive-double-float)))
1880         (ns (load-time-value (symbol-value 'sb!xc:most-negative-single-float)))
1881         (ps (load-time-value
1882              (symbol-value 'sb!xc:most-positive-single-float))))
1883     (let ((nbound (if (consp bound) (car bound) bound))
1884           (consp (consp bound)))
1885       (ecase type
1886         (single-float
1887          (cond
1888            ((typep nbound 'single-float) bound)
1889            (t
1890             #-sb-xc-host
1891             (ecase upperp
1892               ((nil)
1893                (when (< nbound ns) (return-from inner-coerce-float-bound ns)))
1894               ((t)
1895                (when (> nbound ps) (return-from inner-coerce-float-bound ps))))
1896             (let ((result (coerce nbound 'single-float)))
1897               (if consp (list result) result)))))
1898         (double-float
1899          (cond
1900            ((typep nbound 'double-float) bound)
1901            (t
1902             #-sb-xc-host
1903             (ecase upperp
1904               ((nil)
1905                (when (< nbound nd) (return-from inner-coerce-float-bound nd)))
1906               ((t)
1907                (when (> nbound pd) (return-from inner-coerce-float-bound pd))))
1908             (let ((result (coerce nbound 'double-float)))
1909               (if consp (list result) result)))))))))
1910 (defun coerced-real-bound (bound type upperp)
1911   (coerce-bound bound type upperp #'inner-coerce-real-bound))
1912 (defun coerced-float-bound (bound type upperp)
1913   (coerce-bound bound type upperp #'inner-coerce-float-bound))
1914 (!def-type-translator real (&optional (low '*) (high '*))
1915   (specifier-type `(or (float ,(coerced-real-bound  low 'float nil)
1916                               ,(coerced-real-bound high 'float t))
1917                        (rational ,(coerced-real-bound  low 'rational nil)
1918                                  ,(coerced-real-bound high 'rational t)))))
1919 (!def-type-translator float (&optional (low '*) (high '*))
1920   (specifier-type
1921    `(or (single-float ,(coerced-float-bound  low 'single-float nil)
1922                       ,(coerced-float-bound high 'single-float t))
1923         (double-float ,(coerced-float-bound  low 'double-float nil)
1924                       ,(coerced-float-bound high 'double-float t))
1925         #!+long-float ,(error "stub: no long float support yet"))))
1926
1927 (defmacro !define-float-format (f)
1928   `(!def-bounded-type ,f float ,f))
1929
1930 (!define-float-format short-float)
1931 (!define-float-format single-float)
1932 (!define-float-format double-float)
1933 (!define-float-format long-float)
1934
1935 (defun numeric-types-intersect (type1 type2)
1936   (declare (type numeric-type type1 type2))
1937   (let* ((class1 (numeric-type-class type1))
1938          (class2 (numeric-type-class type2))
1939          (complexp1 (numeric-type-complexp type1))
1940          (complexp2 (numeric-type-complexp type2))
1941          (format1 (numeric-type-format type1))
1942          (format2 (numeric-type-format type2))
1943          (low1 (numeric-type-low type1))
1944          (high1 (numeric-type-high type1))
1945          (low2 (numeric-type-low type2))
1946          (high2 (numeric-type-high type2)))
1947     ;; If one is complex and the other isn't, then they are disjoint.
1948     (cond ((not (or (eq complexp1 complexp2)
1949                     (null complexp1) (null complexp2)))
1950            nil)
1951           ;; If either type is a float, then the other must either be
1952           ;; specified to be a float or unspecified. Otherwise, they
1953           ;; are disjoint.
1954           ((and (eq class1 'float)
1955                 (not (member class2 '(float nil)))) nil)
1956           ((and (eq class2 'float)
1957                 (not (member class1 '(float nil)))) nil)
1958           ;; If the float formats are specified and different, the
1959           ;; types are disjoint.
1960           ((not (or (eq format1 format2) (null format1) (null format2)))
1961            nil)
1962           (t
1963            ;; Check the bounds. This is a bit odd because we must
1964            ;; always have the outer bound of the interval as the
1965            ;; second arg.
1966            (if (numeric-bound-test high1 high2 <= <)
1967                (or (and (numeric-bound-test low1 low2 >= >)
1968                         (numeric-bound-test* low1 high2 <= <))
1969                    (and (numeric-bound-test low2 low1 >= >)
1970                         (numeric-bound-test* low2 high1 <= <)))
1971                (or (and (numeric-bound-test* low2 high1 <= <)
1972                         (numeric-bound-test low2 low1 >= >))
1973                    (and (numeric-bound-test high2 high1 <= <)
1974                         (numeric-bound-test* high2 low1 >= >))))))))
1975
1976 ;;; Take the numeric bound X and convert it into something that can be
1977 ;;; used as a bound in a numeric type with the specified CLASS and
1978 ;;; FORMAT. If UP-P is true, then we round up as needed, otherwise we
1979 ;;; round down. UP-P true implies that X is a lower bound, i.e. (N) > N.
1980 ;;;
1981 ;;; This is used by NUMERIC-TYPE-INTERSECTION to mash the bound into
1982 ;;; the appropriate type number. X may only be a float when CLASS is
1983 ;;; FLOAT.
1984 ;;;
1985 ;;; ### Note: it is possible for the coercion to a float to overflow
1986 ;;; or underflow. This happens when the bound doesn't fit in the
1987 ;;; specified format. In this case, we should really return the
1988 ;;; appropriate {Most | Least}-{Positive | Negative}-XXX-Float float
1989 ;;; of desired format. But these conditions aren't currently signalled
1990 ;;; in any useful way.
1991 ;;;
1992 ;;; Also, when converting an open rational bound into a float we
1993 ;;; should probably convert it to a closed bound of the closest float
1994 ;;; in the specified format. KLUDGE: In general, open float bounds are
1995 ;;; screwed up. -- (comment from original CMU CL)
1996 (defun round-numeric-bound (x class format up-p)
1997   (if x
1998       (let ((cx (if (consp x) (car x) x)))
1999         (ecase class
2000           ((nil rational) x)
2001           (integer
2002            (if (and (consp x) (integerp cx))
2003                (if up-p (1+ cx) (1- cx))
2004                (if up-p (ceiling cx) (floor cx))))
2005           (float
2006            (let ((res (if format (coerce cx format) (float cx))))
2007              (if (consp x) (list res) res)))))
2008       nil))
2009
2010 ;;; Handle the case of type intersection on two numeric types. We use
2011 ;;; TYPES-EQUAL-OR-INTERSECT to throw out the case of types with no
2012 ;;; intersection. If an attribute in TYPE1 is unspecified, then we use
2013 ;;; TYPE2's attribute, which must be at least as restrictive. If the
2014 ;;; types intersect, then the only attributes that can be specified
2015 ;;; and different are the class and the bounds.
2016 ;;;
2017 ;;; When the class differs, we use the more restrictive class. The
2018 ;;; only interesting case is RATIONAL/INTEGER, since RATIONAL includes
2019 ;;; INTEGER.
2020 ;;;
2021 ;;; We make the result lower (upper) bound the maximum (minimum) of
2022 ;;; the argument lower (upper) bounds. We convert the bounds into the
2023 ;;; appropriate numeric type before maximizing. This avoids possible
2024 ;;; confusion due to mixed-type comparisons (but I think the result is
2025 ;;; the same).
2026 (!define-type-method (number :simple-intersection2) (type1 type2)
2027   (declare (type numeric-type type1 type2))
2028   (if (numeric-types-intersect type1 type2)
2029       (let* ((class1 (numeric-type-class type1))
2030              (class2 (numeric-type-class type2))
2031              (class (ecase class1
2032                       ((nil) class2)
2033                       ((integer float) class1)
2034                       (rational (if (eq class2 'integer)
2035                                        'integer
2036                                        'rational))))
2037              (format (or (numeric-type-format type1)
2038                          (numeric-type-format type2))))
2039         (make-numeric-type
2040          :class class
2041          :format format
2042          :complexp (or (numeric-type-complexp type1)
2043                        (numeric-type-complexp type2))
2044          :low (numeric-bound-max
2045                (round-numeric-bound (numeric-type-low type1)
2046                                     class format t)
2047                (round-numeric-bound (numeric-type-low type2)
2048                                     class format t)
2049                > >= nil)
2050          :high (numeric-bound-max
2051                 (round-numeric-bound (numeric-type-high type1)
2052                                      class format nil)
2053                 (round-numeric-bound (numeric-type-high type2)
2054                                      class format nil)
2055                 < <= nil)))
2056       *empty-type*))
2057
2058 ;;; Given two float formats, return the one with more precision. If
2059 ;;; either one is null, return NIL.
2060 (defun float-format-max (f1 f2)
2061   (when (and f1 f2)
2062     (dolist (f *float-formats* (error "bad float format: ~S" f1))
2063       (when (or (eq f f1) (eq f f2))
2064         (return f)))))
2065
2066 ;;; Return the result of an operation on TYPE1 and TYPE2 according to
2067 ;;; the rules of numeric contagion. This is always NUMBER, some float
2068 ;;; format (possibly complex) or RATIONAL. Due to rational
2069 ;;; canonicalization, there isn't much we can do here with integers or
2070 ;;; rational complex numbers.
2071 ;;;
2072 ;;; If either argument is not a NUMERIC-TYPE, then return NUMBER. This
2073 ;;; is useful mainly for allowing types that are technically numbers,
2074 ;;; but not a NUMERIC-TYPE.
2075 (defun numeric-contagion (type1 type2)
2076   (if (and (numeric-type-p type1) (numeric-type-p type2))
2077       (let ((class1 (numeric-type-class type1))
2078             (class2 (numeric-type-class type2))
2079             (format1 (numeric-type-format type1))
2080             (format2 (numeric-type-format type2))
2081             (complexp1 (numeric-type-complexp type1))
2082             (complexp2 (numeric-type-complexp type2)))
2083         (cond ((or (null complexp1)
2084                    (null complexp2))
2085                (specifier-type 'number))
2086               ((eq class1 'float)
2087                (make-numeric-type
2088                 :class 'float
2089                 :format (ecase class2
2090                           (float (float-format-max format1 format2))
2091                           ((integer rational) format1)
2092                           ((nil)
2093                            ;; A double-float with any real number is a
2094                            ;; double-float.
2095                            #!-long-float
2096                            (if (eq format1 'double-float)
2097                              'double-float
2098                              nil)
2099                            ;; A long-float with any real number is a
2100                            ;; long-float.
2101                            #!+long-float
2102                            (if (eq format1 'long-float)
2103                              'long-float
2104                              nil)))
2105                 :complexp (if (or (eq complexp1 :complex)
2106                                   (eq complexp2 :complex))
2107                               :complex
2108                               :real)))
2109               ((eq class2 'float) (numeric-contagion type2 type1))
2110               ((and (eq complexp1 :real) (eq complexp2 :real))
2111                (make-numeric-type
2112                 :class (and class1 class2 'rational)
2113                 :complexp :real))
2114               (t
2115                (specifier-type 'number))))
2116       (specifier-type 'number)))
2117 \f
2118 ;;;; array types
2119
2120 (!define-type-class array)
2121
2122 ;;; What this does depends on the setting of the
2123 ;;; *USE-IMPLEMENTATION-TYPES* switch. If true, return the specialized
2124 ;;; element type, otherwise return the original element type.
2125 (defun specialized-element-type-maybe (type)
2126   (declare (type array-type type))
2127   (if *use-implementation-types*
2128       (array-type-specialized-element-type type)
2129       (array-type-element-type type)))
2130
2131 (!define-type-method (array :simple-=) (type1 type2)
2132   (if (or (unknown-type-p (array-type-element-type type1))
2133           (unknown-type-p (array-type-element-type type2)))
2134       (multiple-value-bind (equalp certainp)
2135           (type= (array-type-element-type type1)
2136                  (array-type-element-type type2))
2137         ;; By its nature, the call to TYPE= should never return NIL,
2138         ;; T, as we don't know what the UNKNOWN-TYPE will grow up to
2139         ;; be.  -- CSR, 2002-08-19
2140         (aver (not (and (not equalp) certainp)))
2141         (values equalp certainp))
2142       (values (and (equal (array-type-dimensions type1)
2143                           (array-type-dimensions type2))
2144                    (eq (array-type-complexp type1)
2145                        (array-type-complexp type2))
2146                    (type= (specialized-element-type-maybe type1)
2147                           (specialized-element-type-maybe type2)))
2148               t)))
2149
2150 (!define-type-method (array :negate) (type)
2151   ;; FIXME (and hint to PFD): we're vulnerable here to attacks of the
2152   ;; form "are (AND ARRAY (NOT (ARRAY T))) and (OR (ARRAY BIT) (ARRAY
2153   ;; NIL) (ARRAY CHAR) ...) equivalent?" -- CSR, 2003-12-10
2154   (make-negation-type :type type))
2155
2156 (!define-type-method (array :unparse) (type)
2157   (let ((dims (array-type-dimensions type))
2158         (eltype (type-specifier (array-type-element-type type)))
2159         (complexp (array-type-complexp type)))
2160     (cond ((eq dims '*)
2161            (if (eq eltype '*)
2162                (if complexp 'array 'simple-array)
2163                (if complexp `(array ,eltype) `(simple-array ,eltype))))
2164           ((= (length dims) 1)
2165            (if complexp
2166                (if (eq (car dims) '*)
2167                    (case eltype
2168                      (bit 'bit-vector)
2169                      ((base-char #!-sb-unicode character) 'base-string)
2170                      (* 'vector)
2171                      (t `(vector ,eltype)))
2172                    (case eltype
2173                      (bit `(bit-vector ,(car dims)))
2174                      ((base-char #!-sb-unicode character)
2175                       `(base-string ,(car dims)))
2176                      (t `(vector ,eltype ,(car dims)))))
2177                (if (eq (car dims) '*)
2178                    (case eltype
2179                      (bit 'simple-bit-vector)
2180                      ((base-char #!-sb-unicode character) 'simple-base-string)
2181                      ((t) 'simple-vector)
2182                      (t `(simple-array ,eltype (*))))
2183                    (case eltype
2184                      (bit `(simple-bit-vector ,(car dims)))
2185                      ((base-char #!-sb-unicode character)
2186                       `(simple-base-string ,(car dims)))
2187                      ((t) `(simple-vector ,(car dims)))
2188                      (t `(simple-array ,eltype ,dims))))))
2189           (t
2190            (if complexp
2191                `(array ,eltype ,dims)
2192                `(simple-array ,eltype ,dims))))))
2193
2194 (!define-type-method (array :simple-subtypep) (type1 type2)
2195   (let ((dims1 (array-type-dimensions type1))
2196         (dims2 (array-type-dimensions type2))
2197         (complexp2 (array-type-complexp type2)))
2198     (cond (;; not subtypep unless dimensions are compatible
2199            (not (or (eq dims2 '*)
2200                     (and (not (eq dims1 '*))
2201                          ;; (sbcl-0.6.4 has trouble figuring out that
2202                          ;; DIMS1 and DIMS2 must be lists at this
2203                          ;; point, and knowing that is important to
2204                          ;; compiling EVERY efficiently.)
2205                          (= (length (the list dims1))
2206                             (length (the list dims2)))
2207                          (every (lambda (x y)
2208                                   (or (eq y '*) (eql x y)))
2209                                 (the list dims1)
2210                                 (the list dims2)))))
2211            (values nil t))
2212           ;; not subtypep unless complexness is compatible
2213           ((not (or (eq complexp2 :maybe)
2214                     (eq (array-type-complexp type1) complexp2)))
2215            (values nil t))
2216           ;; Since we didn't fail any of the tests above, we win
2217           ;; if the TYPE2 element type is wild.
2218           ((eq (array-type-element-type type2) *wild-type*)
2219            (values t t))
2220           (;; Since we didn't match any of the special cases above, we
2221            ;; can't give a good answer unless both the element types
2222            ;; have been defined.
2223            (or (unknown-type-p (array-type-element-type type1))
2224                (unknown-type-p (array-type-element-type type2)))
2225            (values nil nil))
2226           (;; Otherwise, the subtype relationship holds iff the
2227            ;; types are equal, and they're equal iff the specialized
2228            ;; element types are identical.
2229            t
2230            (values (type= (specialized-element-type-maybe type1)
2231                           (specialized-element-type-maybe type2))
2232                    t)))))
2233
2234 ;;; FIXME: is this dead?
2235 (!define-superclasses array
2236   ((base-string base-string)
2237    (vector vector)
2238    (array))
2239   !cold-init-forms)
2240
2241 (defun array-types-intersect (type1 type2)
2242   (declare (type array-type type1 type2))
2243   (let ((dims1 (array-type-dimensions type1))
2244         (dims2 (array-type-dimensions type2))
2245         (complexp1 (array-type-complexp type1))
2246         (complexp2 (array-type-complexp type2)))
2247     ;; See whether dimensions are compatible.
2248     (cond ((not (or (eq dims1 '*) (eq dims2 '*)
2249                     (and (= (length dims1) (length dims2))
2250                          (every (lambda (x y)
2251                                   (or (eq x '*) (eq y '*) (= x y)))
2252                                 dims1 dims2))))
2253            (values nil t))
2254           ;; See whether complexpness is compatible.
2255           ((not (or (eq complexp1 :maybe)
2256                     (eq complexp2 :maybe)
2257                     (eq complexp1 complexp2)))
2258            (values nil t))
2259           ;; Old comment:
2260           ;;
2261           ;;   If either element type is wild, then they intersect.
2262           ;;   Otherwise, the types must be identical.
2263           ;;
2264           ;; FIXME: There seems to have been a fair amount of
2265           ;; confusion about the distinction between requested element
2266           ;; type and specialized element type; here is one of
2267           ;; them. If we request an array to hold objects of an
2268           ;; unknown type, we can do no better than represent that
2269           ;; type as an array specialized on wild-type.  We keep the
2270           ;; requested element-type in the -ELEMENT-TYPE slot, and
2271           ;; *WILD-TYPE* in the -SPECIALIZED-ELEMENT-TYPE.  So, here,
2272           ;; we must test for the SPECIALIZED slot being *WILD-TYPE*,
2273           ;; not just the ELEMENT-TYPE slot.  Maybe the return value
2274           ;; in that specific case should be T, NIL?  Or maybe this
2275           ;; function should really be called
2276           ;; ARRAY-TYPES-COULD-POSSIBLY-INTERSECT?  In any case, this
2277           ;; was responsible for bug #123, and this whole issue could
2278           ;; do with a rethink and/or a rewrite.  -- CSR, 2002-08-21
2279           ((or (eq (array-type-specialized-element-type type1) *wild-type*)
2280                (eq (array-type-specialized-element-type type2) *wild-type*)
2281                (type= (specialized-element-type-maybe type1)
2282                       (specialized-element-type-maybe type2)))
2283
2284            (values t t))
2285           (t
2286            (values nil t)))))
2287
2288 (!define-type-method (array :simple-intersection2) (type1 type2)
2289   (declare (type array-type type1 type2))
2290   (if (array-types-intersect type1 type2)
2291       (let ((dims1 (array-type-dimensions type1))
2292             (dims2 (array-type-dimensions type2))
2293             (complexp1 (array-type-complexp type1))
2294             (complexp2 (array-type-complexp type2))
2295             (eltype1 (array-type-element-type type1))
2296             (eltype2 (array-type-element-type type2)))
2297         (specialize-array-type
2298          (make-array-type
2299           :dimensions (cond ((eq dims1 '*) dims2)
2300                             ((eq dims2 '*) dims1)
2301                             (t
2302                              (mapcar (lambda (x y) (if (eq x '*) y x))
2303                                      dims1 dims2)))
2304           :complexp (if (eq complexp1 :maybe) complexp2 complexp1)
2305           :element-type (cond
2306                           ((eq eltype1 *wild-type*) eltype2)
2307                           ((eq eltype2 *wild-type*) eltype1)
2308                           (t (type-intersection eltype1 eltype2))))))
2309       *empty-type*))
2310
2311 ;;; Check a supplied dimension list to determine whether it is legal,
2312 ;;; and return it in canonical form (as either '* or a list).
2313 (defun canonical-array-dimensions (dims)
2314   (typecase dims
2315     ((member *) dims)
2316     (integer
2317      (when (minusp dims)
2318        (error "Arrays can't have a negative number of dimensions: ~S" dims))
2319      (when (>= dims sb!xc:array-rank-limit)
2320        (error "array type with too many dimensions: ~S" dims))
2321      (make-list dims :initial-element '*))
2322     (list
2323      (when (>= (length dims) sb!xc:array-rank-limit)
2324        (error "array type with too many dimensions: ~S" dims))
2325      (dolist (dim dims)
2326        (unless (eq dim '*)
2327          (unless (and (integerp dim)
2328                       (>= dim 0)
2329                       (< dim sb!xc:array-dimension-limit))
2330            (error "bad dimension in array type: ~S" dim))))
2331      dims)
2332     (t
2333      (error "Array dimensions is not a list, integer or *:~%  ~S" dims))))
2334 \f
2335 ;;;; MEMBER types
2336
2337 (!define-type-class member)
2338
2339 (!define-type-method (member :negate) (type)
2340   (let ((members (member-type-members type)))
2341     (if (some #'floatp members)
2342         (let (floats)
2343           (dolist (pair `((0.0f0 . ,(load-time-value (make-unportable-float :single-float-negative-zero)))
2344                           (0.0d0 . ,(load-time-value (make-unportable-float :double-float-negative-zero)))
2345                           #!+long-float
2346                           (0.0l0 . ,(load-time-value (make-unportable-float :long-float-negative-zero)))))
2347             (when (member (car pair) members)
2348               (aver (not (member (cdr pair) members)))
2349               (push (cdr pair) floats)
2350               (setf members (remove (car pair) members)))
2351             (when (member (cdr pair) members)
2352               (aver (not (member (car pair) members)))
2353               (push (car pair) floats)
2354               (setf members (remove (cdr pair) members))))
2355           (apply #'type-intersection
2356                  (if (null members)
2357                      *universal-type*
2358                      (make-negation-type
2359                       :type (make-member-type :members members)))
2360                  (mapcar
2361                   (lambda (x)
2362                     (let ((type (ctype-of x)))
2363                       (type-union
2364                        (make-negation-type
2365                         :type (modified-numeric-type type
2366                                                      :low nil :high nil))
2367                        (modified-numeric-type type
2368                                               :low nil :high (list x))
2369                        (make-member-type :members (list x))
2370                        (modified-numeric-type type
2371                                               :low (list x) :high nil))))
2372                   floats)))
2373         (make-negation-type :type type))))
2374
2375 (!define-type-method (member :unparse) (type)
2376   (let ((members (member-type-members type)))
2377     (cond
2378       ((equal members '(nil)) 'null)
2379       ((type= type (specifier-type 'standard-char)) 'standard-char)
2380       (t `(member ,@members)))))
2381
2382 (!define-type-method (member :simple-subtypep) (type1 type2)
2383   (values (subsetp (member-type-members type1) (member-type-members type2))
2384           t))
2385
2386 (!define-type-method (member :complex-subtypep-arg1) (type1 type2)
2387   (every/type (swapped-args-fun #'ctypep)
2388               type2
2389               (member-type-members type1)))
2390
2391 ;;; We punt if the odd type is enumerable and intersects with the
2392 ;;; MEMBER type. If not enumerable, then it is definitely not a
2393 ;;; subtype of the MEMBER type.
2394 (!define-type-method (member :complex-subtypep-arg2) (type1 type2)
2395   (cond ((not (type-enumerable type1)) (values nil t))
2396         ((types-equal-or-intersect type1 type2)
2397          (invoke-complex-subtypep-arg1-method type1 type2))
2398         (t (values nil t))))
2399
2400 (!define-type-method (member :simple-intersection2) (type1 type2)
2401   (let ((mem1 (member-type-members type1))
2402         (mem2 (member-type-members type2)))
2403     (cond ((subsetp mem1 mem2) type1)
2404           ((subsetp mem2 mem1) type2)
2405           (t
2406            (let ((res (intersection mem1 mem2)))
2407              (if res
2408                  (make-member-type :members res)
2409                  *empty-type*))))))
2410
2411 (!define-type-method (member :complex-intersection2) (type1 type2)
2412   (block punt
2413     (collect ((members))
2414       (let ((mem2 (member-type-members type2)))
2415         (dolist (member mem2)
2416           (multiple-value-bind (val win) (ctypep member type1)
2417             (unless win
2418               (return-from punt nil))
2419             (when val (members member))))
2420         (cond ((subsetp mem2 (members)) type2)
2421               ((null (members)) *empty-type*)
2422               (t
2423                (make-member-type :members (members))))))))
2424
2425 ;;; We don't need a :COMPLEX-UNION2, since the only interesting case is
2426 ;;; a union type, and the member/union interaction is handled by the
2427 ;;; union type method.
2428 (!define-type-method (member :simple-union2) (type1 type2)
2429   (let ((mem1 (member-type-members type1))
2430         (mem2 (member-type-members type2)))
2431     (cond ((subsetp mem1 mem2) type2)
2432           ((subsetp mem2 mem1) type1)
2433           (t
2434            (make-member-type :members (union mem1 mem2))))))
2435
2436 (!define-type-method (member :simple-=) (type1 type2)
2437   (let ((mem1 (member-type-members type1))
2438         (mem2 (member-type-members type2)))
2439     (values (and (subsetp mem1 mem2)
2440                  (subsetp mem2 mem1))
2441             t)))
2442
2443 (!define-type-method (member :complex-=) (type1 type2)
2444   (if (type-enumerable type1)
2445       (multiple-value-bind (val win) (csubtypep type2 type1)
2446         (if (or val (not win))
2447             (values nil nil)
2448             (values nil t)))
2449       (values nil t)))
2450
2451 (!def-type-translator member (&rest members)
2452   (if members
2453       (let (ms numbers char-codes)
2454         (dolist (m (remove-duplicates members))
2455           (typecase m
2456             (float (if (zerop m)
2457                        (push m ms)
2458                        (push (ctype-of m) numbers)))
2459             (real (push (ctype-of m) numbers))
2460            (character (push (sb!xc:char-code m) char-codes))
2461             (t (push m ms))))
2462         (apply #'type-union
2463                (if ms
2464                    (make-member-type :members ms)
2465                    *empty-type*)
2466               (if char-codes
2467                   (make-character-set-type
2468                    :pairs (mapcar (lambda (x) (cons x x))
2469                                   (sort char-codes #'<)))
2470                   *empty-type*)
2471                (nreverse numbers)))
2472       *empty-type*))
2473 \f
2474 ;;;; intersection types
2475 ;;;;
2476 ;;;; Until version 0.6.10.6, SBCL followed the original CMU CL approach
2477 ;;;; of punting on all AND types, not just the unreasonably complicated
2478 ;;;; ones. The change was motivated by trying to get the KEYWORD type
2479 ;;;; to behave sensibly:
2480 ;;;;    ;; reasonable definition
2481 ;;;;    (DEFTYPE KEYWORD () '(AND SYMBOL (SATISFIES KEYWORDP)))
2482 ;;;;    ;; reasonable behavior
2483 ;;;;    (AVER (SUBTYPEP 'KEYWORD 'SYMBOL))
2484 ;;;; Without understanding a little about the semantics of AND, we'd
2485 ;;;; get (SUBTYPEP 'KEYWORD 'SYMBOL)=>NIL,NIL and, for entirely
2486 ;;;; parallel reasons, (SUBTYPEP 'RATIO 'NUMBER)=>NIL,NIL. That's
2487 ;;;; not so good..)
2488 ;;;;
2489 ;;;; We still follow the example of CMU CL to some extent, by punting
2490 ;;;; (to the opaque HAIRY-TYPE) on sufficiently complicated types
2491 ;;;; involving AND.
2492
2493 (!define-type-class intersection)
2494
2495 (!define-type-method (intersection :negate) (type)
2496   (apply #'type-union
2497          (mapcar #'type-negation (intersection-type-types type))))
2498
2499 ;;; A few intersection types have special names. The others just get
2500 ;;; mechanically unparsed.
2501 (!define-type-method (intersection :unparse) (type)
2502   (declare (type ctype type))
2503   (or (find type '(ratio keyword) :key #'specifier-type :test #'type=)
2504       `(and ,@(mapcar #'type-specifier (intersection-type-types type)))))
2505
2506 ;;; shared machinery for type equality: true if every type in the set
2507 ;;; TYPES1 matches a type in the set TYPES2 and vice versa
2508 (defun type=-set (types1 types2)
2509   (flet ((type<=-set (x y)
2510            (declare (type list x y))
2511            (every/type (lambda (x y-element)
2512                          (any/type #'type= y-element x))
2513                        x y)))
2514     (and/type (type<=-set types1 types2)
2515               (type<=-set types2 types1))))
2516
2517 ;;; Two intersection types are equal if their subtypes are equal sets.
2518 ;;;
2519 ;;; FIXME: Might it be better to use
2520 ;;;   (AND (SUBTYPEP X Y) (SUBTYPEP Y X))
2521 ;;; instead, since SUBTYPEP is the usual relationship that we care
2522 ;;; most about, so it would be good to leverage any ingenuity there
2523 ;;; in this more obscure method?
2524 (!define-type-method (intersection :simple-=) (type1 type2)
2525   (type=-set (intersection-type-types type1)
2526              (intersection-type-types type2)))
2527
2528 (defun %intersection-complex-subtypep-arg1 (type1 type2)
2529   (type= type1 (type-intersection type1 type2)))
2530
2531 (defun %intersection-simple-subtypep (type1 type2)
2532   (every/type #'%intersection-complex-subtypep-arg1
2533               type1
2534               (intersection-type-types type2)))
2535
2536 (!define-type-method (intersection :simple-subtypep) (type1 type2)
2537   (%intersection-simple-subtypep type1 type2))
2538
2539 (!define-type-method (intersection :complex-subtypep-arg1) (type1 type2)
2540   (%intersection-complex-subtypep-arg1 type1 type2))
2541
2542 (defun %intersection-complex-subtypep-arg2 (type1 type2)
2543   (every/type #'csubtypep type1 (intersection-type-types type2)))
2544
2545 (!define-type-method (intersection :complex-subtypep-arg2) (type1 type2)
2546   (%intersection-complex-subtypep-arg2 type1 type2))
2547
2548 ;;; FIXME: This will look eeriely familiar to readers of the UNION
2549 ;;; :SIMPLE-INTERSECTION2 :COMPLEX-INTERSECTION2 method.  That's
2550 ;;; because it was generated by cut'n'paste methods.  Given that
2551 ;;; intersections and unions have all sorts of symmetries known to
2552 ;;; mathematics, it shouldn't be beyond the ken of some programmers to
2553 ;;; reflect those symmetries in code in a way that ties them together
2554 ;;; more strongly than having two independent near-copies :-/
2555 (!define-type-method (intersection :simple-union2 :complex-union2)
2556                      (type1 type2)
2557   ;; Within this method, type2 is guaranteed to be an intersection
2558   ;; type:
2559   (aver (intersection-type-p type2))
2560   ;; Make sure to call only the applicable methods...
2561   (cond ((and (intersection-type-p type1)
2562               (%intersection-simple-subtypep type1 type2)) type2)
2563         ((and (intersection-type-p type1)
2564               (%intersection-simple-subtypep type2 type1)) type1)
2565         ((and (not (intersection-type-p type1))
2566               (%intersection-complex-subtypep-arg2 type1 type2))
2567          type2)
2568         ((and (not (intersection-type-p type1))
2569               (%intersection-complex-subtypep-arg1 type2 type1))
2570          type1)
2571         ;; KLUDGE: This special (and somewhat hairy) magic is required
2572         ;; to deal with the RATIONAL/INTEGER special case.  The UNION
2573         ;; of (INTEGER * -1) and (AND (RATIONAL * -1/2) (NOT INTEGER))
2574         ;; should be (RATIONAL * -1/2) -- CSR, 2003-02-28
2575         ((and (csubtypep type2 (specifier-type 'ratio))
2576               (numeric-type-p type1)
2577               (csubtypep type1 (specifier-type 'integer))
2578               (csubtypep type2
2579                          (make-numeric-type
2580                           :class 'rational
2581                           :complexp nil
2582                           :low (if (null (numeric-type-low type1))
2583                                    nil
2584                                    (list (1- (numeric-type-low type1))))
2585                           :high (if (null (numeric-type-high type1))
2586                                     nil
2587                                     (list (1+ (numeric-type-high type1)))))))
2588          (type-union type1
2589                      (apply #'type-intersection
2590                             (remove (specifier-type '(not integer))
2591                                     (intersection-type-types type2)
2592                                     :test #'type=))))
2593         (t
2594          (let ((accumulator *universal-type*))
2595            (do ((t2s (intersection-type-types type2) (cdr t2s)))
2596                ((null t2s) accumulator)
2597              (let ((union (type-union type1 (car t2s))))
2598                (when (union-type-p union)
2599                  ;; we have to give up here -- there are all sorts of
2600                  ;; ordering worries, but it's better than before.
2601                  ;; Doing exactly the same as in the UNION
2602                  ;; :SIMPLE/:COMPLEX-INTERSECTION2 method causes stack
2603                  ;; overflow with the mutual recursion never bottoming
2604                  ;; out.
2605                  (if (and (eq accumulator *universal-type*)
2606                           (null (cdr t2s)))
2607                      ;; KLUDGE: if we get here, we have a partially
2608                      ;; simplified result.  While this isn't by any
2609                      ;; means a universal simplification, including
2610                      ;; this logic here means that we can get (OR
2611                      ;; KEYWORD (NOT KEYWORD)) canonicalized to T.
2612                      (return union)
2613                      (return nil)))
2614                (setf accumulator
2615                      (type-intersection accumulator union))))))))
2616
2617 (!def-type-translator and (&whole whole &rest type-specifiers)
2618   (apply #'type-intersection
2619          (mapcar #'specifier-type type-specifiers)))
2620 \f
2621 ;;;; union types
2622
2623 (!define-type-class union)
2624
2625 (!define-type-method (union :negate) (type)
2626   (declare (type ctype type))
2627   (apply #'type-intersection
2628          (mapcar #'type-negation (union-type-types type))))
2629
2630 ;;; The LIST, FLOAT and REAL types have special names.  Other union
2631 ;;; types just get mechanically unparsed.
2632 (!define-type-method (union :unparse) (type)
2633   (declare (type ctype type))
2634   (cond
2635     ((type= type (specifier-type 'list)) 'list)
2636     ((type= type (specifier-type 'float)) 'float)
2637     ((type= type (specifier-type 'real)) 'real)
2638     ((type= type (specifier-type 'sequence)) 'sequence)
2639     ((type= type (specifier-type 'bignum)) 'bignum)
2640     ((type= type (specifier-type 'simple-string)) 'simple-string)
2641     ((type= type (specifier-type 'string)) 'string)
2642     ((type= type (specifier-type 'complex)) 'complex)
2643     ((type= type (specifier-type 'standard-char)) 'standard-char)
2644     (t `(or ,@(mapcar #'type-specifier (union-type-types type))))))
2645
2646 ;;; Two union types are equal if they are each subtypes of each
2647 ;;; other. We need to be this clever because our complex subtypep
2648 ;;; methods are now more accurate; we don't get infinite recursion
2649 ;;; because the simple-subtypep method delegates to complex-subtypep
2650 ;;; of the individual types of type1. - CSR, 2002-04-09
2651 ;;;
2652 ;;; Previous comment, now obsolete, but worth keeping around because
2653 ;;; it is true, though too strong a condition:
2654 ;;;
2655 ;;; Two union types are equal if their subtypes are equal sets.
2656 (!define-type-method (union :simple-=) (type1 type2)
2657   (multiple-value-bind (subtype certain?)
2658       (csubtypep type1 type2)
2659     (if subtype
2660         (csubtypep type2 type1)
2661         ;; we might as well become as certain as possible.
2662         (if certain?
2663             (values nil t)
2664             (multiple-value-bind (subtype certain?)
2665                 (csubtypep type2 type1)
2666               (declare (ignore subtype))
2667               (values nil certain?))))))
2668
2669 (!define-type-method (union :complex-=) (type1 type2)
2670   (declare (ignore type1))
2671   (if (some #'type-might-contain-other-types-p
2672             (union-type-types type2))
2673       (values nil nil)
2674       (values nil t)))
2675
2676 ;;; Similarly, a union type is a subtype of another if and only if
2677 ;;; every element of TYPE1 is a subtype of TYPE2.
2678 (defun union-simple-subtypep (type1 type2)
2679   (every/type (swapped-args-fun #'union-complex-subtypep-arg2)
2680               type2
2681               (union-type-types type1)))
2682
2683 (!define-type-method (union :simple-subtypep) (type1 type2)
2684   (union-simple-subtypep type1 type2))
2685
2686 (defun union-complex-subtypep-arg1 (type1 type2)
2687   (every/type (swapped-args-fun #'csubtypep)
2688               type2
2689               (union-type-types type1)))
2690
2691 (!define-type-method (union :complex-subtypep-arg1) (type1 type2)
2692   (union-complex-subtypep-arg1 type1 type2))
2693
2694 (defun union-complex-subtypep-arg2 (type1 type2)
2695   (multiple-value-bind (sub-value sub-certain?)
2696       ;; was: (any/type #'csubtypep type1 (union-type-types type2)),
2697       ;; which turns out to be too restrictive, causing bug 91.
2698       ;;
2699       ;; the following reimplementation might look dodgy.  It is
2700       ;; dodgy. It depends on the union :complex-= method not doing
2701       ;; very much work -- certainly, not using subtypep. Reasoning:
2702       (progn
2703         ;; At this stage, we know that type2 is a union type and type1
2704         ;; isn't. We might as well check this, though:
2705         (aver (union-type-p type2))
2706         (aver (not (union-type-p type1)))
2707         ;;     A is a subset of (B1 u B2)
2708         ;; <=> A n (B1 u B2) = A
2709         ;; <=> (A n B1) u (A n B2) = A
2710         ;;
2711         ;; But, we have to be careful not to delegate this type= to
2712         ;; something that could invoke subtypep, which might get us
2713         ;; back here -> stack explosion. We therefore ensure that the
2714         ;; second type (which is the one that's dispatched on) is
2715         ;; either a union type (where we've ensured that the complex-=
2716         ;; method will not call subtypep) or something with no union
2717         ;; types involved, in which case we'll never come back here.
2718         ;;
2719         ;; If we don't do this, then e.g.
2720         ;; (SUBTYPEP '(MEMBER 3) '(OR (SATISFIES FOO) (SATISFIES BAR)))
2721         ;; would loop infinitely, as the member :complex-= method is
2722         ;; implemented in terms of subtypep.
2723         ;;
2724         ;; Ouch. - CSR, 2002-04-10
2725         (type= type1
2726                (apply #'type-union
2727                       (mapcar (lambda (x) (type-intersection type1 x))
2728                               (union-type-types type2)))))
2729     (if sub-certain?
2730         (values sub-value sub-certain?)
2731         ;; The ANY/TYPE expression above is a sufficient condition for
2732         ;; subsetness, but not a necessary one, so we might get a more
2733         ;; certain answer by this CALL-NEXT-METHOD-ish step when the
2734         ;; ANY/TYPE expression is uncertain.
2735         (invoke-complex-subtypep-arg1-method type1 type2))))
2736
2737 (!define-type-method (union :complex-subtypep-arg2) (type1 type2)
2738   (union-complex-subtypep-arg2 type1 type2))
2739
2740 (!define-type-method (union :simple-intersection2 :complex-intersection2)
2741                      (type1 type2)
2742   ;; The CSUBTYPEP clauses here let us simplify e.g.
2743   ;;   (TYPE-INTERSECTION2 (SPECIFIER-TYPE 'LIST)
2744   ;;                       (SPECIFIER-TYPE '(OR LIST VECTOR)))
2745   ;; (where LIST is (OR CONS NULL)).
2746   ;;
2747   ;; The tests are more or less (CSUBTYPEP TYPE1 TYPE2) and vice
2748   ;; versa, but it's important that we pre-expand them into
2749   ;; specialized operations on individual elements of
2750   ;; UNION-TYPE-TYPES, instead of using the ordinary call to
2751   ;; CSUBTYPEP, in order to avoid possibly invoking any methods which
2752   ;; might in turn invoke (TYPE-INTERSECTION2 TYPE1 TYPE2) and thus
2753   ;; cause infinite recursion.
2754   ;;
2755   ;; Within this method, type2 is guaranteed to be a union type:
2756   (aver (union-type-p type2))
2757   ;; Make sure to call only the applicable methods...
2758   (cond ((and (union-type-p type1)
2759               (union-simple-subtypep type1 type2)) type1)
2760         ((and (union-type-p type1)
2761               (union-simple-subtypep type2 type1)) type2)
2762         ((and (not (union-type-p type1))
2763               (union-complex-subtypep-arg2 type1 type2))
2764          type1)
2765         ((and (not (union-type-p type1))
2766               (union-complex-subtypep-arg1 type2 type1))
2767          type2)
2768         (t
2769          ;; KLUDGE: This code accumulates a sequence of TYPE-UNION2
2770          ;; operations in a particular order, and gives up if any of
2771          ;; the sub-unions turn out not to be simple. In other cases
2772          ;; ca. sbcl-0.6.11.15, that approach to taking a union was a
2773          ;; bad idea, since it can overlook simplifications which
2774          ;; might occur if the terms were accumulated in a different
2775          ;; order. It's possible that that will be a problem here too.
2776          ;; However, I can't think of a good example to demonstrate
2777          ;; it, and without an example to demonstrate it I can't write
2778          ;; test cases, and without test cases I don't want to
2779          ;; complicate the code to address what's still a hypothetical
2780          ;; problem. So I punted. -- WHN 2001-03-20
2781          (let ((accumulator *empty-type*))
2782            (dolist (t2 (union-type-types type2) accumulator)
2783              (setf accumulator
2784                    (type-union accumulator
2785                                (type-intersection type1 t2))))))))
2786
2787 (!def-type-translator or (&rest type-specifiers)
2788   (apply #'type-union
2789          (mapcar #'specifier-type
2790                  type-specifiers)))
2791 \f
2792 ;;;; CONS types
2793
2794 (!define-type-class cons)
2795
2796 (!def-type-translator cons (&optional (car-type-spec '*) (cdr-type-spec '*))
2797   (let ((car-type (single-value-specifier-type car-type-spec))
2798         (cdr-type (single-value-specifier-type cdr-type-spec)))
2799     (make-cons-type car-type cdr-type)))
2800
2801 (!define-type-method (cons :negate) (type)
2802   (if (and (eq (cons-type-car-type type) *universal-type*)
2803            (eq (cons-type-cdr-type type) *universal-type*))
2804       (make-negation-type :type type)
2805       (type-union
2806        (make-negation-type :type (specifier-type 'cons))
2807        (cond
2808          ((and (not (eq (cons-type-car-type type) *universal-type*))
2809                (not (eq (cons-type-cdr-type type) *universal-type*)))
2810           (type-union
2811            (make-cons-type
2812             (type-negation (cons-type-car-type type))
2813             *universal-type*)
2814            (make-cons-type
2815             *universal-type*
2816             (type-negation (cons-type-cdr-type type)))))
2817          ((not (eq (cons-type-car-type type) *universal-type*))
2818           (make-cons-type
2819            (type-negation (cons-type-car-type type))
2820            *universal-type*))
2821          ((not (eq (cons-type-cdr-type type) *universal-type*))
2822           (make-cons-type
2823            *universal-type*
2824            (type-negation (cons-type-cdr-type type))))
2825          (t (bug "Weird CONS type ~S" type))))))
2826
2827 (!define-type-method (cons :unparse) (type)
2828   (let ((car-eltype (type-specifier (cons-type-car-type type)))
2829         (cdr-eltype (type-specifier (cons-type-cdr-type type))))
2830     (if (and (member car-eltype '(t *))
2831              (member cdr-eltype '(t *)))
2832         'cons
2833         `(cons ,car-eltype ,cdr-eltype))))
2834
2835 (!define-type-method (cons :simple-=) (type1 type2)
2836   (declare (type cons-type type1 type2))
2837   (and (type= (cons-type-car-type type1) (cons-type-car-type type2))
2838        (type= (cons-type-cdr-type type1) (cons-type-cdr-type type2))))
2839
2840 (!define-type-method (cons :simple-subtypep) (type1 type2)
2841   (declare (type cons-type type1 type2))
2842   (multiple-value-bind (val-car win-car)
2843       (csubtypep (cons-type-car-type type1) (cons-type-car-type type2))
2844     (multiple-value-bind (val-cdr win-cdr)
2845         (csubtypep (cons-type-cdr-type type1) (cons-type-cdr-type type2))
2846       (if (and val-car val-cdr)
2847           (values t (and win-car win-cdr))
2848           (values nil (or win-car win-cdr))))))
2849
2850 ;;; Give up if a precise type is not possible, to avoid returning
2851 ;;; overly general types.
2852 (!define-type-method (cons :simple-union2) (type1 type2)
2853   (declare (type cons-type type1 type2))
2854   (let ((car-type1 (cons-type-car-type type1))
2855         (car-type2 (cons-type-car-type type2))
2856         (cdr-type1 (cons-type-cdr-type type1))
2857         (cdr-type2 (cons-type-cdr-type type2))
2858         car-not1
2859         car-not2)
2860     ;; UGH.  -- CSR, 2003-02-24
2861     (macrolet ((frob-car (car1 car2 cdr1 cdr2
2862                           &optional (not1 nil not1p))
2863                  `(type-union
2864                    (make-cons-type ,car1 (type-union ,cdr1 ,cdr2))
2865                    (make-cons-type
2866                     (type-intersection ,car2
2867                      ,(if not1p
2868                           not1
2869                           `(type-negation ,car1)))
2870                     ,cdr2))))
2871       (cond ((type= car-type1 car-type2)
2872              (make-cons-type car-type1
2873                              (type-union cdr-type1 cdr-type2)))
2874             ((type= cdr-type1 cdr-type2)
2875              (make-cons-type (type-union car-type1 car-type2)
2876                              cdr-type1))
2877             ((csubtypep car-type1 car-type2)
2878              (frob-car car-type1 car-type2 cdr-type1 cdr-type2))
2879             ((csubtypep car-type2 car-type1)
2880              (frob-car car-type2 car-type1 cdr-type2 cdr-type1))
2881             ;; more general case of the above, but harder to compute
2882             ((progn
2883                (setf car-not1 (type-negation car-type1))
2884                (not (csubtypep car-type2 car-not1)))
2885              (frob-car car-type1 car-type2 cdr-type1 cdr-type2 car-not1))
2886             ((progn
2887                (setf car-not2 (type-negation car-type2))
2888                (not (csubtypep car-type1 car-not2)))
2889              (frob-car car-type2 car-type1 cdr-type2 cdr-type1 car-not2))
2890             ;; Don't put these in -- consider the effect of taking the
2891             ;; union of (CONS (INTEGER 0 2) (INTEGER 5 7)) and
2892             ;; (CONS (INTEGER 0 3) (INTEGER 5 6)).
2893             #+nil
2894             ((csubtypep cdr-type1 cdr-type2)
2895              (frob-cdr car-type1 car-type2 cdr-type1 cdr-type2))
2896             #+nil
2897             ((csubtypep cdr-type2 cdr-type1)
2898              (frob-cdr car-type2 car-type1 cdr-type2 cdr-type1))))))
2899
2900 (!define-type-method (cons :simple-intersection2) (type1 type2)
2901   (declare (type cons-type type1 type2))
2902   (let ((car-int2 (type-intersection2 (cons-type-car-type type1)
2903                                       (cons-type-car-type type2)))
2904         (cdr-int2 (type-intersection2 (cons-type-cdr-type type1)
2905                                       (cons-type-cdr-type type2))))
2906     (cond
2907       ((and car-int2 cdr-int2) (make-cons-type car-int2 cdr-int2))
2908       (car-int2 (make-cons-type car-int2
2909                                 (type-intersection
2910                                  (cons-type-cdr-type type1)
2911                                  (cons-type-cdr-type type2))))
2912       (cdr-int2 (make-cons-type
2913                  (type-intersection (cons-type-car-type type1)
2914                                     (cons-type-car-type type2))
2915                  cdr-int2)))))
2916 \f
2917 ;;;; CHARACTER-SET types
2918
2919 (!define-type-class character-set)
2920
2921 (!def-type-translator character-set
2922     (&optional (pairs '((0 . #.(1- sb!xc:char-code-limit)))))
2923   (make-character-set-type :pairs pairs))
2924
2925 (!define-type-method (character-set :negate) (type)
2926   (let ((pairs (character-set-type-pairs type)))
2927     (if (and (= (length pairs) 1)
2928             (= (caar pairs) 0)
2929             (= (cdar pairs) (1- sb!xc:char-code-limit)))
2930        (make-negation-type :type type)
2931        (let ((not-character
2932               (make-negation-type
2933                :type (make-character-set-type
2934                       :pairs '((0 . #.(1- sb!xc:char-code-limit)))))))
2935          (type-union
2936           not-character
2937           (make-character-set-type
2938            :pairs (let (not-pairs)
2939                     (when (> (caar pairs) 0)
2940                       (push (cons 0 (1- (caar pairs))) not-pairs))
2941                     (do* ((tail pairs (cdr tail))
2942                           (high1 (cdar tail))
2943                           (low2 (caadr tail)))
2944                          ((null (cdr tail))
2945                           (when (< (cdar tail) (1- sb!xc:char-code-limit))
2946                             (push (cons (1+ (cdar tail))
2947                                         (1- sb!xc:char-code-limit))
2948                                   not-pairs))
2949                           (nreverse not-pairs))
2950                       (push (cons (1+ high1) (1- low2)) not-pairs)))))))))
2951
2952 (!define-type-method (character-set :unparse) (type)
2953   (cond
2954     ((type= type (specifier-type 'character)) 'character)
2955     ((type= type (specifier-type 'base-char)) 'base-char)
2956     ((type= type (specifier-type 'extended-char)) 'extended-char)
2957     ((type= type (specifier-type 'standard-char)) 'standard-char)
2958     (t (let ((pairs (character-set-type-pairs type)))
2959         `(member ,@(loop for (low . high) in pairs
2960                          append (loop for code from low upto high
2961                                       collect (sb!xc:code-char code))))))))
2962
2963 (!define-type-method (character-set :simple-=) (type1 type2)
2964   (let ((pairs1 (character-set-type-pairs type1))
2965        (pairs2 (character-set-type-pairs type2)))
2966     (values (equal pairs1 pairs2) t)))
2967
2968 (!define-type-method (character-set :simple-subtypep) (type1 type2)
2969   (values
2970    (dolist (pair (character-set-type-pairs type1) t)
2971      (unless (position pair (character-set-type-pairs type2)
2972                       :test (lambda (x y) (and (>= (car x) (car y))
2973                                                (<= (cdr x) (cdr y)))))
2974        (return nil)))
2975    t))
2976
2977 (!define-type-method (character-set :simple-union2) (type1 type2)
2978   ;; KLUDGE: the canonizing in the MAKE-CHARACTER-SET-TYPE function
2979   ;; actually does the union for us.  It might be a little fragile to
2980   ;; rely on it.
2981   (make-character-set-type
2982    :pairs (merge 'list
2983                 (copy-alist (character-set-type-pairs type1))
2984                 (copy-alist (character-set-type-pairs type2))
2985                 #'< :key #'car)))
2986
2987 (!define-type-method (character-set :simple-intersection2) (type1 type2)
2988   ;; KLUDGE: brute force.
2989   (let (pairs)
2990     (dolist (pair1 (character-set-type-pairs type1)
2991             (make-character-set-type
2992              :pairs (sort pairs #'< :key #'car)))
2993       (dolist (pair2 (character-set-type-pairs type2))
2994        (cond
2995          ((<= (car pair1) (car pair2) (cdr pair1))
2996           (push (cons (car pair2) (min (cdr pair1) (cdr pair2))) pairs))
2997          ((<= (car pair2) (car pair1) (cdr pair2))
2998           (push (cons (car pair1) (min (cdr pair1) (cdr pair2))) pairs)))))))
2999 \f
3000 ;;; Return the type that describes all objects that are in X but not
3001 ;;; in Y. If we can't determine this type, then return NIL.
3002 ;;;
3003 ;;; For now, we only are clever dealing with union and member types.
3004 ;;; If either type is not a union type, then we pretend that it is a
3005 ;;; union of just one type. What we do is remove from X all the types
3006 ;;; that are a subtype any type in Y. If any type in X intersects with
3007 ;;; a type in Y but is not a subtype, then we give up.
3008 ;;;
3009 ;;; We must also special-case any member type that appears in the
3010 ;;; union. We remove from X's members all objects that are TYPEP to Y.
3011 ;;; If Y has any members, we must be careful that none of those
3012 ;;; members are CTYPEP to any of Y's non-member types. We give up in
3013 ;;; this case, since to compute that difference we would have to break
3014 ;;; the type from X into some collection of types that represents the
3015 ;;; type without that particular element. This seems too hairy to be
3016 ;;; worthwhile, given its low utility.
3017 (defun type-difference (x y)
3018   (let ((x-types (if (union-type-p x) (union-type-types x) (list x)))
3019         (y-types (if (union-type-p y) (union-type-types y) (list y))))
3020     (collect ((res))
3021       (dolist (x-type x-types)
3022         (if (member-type-p x-type)
3023             (collect ((members))
3024               (dolist (mem (member-type-members x-type))
3025                 (multiple-value-bind (val win) (ctypep mem y)
3026                   (unless win (return-from type-difference nil))
3027                   (unless val
3028                     (members mem))))
3029               (when (members)
3030                 (res (make-member-type :members (members)))))
3031             (dolist (y-type y-types (res x-type))
3032               (multiple-value-bind (val win) (csubtypep x-type y-type)
3033                 (unless win (return-from type-difference nil))
3034                 (when val (return))
3035                 (when (types-equal-or-intersect x-type y-type)
3036                   (return-from type-difference nil))))))
3037       (let ((y-mem (find-if #'member-type-p y-types)))
3038         (when y-mem
3039           (let ((members (member-type-members y-mem)))
3040             (dolist (x-type x-types)
3041               (unless (member-type-p x-type)
3042                 (dolist (member members)
3043                   (multiple-value-bind (val win) (ctypep member x-type)
3044                     (when (or (not win) val)
3045                       (return-from type-difference nil)))))))))
3046       (apply #'type-union (res)))))
3047 \f
3048 (!def-type-translator array (&optional (element-type '*)
3049                                        (dimensions '*))
3050   (specialize-array-type
3051    (make-array-type :dimensions (canonical-array-dimensions dimensions)
3052                     :complexp :maybe
3053                     :element-type (if (eq element-type '*)
3054                                       *wild-type*
3055                                       (specifier-type element-type)))))
3056
3057 (!def-type-translator simple-array (&optional (element-type '*)
3058                                               (dimensions '*))
3059   (specialize-array-type
3060    (make-array-type :dimensions (canonical-array-dimensions dimensions)
3061                     :complexp nil
3062                     :element-type (if (eq element-type '*)
3063                                       *wild-type*
3064                                       (specifier-type element-type)))))
3065 \f
3066 ;;;; utilities shared between cross-compiler and target system
3067
3068 ;;; Does the type derived from compilation of an actual function
3069 ;;; definition satisfy declarations of a function's type?
3070 (defun defined-ftype-matches-declared-ftype-p (defined-ftype declared-ftype)
3071   (declare (type ctype defined-ftype declared-ftype))
3072   (flet ((is-built-in-class-function-p (ctype)
3073            (and (built-in-classoid-p ctype)
3074                 (eq (built-in-classoid-name ctype) 'function))))
3075     (cond (;; DECLARED-FTYPE could certainly be #<BUILT-IN-CLASS FUNCTION>;
3076            ;; that's what happens when we (DECLAIM (FTYPE FUNCTION FOO)).
3077            (is-built-in-class-function-p declared-ftype)
3078            ;; In that case, any definition satisfies the declaration.
3079            t)
3080           (;; It's not clear whether or how DEFINED-FTYPE might be
3081            ;; #<BUILT-IN-CLASS FUNCTION>, but it's not obviously
3082            ;; invalid, so let's handle that case too, just in case.
3083            (is-built-in-class-function-p defined-ftype)
3084            ;; No matter what DECLARED-FTYPE might be, we can't prove
3085            ;; that an object of type FUNCTION doesn't satisfy it, so
3086            ;; we return success no matter what.
3087            t)
3088           (;; Otherwise both of them must be FUN-TYPE objects.
3089            t
3090            ;; FIXME: For now we only check compatibility of the return
3091            ;; type, not argument types, and we don't even check the
3092            ;; return type very precisely (as per bug 94a). It would be
3093            ;; good to do a better job. Perhaps to check the
3094            ;; compatibility of the arguments, we should (1) redo
3095            ;; VALUES-TYPES-EQUAL-OR-INTERSECT as
3096            ;; ARGS-TYPES-EQUAL-OR-INTERSECT, and then (2) apply it to
3097            ;; the ARGS-TYPE slices of the FUN-TYPEs. (ARGS-TYPE
3098            ;; is a base class both of VALUES-TYPE and of FUN-TYPE.)
3099            (values-types-equal-or-intersect
3100             (fun-type-returns defined-ftype)
3101             (fun-type-returns declared-ftype))))))
3102
3103 ;;; This messy case of CTYPE for NUMBER is shared between the
3104 ;;; cross-compiler and the target system.
3105 (defun ctype-of-number (x)
3106   (let ((num (if (complexp x) (realpart x) x)))
3107     (multiple-value-bind (complexp low high)
3108         (if (complexp x)
3109             (let ((imag (imagpart x)))
3110               (values :complex (min num imag) (max num imag)))
3111             (values :real num num))
3112       (make-numeric-type :class (etypecase num
3113                                   (integer (if (complexp x)
3114                                                (if (integerp (imagpart x))
3115                                                    'integer
3116                                                    'rational)
3117                                                'integer))
3118                                   (rational 'rational)
3119                                   (float 'float))
3120                          :format (and (floatp num) (float-format-name num))
3121                          :complexp complexp
3122                          :low low
3123                          :high high))))
3124 \f
3125 (locally
3126   ;; Why SAFETY 0? To suppress the is-it-the-right-structure-type
3127   ;; checking for declarations in structure accessors. Otherwise we
3128   ;; can get caught in a chicken-and-egg bootstrapping problem, whose
3129   ;; symptom on x86 OpenBSD sbcl-0.pre7.37.flaky5.22 is an illegal
3130   ;; instruction trap. I haven't tracked it down, but I'm guessing it
3131   ;; has to do with setting LAYOUTs when the LAYOUT hasn't been set
3132   ;; yet. -- WHN
3133   (declare (optimize (safety 0)))
3134   (!defun-from-collected-cold-init-forms !late-type-cold-init))
3135
3136 (/show0 "late-type.lisp end of file")