ANSI Common Lisp Standard X3J13/94-101R

Figures......Page 3 Index......Page 27 Contents......Page 9 1 Introduction......Page 56 1.1.2 History......Page 57 1.2 Organization of the Document......Page 60 1.3 Referenced Publications......Page 61 1.4.1.1 Font Key......Page 63 1.4.1.2 Modified BNF Syntax......Page 64 1.4.1.3 Special Symbols......Page 66 1.4.1.4 Objects with Multiple Notations......Page 68 1.4.1.5 Designators......Page 70 1.4.2 Error Terminology......Page 71 1.4.3 Sections Not Formally Part Of This Standard......Page 74 1.4.4.4 The ``Binding Types Affected'' Section of a Dictionary Entry......Page 75 1.4.4.6 Dictionary Entries for Type Specifiers......Page 76 1.4.4.11 The ``Initial Value'' Section of a Dictionary Entry......Page 77 1.4.4.14 The ``Name'' Section of a Dictionary Entry......Page 78 1.4.4.20 The ``Syntax'' Section of a Dictionary Entry......Page 80 1.4.4.22 The ``Value Type'' Section of a Dictionary Entry......Page 82 1.5.1.4 Treatment of Exceptional Situations......Page 84 1.5.2.1 Use of Implementation-Defined Language Features......Page 85 1.5.2.2 Character Set for Portable Code......Page 86 1.6 Language Extensions......Page 87 1.7 Language Subsets......Page 88 1.8.3 Deprecated Variables......Page 89 1.8.4 Deprecated Reader Syntax......Page 90 1.9 Symbols in the COMMON-LISP Package......Page 91 2 Syntax......Page 103 2.1.1.3 The Initial Readtable......Page 104 2.1.3 Standard Characters......Page 105 2.1.4 Character Syntax Types......Page 107 2.1.4.2 Constituent Traits......Page 109 2.1.4.3 Invalid Characters......Page 110 2.1.4.5 Multiple Escape Characters......Page 111 2.1.4.7 Whitespace Characters......Page 112 2.2 Reader Algorithm......Page 114 2.3.1.1 Potential Numbers as Tokens......Page 117 2.3.2.1 Syntax of a Rational......Page 119 2.3.2.2 Syntax of a Float......Page 120 2.3.4 Symbols as Tokens......Page 121 2.3.5 Valid Patterns for Tokens......Page 123 2.3.6 Package System Consistency Rules......Page 125 2.4.3 Single-Quote......Page 126 2.4.4.2 Notes about Style for Semicolon......Page 127 2.4.5 Double-Quote......Page 128 2.4.6 Backquote......Page 129 2.4.8 Sharpsign......Page 131 2.4.8.3 Sharpsign Left-Parenthesis......Page 134 2.4.8.5 Sharpsign Colon......Page 135 2.4.8.9 Sharpsign X......Page 136 2.4.8.11 Sharpsign C......Page 137 2.4.8.13 Sharpsign S......Page 138 2.4.8.16 Sharpsign Sharpsign......Page 139 2.4.8.19 Sharpsign Vertical-Bar......Page 140 2.4.8.21 Sharpsign Whitespace......Page 142 2.4.9 Re-Reading Abbreviated Expressions......Page 143 3 Evaluation & Compilation......Page 144 3.1.1.2 Dynamic Environments......Page 145 3.1.1.3 Lexical Environments......Page 146 3.1.2.1 Form Evaluation......Page 147 3.1.4 Closures and Lexical Binding......Page 153 3.1.5 Shadowing......Page 155 3.1.6 Extent......Page 156 3.1.7 Return Values......Page 157 3.2.1 Compiler Terminology......Page 158 3.2.2.1 Compiler Macros......Page 159 3.2.2.2 Minimal Compilation......Page 161 3.2.2.3 Semantic Constraints......Page 162 3.2.3 File Compilation......Page 163 3.2.3.1 Processing of Top Level Forms......Page 164 3.2.4.1 Externalizable Objects......Page 167 3.2.4.2 Similarity of Literal Objects......Page 168 3.2.4.4 Additional Constraints on Externalizable Objects......Page 170 3.2.5 Exceptional Situations in the Compiler......Page 172 3.3.3 Declaration Identifiers......Page 173 3.3.4.1 Examples of Declaration Scope......Page 174 3.4.1 Ordinary Lambda Lists......Page 177 3.4.1.1 Specifiers for the required parameters......Page 178 3.4.1.4 Specifiers for keyword parameters......Page 179 3.4.1.6 Examples of Ordinary Lambda Lists......Page 181 3.4.2 Generic Function Lambda Lists......Page 183 3.4.4 Macro Lambda Lists......Page 184 3.4.4.1 Destructuring by Lambda Lists......Page 186 3.4.6 Boa Lambda Lists......Page 189 3.4.9 Define-modify-macro Lambda Lists......Page 191 3.4.11 Syntactic Interaction of Documentation Strings and Declarations......Page 192 3.5.1.1 Safe and Unsafe Calls......Page 193 3.5.1.5 Invalid Keyword Arguments......Page 194 3.5.1.8 Errors When Calling a Next Method......Page 195 3.6 Traversal Rules and Side Effects......Page 196 3.7.1 Modification of Literal Objects......Page 197 3.7.2.1 Examples of Transfer of Control during a Destructive Operation......Page 198 lambda......Page 199 compile......Page 200 eval......Page 202 eval-when......Page 203 load-time-value......Page 206 quote......Page 208 compiler-macro-function......Page 209 define-compiler-macro......Page 210 defmacro......Page 213 macro-function......Page 216 macroexpand, macroexpand-1......Page 217 define-symbol-macro......Page 220 symbol-macrolet......Page 221 *macroexpand-hook*......Page 223 proclaim......Page 224 declaim......Page 225 declare......Page 226 ignore, ignorable......Page 228 dynamic-extent......Page 229 type......Page 232 inline, notinline......Page 236 ftype......Page 238 optimize......Page 239 special......Page 241 locally......Page 243 the......Page 244 special-operator-p......Page 246 constantp......Page 247 4 Types & Classes......Page 249 4.1 Introduction......Page 250 4.2.2 Type Relationships......Page 251 4.2.3 Type Specifiers......Page 252 4.3.1 Introduction to Classes......Page 257 4.3.2 Defining Classes......Page 258 4.3.3 Creating Instances of Classes......Page 259 4.3.5 Determining the Class Precedence List......Page 260 4.3.5.1 Topological Sorting......Page 261 4.3.5.2 Examples of Class Precedence List Determination......Page 262 4.3.6 Redefining Classes......Page 263 4.3.6.2 Initializing Newly Added Local Slots......Page 264 4.3.7 Integrating Types and Classes......Page 265 function......Page 268 standard-generic-function......Page 271 structure-class......Page 272 standard-method......Page 273 method-combination......Page 274 satisfies......Page 275 not......Page 276 or......Page 277 eql......Page 278 coerce......Page 279 deftype......Page 281 subtypep......Page 283 type-of......Page 286 typep......Page 288 type-error-datum, type-error-expected-type......Page 290 simple-type-error......Page 291 5 Data & Control Flow......Page 292 5.1.1.1 Evaluation of Subforms to Places......Page 293 5.1.1.2 Setf Expansions......Page 295 5.1.2.2 Function Call Forms as Places......Page 297 5.1.2.5 APPLY Forms as Places......Page 301 5.1.2.9 Other Compound Forms as Places......Page 302 5.1.3 Treatment of Other Macros Based on SETF......Page 303 5.2 Transfer of Control to an Exit Point......Page 305 apply......Page 306 defun......Page 307 fboundp......Page 309 flet, labels, macrolet......Page 311 funcall......Page 316 function......Page 317 function-lambda-expression......Page 318 functionp......Page 319 compiled-function-p......Page 320 lambda-list-keywords......Page 321 defconstant......Page 322 defparameter, defvar......Page 324 destructuring-bind......Page 327 let, let*......Page 328 progv......Page 330 setq......Page 331 psetq......Page 332 block......Page 333 catch......Page 334 go......Page 336 return-from......Page 337 tagbody......Page 339 throw......Page 341 unwind-protect......Page 343 not......Page 346 t......Page 347 eq......Page 348 eql......Page 350 equal......Page 351 equalp......Page 354 identity......Page 356 complement......Page 357 every, some, notevery, notany......Page 358 and......Page 360 cond......Page 361 if......Page 362 or......Page 363 when, unless......Page 364 case, ccase, ecase......Page 366 typecase, ctypecase, etypecase......Page 368 multiple-value-bind......Page 371 multiple-value-call......Page 372 multiple-value-list......Page 373 multiple-value-prog1......Page 374 multiple-value-setq......Page 375 values......Page 376 values-list......Page 377 nth-value......Page 378 prog, prog*......Page 379 prog1, prog2......Page 381 define-modify-macro......Page 383 defsetf......Page 385 define-setf-expander......Page 388 get-setf-expansion......Page 390 setf, psetf......Page 391 shiftf......Page 393 rotatef......Page 394 undefined-function......Page 396 6 Iteration......Page 397 6.1.1.3 Parsing Loop Clauses......Page 398 6.1.1.4 Expanding Loop Forms......Page 399 6.1.1.5 Summary of Loop Clauses......Page 400 6.1.1.6 Order of Execution......Page 402 6.1.1.7 Destructuring......Page 403 6.1.2.1 Iteration Control......Page 405 6.1.2.2 Local Variable Initializations......Page 412 6.1.3 Value Accumulation Clauses......Page 414 6.1.3.2 Examples of APPEND and NCONC clauses......Page 416 6.1.3.4 Examples of MAXIMIZE and MINIMIZE clauses......Page 417 6.1.4 Termination Test Clauses......Page 418 6.1.4.2 Examples of ALWAYS, NEVER, and THEREIS clauses......Page 419 6.1.5.1 Examples of unconditional execution......Page 421 6.1.6.1 Examples of WHEN clause......Page 422 6.1.7 Miscellaneous Clauses......Page 423 6.1.8 Examples of Miscellaneous Loop Features......Page 424 6.1.8.1 Examples of clause grouping......Page 425 6.1.9 Notes about Loop......Page 427 do, do*......Page 428 dotimes......Page 432 dolist......Page 433 loop......Page 435 loop-finish......Page 439 7 Objects......Page 441 7.1 Object Creation and Initialization......Page 442 7.1.2 Declaring the Validity of Initialization Arguments......Page 443 7.1.3 Defaulting of Initialization Arguments......Page 444 7.1.4 Rules for Initialization Arguments......Page 445 7.1.5 Shared-Initialize......Page 446 7.1.6 Initialize-Instance......Page 447 7.1.7 Definitions of Make-Instance and Initialize-Instance......Page 448 7.2.3 Customizing the Change of Class of an Instance......Page 450 7.3.1 Customizing Reinitialization......Page 452 7.4.1 Standard Meta-objects......Page 453 7.5.2 Accessing Slots......Page 454 7.5.3 Inheritance of Slots and Slot Options......Page 455 7.6.1 Introduction to Generic Functions......Page 457 7.6.2 Introduction to Methods......Page 458 7.6.4 Congruent Lambda-lists for all Methods of a Generic Function......Page 460 7.6.5.1 Examples of Keyword Arguments in Generic Functions and Methods......Page 461 7.6.6.1 Determining the Effective Method......Page 462 7.6.6.2 Standard Method Combination......Page 464 7.6.6.4 Built-in Method Combination Types......Page 466 7.6.7 Inheritance of Methods......Page 467 function-keywords......Page 469 ensure-generic-function......Page 470 allocate-instance......Page 471 reinitialize-instance......Page 472 shared-initialize......Page 473 update-instance-for-different-class......Page 475 update-instance-for-redefined-class......Page 476 change-class......Page 479 slot-boundp......Page 481 slot-exists-p......Page 482 slot-missing......Page 483 slot-unbound......Page 485 slot-value......Page 486 method-qualifiers......Page 487 no-applicable-method......Page 488 remove-method......Page 489 make-instance......Page 490 make-instances-obsolete......Page 491 make-load-form......Page 492 make-load-form-saving-slots......Page 496 with-accessors......Page 497 with-slots......Page 499 defclass......Page 501 defgeneric......Page 506 defmethod......Page 509 find-class......Page 512 next-method-p......Page 513 call-method, make-method......Page 514 call-next-method......Page 515 compute-applicable-methods......Page 516 define-method-combination......Page 517 find-method......Page 526 add-method......Page 527 initialize-instance......Page 528 (setf class-name)......Page 529 class-of......Page 530 unbound-slot-instance......Page 531 8 Structures......Page 532 defstruct......Page 533 copy-structure......Page 549 9 Conditions......Page 551 9.1 Condition System Concepts......Page 552 9.1.1 Condition Types......Page 553 9.1.2.1 Condition Designators......Page 554 9.1.3.1 Recommended Style in Condition Reporting......Page 555 9.1.4 Signaling and Handling Conditions......Page 557 9.1.4.1 Signaling......Page 558 9.1.4.2 Restarts......Page 559 9.1.6 Notes about the Condition System's Background......Page 561 warning......Page 562 serious-condition......Page 563 cell-error-name......Page 564 storage-condition......Page 565 assert......Page 566 error......Page 568 cerror......Page 570 check-type......Page 573 invalid-method-error......Page 576 signal......Page 577 simple-condition-format-control, simple-condition-format-arguments......Page 579 warn......Page 580 invoke-debugger......Page 582 break......Page 583 *debugger-hook*......Page 585 *break-on-signals*......Page 586 handler-bind......Page 588 handler-case......Page 589 ignore-errors......Page 592 define-condition......Page 593 make-condition......Page 598 compute-restarts......Page 599 find-restart......Page 601 invoke-restart......Page 602 invoke-restart-interactively......Page 603 restart-bind......Page 605 restart-case......Page 607 restart-name......Page 612 with-condition-restarts......Page 613 with-simple-restart......Page 614 continue......Page 616 muffle-warning......Page 617 store-value......Page 618 abort, continue, muffle-warning, store-value, use-value......Page 619 10 Symbols......Page 624 10.1 Symbol Concepts......Page 625 symbol......Page 626 keyword......Page 627 symbolp......Page 628 make-symbol......Page 629 copy-symbol......Page 630 gensym......Page 632 *gensym-counter*......Page 633 gentemp......Page 634 symbol-function......Page 635 symbol-package......Page 637 symbol-value......Page 639 get......Page 641 remprop......Page 643 boundp......Page 644 makunbound......Page 645 set......Page 646 unbound-variable......Page 647 11 Packages......Page 648 11.1.1.2 Symbols in a Package......Page 649 11.1.2.1 The COMMON-LISP Package......Page 652 11.1.2.2 The COMMON-LISP-USER Package......Page 654 11.1.2.4 Implementation-Defined Packages......Page 655 export......Page 656 find-symbol......Page 657 find-all-symbols......Page 659 import......Page 660 list-all-packages......Page 661 rename-package......Page 662 shadow......Page 663 shadowing-import......Page 664 delete-package......Page 665 make-package......Page 668 with-package-iterator......Page 669 unexport......Page 672 unintern......Page 673 unuse-package......Page 674 use-package......Page 675 defpackage......Page 676 do-symbols, do-external-symbols, do-all-symbols......Page 681 intern......Page 683 package-name......Page 684 package-shadowing-symbols......Page 685 package-use-list......Page 686 packagep......Page 687 *package*......Page 688 package-error-package......Page 689 12 Numbers......Page 691 12.1.1 Numeric Operations......Page 692 12.1.1.1 Associativity and Commutativity in Numeric Operations......Page 693 12.1.1.3 Viewing Integers as Bits and Bytes......Page 694 12.1.3.1 Rule of Unbounded Rational Precision......Page 695 12.1.3.3 Rule of Float Substitutability......Page 696 12.1.4.1 Rule of Float and Rational Contagion......Page 697 12.1.5 Complex Computations......Page 698 12.1.5.4 Principal Values and Branch Cuts......Page 699 12.1.6 Interval Designators......Page 700 12.1.7 Random-State Operations......Page 701 complex......Page 702 real......Page 703 float......Page 704 short-float, single-float, double-float, long-float......Page 705 rational......Page 706 integer......Page 707 signed-byte......Page 708 unsigned-byte......Page 709 bignum......Page 710 =, /=, {$ pLT $}, {$ pGT $}, {$ pLT $}=, {$ pGT $}=......Page 711 max, min......Page 713 zerop......Page 715 floor, ffloor, ceiling, fceiling, truncate, ftruncate, round, fround......Page 716 asin, acos, atan......Page 719 sinh, cosh, tanh, asinh, acosh, atanh......Page 723 +......Page 726 $-$......Page 727 /......Page 728 1+, 1$-$......Page 729 abs......Page 730 evenp, oddp......Page 731 exp, expt......Page 732 gcd......Page 733 incf, decf......Page 734 lcm......Page 735 log......Page 736 mod, rem......Page 738 signum......Page 739 sqrt, isqrt......Page 740 random-state......Page 741 make-random-state......Page 742 random......Page 743 *random-state*......Page 744 numberp......Page 745 complex......Page 746 complexp......Page 747 conjugate......Page 748 phase......Page 749 upgraded-complex-part-type......Page 750 realp......Page 751 numerator, denominator......Page 752 rational, rationalize......Page 753 ash......Page 754 integer-length......Page 755 parse-integer......Page 757 boole......Page 758 logand, logandc1, logandc2, logeqv, logior, lognand, lognor, lognot, logorc1, logorc2, logxor......Page 761 logbitp......Page 764 logcount......Page 765 logtest......Page 766 byte, byte-size, byte-position......Page 767 deposit-field......Page 768 dpb......Page 769 ldb......Page 770 ldb-test......Page 771 mask-field......Page 772 decode-float, scale-float, float-radix, float-sign, float-digits, float-precision, integer-decode-float......Page 773 float......Page 776 most-positive-short-float, least-positive-short-float, least-positive-normalized-short-float, most-positive-double-float, least-positive-double-float, least-positive-normalized-double-float, most-positive-long-float, least-positive-long-float, least-positive-normalized-long-float, most-positive-single-float, least-positive-single-float, least-positive-normalized-single-float, most-negative-short-float, least-negative-short-float, least-negative-normalized-short-float, most-negative-single-float, least-negative-single-float, least-negative-normalized-single-float, most-negative-double-float, least-negative-double-float, least-negative-normalized-double-float, most-negative-long-float, least-negative-long-float, least-negative-normalized-long-float......Page 777 short-float-epsilon, short-float-negative-epsilon, single-float-epsilon, single-float-negative-epsilon, double-float-epsilon, double-float-negative-epsilon, long-float-epsilon, long-float-negative-epsilon......Page 779 arithmetic-error-operands, arithmetic-error-operation......Page 780 floating-point-inexact......Page 781 floating-point-underflow......Page 782 13 Characters......Page 783 13.1.2.1 Character Scripts......Page 784 13.1.4 Character Categories......Page 785 13.1.4.3 Characters With Case......Page 786 13.1.4.6 Digits in a Radix......Page 787 13.1.7 Character Names......Page 788 13.1.8 Treatment of Newline during Input and Output......Page 789 13.1.10 Documentation of Implementation-Defined Scripts......Page 790 base-char......Page 791 char=, char/=, char{$ pLT $}, char{$ pGT $}, char{$ pLT $}=, char{$ pGT $}=, char-equal, char-not-equal, char-lessp, char-greaterp, char-not-greaterp, char-not-lessp......Page 792 character......Page 795 characterp......Page 796 alphanumericp......Page 797 digit-char......Page 798 digit-char-p......Page 799 graphic-char-p......Page 800 standard-char-p......Page 801 char-upcase, char-downcase......Page 802 upper-case-p, lower-case-p, both-case-p......Page 803 char-int......Page 804 code-char......Page 805 char-name......Page 806 name-char......Page 808 14 Conses......Page 809 14.1.2 Conses as Lists......Page 810 14.1.2.2 Lists as Sets......Page 811 14.1.2.3 General Restrictions on Parameters that must be Lists......Page 812 cons......Page 813 cons......Page 814 consp......Page 815 atom......Page 816 car, cdr, caar, cadr, cdar, cddr, caaar, caadr, cadar, caddr, cdaar, cdadr, cddar, cdddr, caaaar, caaadr, caadar, caaddr, cadaar, cadadr, caddar, cadddr, cdaaar, cdaadr, cdadar, cdaddr, cddaar, cddadr, cdddar, cddddr......Page 817 copy-tree......Page 821 sublis, nsublis......Page 822 subst, subst-if, subst-if-not, nsubst, nsubst-if, nsubst-if-not......Page 824 tree-equal......Page 826 list, list*......Page 828 list-length......Page 830 listp......Page 831 push......Page 832 pop......Page 833 first, second, third, fourth, fifth, sixth, seventh, eighth, ninth, tenth......Page 834 endp......Page 836 null......Page 837 nconc......Page 838 append......Page 839 revappend, nreconc......Page 840 butlast, nbutlast......Page 842 last......Page 843 ldiff, tailp......Page 844 nthcdr......Page 846 rest......Page 847 member, member-if, member-if-not......Page 848 mapc, mapcar, mapcan, mapl, maplist, mapcon......Page 849 acons......Page 851 assoc, assoc-if, assoc-if-not......Page 852 copy-alist......Page 854 pairlis......Page 855 rassoc, rassoc-if, rassoc-if-not......Page 856 get-properties......Page 857 getf......Page 858 remf......Page 860 intersection, nintersection......Page 861 adjoin......Page 863 pushnew......Page 864 set-difference, nset-difference......Page 865 set-exclusive-or, nset-exclusive-or......Page 867 subsetp......Page 868 union, nunion......Page 869 15 Arrays......Page 872 15.1.1.3 Array Rank......Page 873 15.1.2 Specialized Arrays......Page 874 15.1.2.2 Required Kinds of Specialized Arrays......Page 875 array......Page 877 simple-array......Page 878 vector......Page 879 bit-vector......Page 880 simple-bit-vector......Page 881 make-array......Page 882 adjust-array......Page 886 adjustable-array-p......Page 889 aref......Page 890 array-dimensions......Page 891 array-element-type......Page 892 array-has-fill-pointer-p......Page 893 array-displacement......Page 894 array-in-bounds-p......Page 895 array-row-major-index......Page 896 array-total-size......Page 897 arrayp......Page 898 fill-pointer......Page 899 upgraded-array-element-type......Page 900 array-dimension-limit......Page 901 array-total-size-limit......Page 902 svref......Page 903 vector......Page 904 vector-pop......Page 905 vector-push, vector-push-extend......Page 906 vectorp......Page 907 bit, sbit......Page 908 bit-and, bit-andc1, bit-andc2, bit-eqv, bit-ior, bit-nand, bit-nor, bit-not, bit-orc1, bit-orc2, bit-xor......Page 909 bit-vector-p......Page 910 simple-bit-vector-p......Page 911 16 Strings......Page 913 16.1.2 Subtypes of STRING......Page 914 base-string......Page 915 simple-base-string......Page 916 simple-string-p......Page 917 char, schar......Page 918 string......Page 919 string-upcase, string-downcase, string-capitalize, nstring-upcase, nstring-downcase, nstring-capitalize......Page 920 string-trim, string-left-trim, string-right-trim......Page 922 string=, string/=, string{$ pLT $}, string{$ pGT $}, string{$ pLT $}=, string{$ pGT $}=, string-equal, string-not-equal, string-lessp, string-greaterp, string-not-greaterp, string-not-lessp......Page 923 stringp......Page 925 make-string......Page 926 17 Sequences......Page 927 17.1.1 General Restrictions on Parameters that must be Sequences......Page 928 17.2.1.1 Examples of Satisfying a Two-Argument Test......Page 929 17.2.2 Satisfying a One-Argument Test......Page 930 17.2.2.1 Examples of Satisfying a One-Argument Test......Page 931 copy-seq......Page 932 fill......Page 933 make-sequence......Page 934 subseq......Page 936 map......Page 937 map-into......Page 938 reduce......Page 940 count, count-if, count-if-not......Page 941 reverse, nreverse......Page 943 sort, stable-sort......Page 945 find, find-if, find-if-not......Page 947 position, position-if, position-if-not......Page 948 search......Page 949 mismatch......Page 951 replace......Page 952 substitute, substitute-if, substitute-if-not, nsubstitute, nsubstitute-if, nsubstitute-if-not......Page 953 concatenate......Page 956 merge......Page 957 remove, remove-if, remove-if-not, delete, delete-if, delete-if-not......Page 959 remove-duplicates, delete-duplicates......Page 962 18 Hash Tables......Page 965 18.1.2 Modifying Hash Table Keys......Page 966 18.1.2.3 Visible Modification of Objects with respect to EQUALP......Page 967 18.1.2.4 Visible Modifications by Language Extensions......Page 968 make-hash-table......Page 969 hash-table-p......Page 970 hash-table-count......Page 971 hash-table-rehash-size......Page 972 hash-table-size......Page 973 hash-table-test......Page 974 gethash......Page 975 maphash......Page 976 with-hash-table-iterator......Page 978 clrhash......Page 979 sxhash......Page 980 19 Filenames......Page 982 19.1.2 Pathnames as Filenames......Page 983 19.1.3 Parsing Namestrings Into Pathnames......Page 984 19.2.2.1 Strings in Component Values......Page 985 19.2.2.2 Special Pathname Component Values......Page 987 19.2.2.4 Restrictions on Examining Pathname Components......Page 988 19.2.2.5 Restrictions on Constructing Pathnames......Page 991 19.2.3.1 Examples of Merging Pathnames......Page 992 19.3.1.1 Additional Information about Parsing Logical Pathname Namestrings......Page 994 19.3.2.2 Null Strings as Components of a Logical Pathname......Page 996 pathname......Page 997 make-pathname......Page 999 pathnamep......Page 1001 pathname-host, pathname-device, pathname-directory, pathname-name, pathname-type, pathname-version......Page 1002 load-logical-pathname-translations......Page 1004 logical-pathname-translations......Page 1005 *default-pathname-defaults*......Page 1009 namestring, file-namestring, directory-namestring, host-namestring, enough-namestring......Page 1010 parse-namestring......Page 1012 wild-pathname-p......Page 1014 translate-logical-pathname......Page 1016 translate-pathname......Page 1018 merge-pathnames......Page 1020 20 Files......Page 1023 20.1.2 File Operations on Open and Closed Streams......Page 1024 20.1.3.1 Examples of Truenames......Page 1025 probe-file......Page 1026 ensure-directories-exist......Page 1027 truename......Page 1028 file-author......Page 1029 file-write-date......Page 1030 rename-file......Page 1031 delete-file......Page 1032 file-error......Page 1033 file-error-pathname......Page 1034 21 Streams......Page 1035 21.1.1.1 Abstract Classifications of Streams......Page 1036 21.1.1.3 Other Subclasses of Stream......Page 1038 21.1.2 Stream Variables......Page 1039 21.1.3 Stream Arguments to Standardized Functions......Page 1040 21.1.4 Restrictions on Composite Streams......Page 1041 stream......Page 1042 22 Printer......Page 1097 22.1.1.1 Multiple Possible Textual Representations......Page 1098 22.1.3.1 Printing Numbers......Page 1099 22.1.3.3 Printing Symbols......Page 1101 22.1.3.4 Printing Strings......Page 1104 22.1.3.5 Printing Lists and Conses......Page 1105 22.1.3.8 Printing Other Arrays......Page 1106 22.1.3.9 Examples of Printing Arrays......Page 1107 22.1.3.13 Printing Other Objects......Page 1108 22.1.4 Examples of Printer Behavior......Page 1109 22.2.1.1 Dynamic Control of the Arrangement of Output......Page 1111 22.2.1.2 Format Directive Interface......Page 1112 22.2.2 Examples of using the Pretty Printer......Page 1113 22.2.3 Notes about the Pretty Printer's Background......Page 1118 22.3 Formatted Output......Page 1120 22.3.1.1 Tilde C: Character......Page 1121 22.3.2.1 Tilde R: Radix......Page 1122 22.3.2.4 Tilde O: Octal......Page 1123 22.3.3.1 Tilde F: Fixed-Format Floating-Point......Page 1124 22.3.3.2 Tilde E: Exponential Floating-Point......Page 1125 22.3.3.3 Tilde G: General Floating-Point......Page 1126 22.3.3.4 Tilde Dollarsign: Monetary Floating-Point......Page 1127 22.3.5.1 Tilde Underscore: Conditional Newline......Page 1128 22.3.5.2 Tilde Less-Than-Sign: Logical Block......Page 1129 22.3.6.1 Tilde T: Tabulate......Page 1130 22.3.6.2 Tilde Less-Than-Sign: Justification......Page 1131 22.3.7.1 Tilde Asterisk: Go-To......Page 1132 22.3.7.2 Tilde Left-Bracket: Conditional Expression......Page 1133 22.3.7.4 Tilde Left-Brace: Iteration......Page 1134 22.3.8 FORMAT Miscellaneous Operations......Page 1135 22.3.8.3 Tilde P: Plural......Page 1136 22.3.9.2 Tilde Circumflex: Escape Upward......Page 1137 22.3.10 Additional Information about FORMAT Operations......Page 1138 22.3.11 Examples of FORMAT......Page 1139 22.3.12 Notes about FORMAT......Page 1141 formatter......Page 1143 pprint-dispatch......Page 1144 pprint-fill, pprint-linear, pprint-tabular......Page 1145 pprint-indent......Page 1147 pprint-logical-block......Page 1148 pprint-newline......Page 1150 pprint-pop......Page 1152 pprint-tab......Page 1153 print-object......Page 1154 print-unreadable-object......Page 1156 set-pprint-dispatch......Page 1157 write, prin1, print, pprint, princ......Page 1158 write-to-string, prin1-to-string, princ-to-string......Page 1161 *print-array*......Page 1163 *print-base*, *print-radix*......Page 1164 *print-case*......Page 1165 *print-circle*......Page 1166 *print-escape*......Page 1167 *print-level*, *print-length*......Page 1168 *print-lines*......Page 1170 *print-pprint-dispatch*......Page 1171 *print-pretty*......Page 1172 *print-readably*......Page 1173 *print-right-margin*......Page 1175 print-not-readable-object......Page 1176 format......Page 1177 23 Reader......Page 1178 23.1.2.1 Examples of Effect of Readtable Case on the Lisp Reader......Page 1179 23.1.3.2 The RECURSIVE-P argument......Page 1180 copy-readtable......Page 1182 make-dispatch-macro-character......Page 1183 read, read-preserving-whitespace......Page 1184 read-delimited-list......Page 1186 read-from-string......Page 1188 readtable-case......Page 1189 readtablep......Page 1190 set-dispatch-macro-character, get-dispatch-macro-character......Page 1191 set-macro-character, get-macro-character......Page 1192 set-syntax-from-char......Page 1194 with-standard-io-syntax......Page 1195 *read-base*......Page 1196 *read-default-float-format*......Page 1197 *read-eval*......Page 1198 *read-suppress*......Page 1199 *readtable*......Page 1200 reader-error......Page 1201 24 System Construction......Page 1202 24.1.2.1 Feature Expressions......Page 1203 compile-file......Page 1205 compile-file-pathname......Page 1207 load......Page 1208 with-compilation-unit......Page 1210 *features*......Page 1211 *load-pathname*, *load-truename*......Page 1214 *compile-print*, *compile-verbose*......Page 1215 provide, require......Page 1216 25 Environment......Page 1219 25.1.3 Environment Inquiry......Page 1220 25.1.4.1 Decoded Time......Page 1221 25.1.4.2 Universal Time......Page 1222 25.1.4.4 Seconds......Page 1223 encode-universal-time......Page 1224 get-universal-time, get-decoded-time......Page 1225 sleep......Page 1226 apropos, apropos-list......Page 1227 describe......Page 1228 describe-object......Page 1229 trace, untrace......Page 1230 step......Page 1232 time......Page 1233 get-internal-real-time......Page 1234 disassemble......Page 1235 documentation, (setf documentation)......Page 1236 room......Page 1240 inspect......Page 1241 dribble......Page 1242 $-$......Page 1243 +, ++, +++......Page 1244 *, **, ***......Page 1245 lisp-implementation-type, lisp-implementation-version......Page 1246 short-site-name, long-site-name......Page 1247 machine-